In this document, “AutoMQ,” “AutoMQ service provider,” and “the AutoMQ service” all refer to AutoMQ HK Limited and its affiliates.
Prepare VPC
You can choose to use an existing VPC when installing AutoMQ, or create a new one for it. For production environments, we recommend checking and adjusting your existing VPC configuration to meet AutoMQ’s requirements. For POC testing, creating a new VPC is a quicker option.VPC Requirements
To deploy the AutoMQ BYOC environment on Alibaba Cloud, your Virtual Private Cloud (VPC) must meet the following conditions:Scenario 1: Create a New VPC
If you need to create a new VPC for AutoMQ, we recommend using the standard creation process in the Alibaba Cloud VPC console.- Log in to the Alibaba Cloud VPC console.
- Click Create VPC.
- Configure the Region and Availability Zone.
- Set the Name and IPv4 CIDR Block for the VPC.
- Simultaneously, create the required VSwitches for the VPC. Create the appropriate number of VSwitches in different availability zones based on your deployment model (single-AZ or three-AZ).
- Depending on your deployment needs, create a NAT Gateway during the creation process or in a subsequent step.
- NAT Gateway: If you plan to deploy AutoMQ on ACK, ensure you configure a NAT Gateway for the VSwitches where the worker nodes are located.
- Click Confirm to create.
Scenario 2: Configure an Existing VPC
If you are deploying AutoMQ in an existing VPC, verify that the following configurations meet the requirements.1. Check DNS Configuration
- In the Alibaba Cloud VPC console, select your target VPC.
- In the VPC details, confirm that the private domain name resolution feature is enabled. This feature is enabled by default for Alibaba Cloud VPCs.
Prepare PrivateZone (Optional)
The AutoMQ cluster exposes service addresses to applications through Private DNS, which relies on private domain name resolution within the VPC. Therefore, a PrivateZone must be configured to provide reliable domain name resolution services. You can choose to have the AutoMQ console create the PrivateZone automatically or prepare it yourself by following the tutorial below.PrivateZone Requirements
When configuring PrivateZone, the following two key conditions must be met:PrivateZone Configuration Steps
Step 1: Check Existing PrivateZone
- Log in to the Alibaba Cloud console and visit the Alibaba Cloud DNS PrivateZone console.
- In the left navigation bar, select Private DNS.
- Check if a Zone associated with the target VPC already exists.
Step 2: Create or Configure PrivateZone
If a PrivateZone already exists:- Select the target Zone and click Set Association Scope.
- In the Associated Resolution Scopes section, ensure that the VPC where AutoMQ is deployed is included.
- Record the domain name information for subsequent TLS feature configuration.
- Click Add Zone.
- Configure the basic information:
- Zone Name: Enter a private domain name (e.g.,
internal.example.com).
- Zone Name: Enter a private domain name (e.g.,
- Click OK.
- After successful creation, go to the Associated VPCs page for the Zone and associate the VPC where AutoMQ is deployed.
Step 3: Verify the Configuration
- On the Zone’s details page, confirm the VPC association status.
- Check if the domain name configuration meets the planning requirements for the TLS feature.
- Record the Zone’s ID and domain name, which will be provided to the AutoMQ components during subsequent installation.