Azure

Refer to Overview▸; before using AutoMQ Cloud, you need to set up the environment first. This article outlines how to install the BYOC environment from Azure. If you’re already familiar with the requirements and steps for installing AutoMQ on Azure, you can click Install AutoMQ From Marketplace.

In this document, references to the AutoMQ product service provider, AutoMQ service provider, and AutoMQ all pertain to AutoMQ HK Limited and its subsidiaries.

Operational Flow

Step 1: Prepare an Azure virtual network (VNet)

The AutoMQ BYOC environment is deployed within the user’s Virtual Network to ensure data privacy and security. When installing the AutoMQ environment, users must specify the Virtual Network and subnet information, and ensure that the Virtual Network meets the following conditions:

Subnet CIDR requirements: The subnet must provide at least 512 IP addresses. A subnet CIDR block of /23 or larger is recommended so that the AutoMQ data plane has sufficient addresses for deployment and scaling.
Configure Public NAT Gateway for Access to Public Services: AutoMQ requires access to public services like image repositories. Therefore, the subnet where AutoMQ resides needs to be configured with a public NAT gateway.
Configure Storage Service Endpoint: AutoMQ requires access to the Azure Storage service, which necessitates configuration of the Service Endpoint. This allows access to object storage services through a private network, thereby avoiding unnecessary public traffic costs. Please refer to the appendix at the end of this document for configuration methods.

Users can refer to the appendix section of this document for guidance on configuring Virtual Networks and Subnets.

Step 2: Install AutoMQ Using ARM Templates.

Visit AutoMQ Installation Link, to open the installation interface. The AutoMQ Cloud BYOC environment is installed on Azure by default through an ARM template.
Refer to the parameter description below to set the appropriate Basics parameter values.

Set Parameter	Value Explanation
Subscription	Description: Select an Azure subscription, all cloud resources used by AutoMQ will be billed using this subscription. Recommendation: It is advised to keep it consistent with the application.
Resource group	Description: Choose the resource group assigned to AutoMQ. It is recommended to place all subsequent cloud resources associated with AutoMQ in the same resource group.
Region	Description: Select the target region for the AutoMQ deployment, which must be consistent with the region used by your AutoMQ Producer and Consumer applications. Cross-region access to AutoMQ is not supported.

Refer to the parameter descriptions below and set appropriate values for the Virtual Machine Configuration parameters.

Set Parameter	Value Explanation
VM Size	Description: Select the VM instance size used by the AutoMQ console. It requires at least 2vCPU and 8GB of memory. It is recommended to keep the default setting.
Admin Username	Description: Set the host username for subsequent SSH logins to the console VM.
SSH public key source	Description: Set the SSH Key-Pair used for subsequent SSH login to console VM. Supports creating a new Key or using an existing one.

Refer to the parameter descriptions below to appropriately configure Network Configuration parameter values.

Set Parameter	Value Explanation
Public IP Address	Description: Set the public IP used for providing services externally via the AutoMQ console. Users can access the AutoMQ console through this public IP later on. Optional parameter values: None: No need to assign a public IP; subsequent access to the console will directly use the private IP address. This mode is suitable for enterprises with VPN, dedicated line, etc., connecting to the Virtual Network. (New) xxx: Create a new public IP; the name should be set manually. Select an existing public IP: Choose a public IP that has already been created and is available.
Virtual Network	Description: Set the target Virtual Network where the AutoMQ console will be deployed. It needs to be consistent with Producer and Consumer applications. Optional parameter values: Select an existing Virtual Network: Choose the private network where the application resides. This mode is suitable for production scenarios.
Subnet	Description: Set the target subnet for AutoMQ console that is about to be deployed. Optional parameter values: Subnet must be set to select an existing Subnet. Refer to the appendix section of this document, the subnet needs to configure a public NAT gateway, as the AutoMQ console requires access to public networks.

Refer to the parameter descriptions below to set suitable Storage Configuration parameter values.

Set Parameter	Value Explanation
Storage Account	Description: Set up the Storage Account used by AutoMQ Ops Bucket. Subsequently, AutoMQ will collect system logs, Metrics, and other data to upload to this Storage Account for alerts and analysis. Optional parameter values: (New) xxx: Create a new Storage Account. Select existing value: Choose an already created, available Storage Account. For the working principle of the Ops Bucket, refer to Overview▸.

Preview the configuration and create it. View the initial account passwords and console address output on the console.

Output	Output Description
Automq Byoc Endpoint	The URL address of the AutoMQ BYOC environment console, which users can access via a browser or through APIs and Terraform to interact with the service.
Automq Byoc Initial Username	The initial username for the environment console.
Automq Byoc Initial Password	The initial password for the environment console. Users are required to change it immediately upon first login.
Automq Byoc Managed Identity ClientID	The Managed Identity ClientID bound to the AutoMQ console, which the console uses to authenticate and access cloud resources.

Use the information above to sign into the AutoMQ console.

Step 3: Complete Operations Authorization for BYOC Environment

The BYOC environment is deployed in your virtual network (VNet), which isolates application data within your network. The environment also generates operational logs, metrics, and diagnostic data. After installation, follow Operations authorization overview to grant the permissions required for AutoMQ to monitor service health and perform managed recovery operations.

Next Steps

AutoMQ only supports deployment on an AKS cluster in Azure. Therefore, once the environment installation is complete, users must first prepare the AKS cluster and then configure it in the AutoMQ console to deploy the AutoMQ cluster to AKS. Prepare AKS and complete the subsequent deployment documentation. Please refer to Deploy to Azure AKS▸.

Appendix

Configure Virtual Network and Subnet

Configure the Subnet, Ensuring There Are Enough IP Addresses Available.

When you create the subnet in the Azure portal, configure a CIDR block that provides at least 512 IP addresses. A /23 or larger subnet is recommended.

Configuring a Subnet to Enable NAT Gateway for Accessing Public Services

Users can enable the NAT Gateway during the creation or editing of a Subnet in the Virtual Network console.

Configure a Subnet to Enable a Storage Service Endpoint for Accessing the Blob Storage Service.

AutoMQ requires access to Azure Storage Service; therefore, all Subnets deploying AutoMQ must have the Storage Service Endpoint enabled. Refer to the diagram below and select Microsoft.Storage.

Overview

Getting Started

Deploy on Kubernetes

Subscriptions and Billings

Manage Environments

Manage Identities and Access

Managing AutoMQ

Migrate to AutoMQ

Manage Security

Kafka Connect

Monitoring & Alert

Table Topic

Best Practice

Eliminate Inter-Zone Traffics

Release Notes

Support

Appendix

Operational Flow

Step 1: Prepare an Azure virtual network (VNet)

Step 2: Install AutoMQ Using ARM Templates.

Step 3: Complete Operations Authorization for BYOC Environment

Next Steps

Appendix

Configure Virtual Network and Subnet

Configure the Subnet, Ensuring There Are Enough IP Addresses Available.

Configuring a Subnet to Enable NAT Gateway for Accessing Public Services

Configure a Subnet to Enable a Storage Service Endpoint for Accessing the Blob Storage Service.

​Operational Flow

​Step 1: Prepare an Azure virtual network (VNet)

​Step 2: Install AutoMQ Using ARM Templates.

​Step 3: Complete Operations Authorization for BYOC Environment

​Next Steps

​Appendix

​Configure Virtual Network and Subnet

​Configure the Subnet, Ensuring There Are Enough IP Addresses Available.

​Configuring a Subnet to Enable NAT Gateway for Accessing Public Services

​Configure a Subnet to Enable a Storage Service Endpoint for Accessing the Blob Storage Service.

Operational Flow

Step 1: Prepare an Azure virtual network (VNet)

Step 2: Install AutoMQ Using ARM Templates.

Step 3: Complete Operations Authorization for BYOC Environment

Next Steps

Appendix

Configure Virtual Network and Subnet

Configure the Subnet, Ensuring There Are Enough IP Addresses Available.

Configuring a Subnet to Enable NAT Gateway for Accessing Public Services

Configure a Subnet to Enable a Storage Service Endpoint for Accessing the Blob Storage Service.