/apache-rocketmq-on-aws

This solution provide an easy to set up Apache Rocketmq ec2 cluster on aws account

Primary LanguageShellMIT No AttributionMIT-0

Apache RocketMQ on the AWS Cloud

中文

This solution provides a one click CloudFormation deployment to sets up a high available Apache RocketMQ cluster on AWS environment.

Apache RocketMQ is a unified messaging engine as well as lightweight data processing platform. The RocketMQ on AWS solution enables customers to quickly deploy a RocketMQ cluster in AWS Cloud. The basic cluster settings such as EC2 instance types are also configurable during the deployment.

The Quick Start offers two deployment options:

  • Deploying Apache RocketMQ into a new virtual private cloud (VPC) on AWS
  • Deploying Apache RocketMQ into an existing VPC on AWS

You can also use the AWS CloudFormation templates as a starting point for your own implementation.

Architecure

Quick Start architecture for RocketMQ on AWS

For architectural details, best practices, step-by-step instructions, and customization options, see the deployment guide.

Deploy via CloudFormation

Time to deploy: Approximately 15 minutes.

Follow the step-by-step instructions in this section to configure and deploy the AWS Data Replication Hub into your account.

  1. Make sure you have sign in AWS Console already.

  2. Click the following button to launch the CloudFormation Stack in your account.

    Region Type Launch Button
    Global Region Launch to new VPC Launch Stack
    Global Region Launch to existing VPC Launch Stack
    China Region Launch to new VPC Launch Stack
    China Region Launch to existing VPC Launch Stack

  3. Update required CloudFormation parameter, please refer to deployment guide

  4. Click Next and select Create Stack.

Manual Deploy Steps

If you updated the code in this repo, you can use following steps to manually deploy updated templates and code to your own s3 bucket.

  1. clone this repo
  2. use "aws configure" to setup the aws credential and region
  3. go to scripts directory inside the local repo directory
  4. run "bash deploy.sh" and enter the parameters needed. it will trigger a CloudFormation deploy to your aws account.

How to access Apache RocketMQ console

  1. From AWS Console, get the bastion public address and username
  2. Set up a ssh tunnel to the bastion host, similar to this guide
  3. From AWS Console, get the Name Server private ip address, in browser, enter "NAME_SERVER_PRIVATE_IPADDRESS:8080" to access the console.