> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure

> 在 Azure 上分步安装 AutoMQ BYOC 环境，完成网络与权限准备，快速部署并安全运行 Kafka 兼容集群。

参考[概述▸](/zh/automq-cloud/getting-started/overview) ，使用AutoMQ Cloud 需要先安装环境。本文介绍如何从 Azure 安装 BYOC 环境。

如您已经了解在 Azure 安装 AutoMQ 的各项条件以及操作步骤，可点击 <a href="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAutoMQ%2Fautomq-labs%2Frefs%2Fheads%2Fmain%2Fbyoc-examples%2Fsetup%2F%2Fazure%2Farm%2Fmain.json/uiFormDefinitionUri/https%3A%2F%2Fraw.githubusercontent.com%2FAutoMQ%2Fautomq-labs%2Frefs%2Fheads%2Fmain%2Fbyoc-examples%2Fsetup%2F%2Fazure%2Farm%2FuiFormDefinition.json" class="automq-blue-button" target="_blank">Install AutoMQ From Marketplace</a>。

<Tip>
  本文中提及 AutoMQ 产品服务方、AutoMQ 服务方、AutoMQ，均指 AutoMQ HK Limited 及其附属公司。
</Tip>

## 操作流程

### 步骤 1：准备 Azure 虚拟网络（VNet）

AutoMQ BYOC 环境部署在用户的 Virtual Network 内，以保障数据隐私和安全。安装 AutoMQ 环境时，需要由用户指定 Virtual Network 和子网信息，并确保 Virtual Network 需要满足如下条件：

* **子网 CIDR 要求：** 子网必须提供不少于 512 个 IP 地址。建议使用 `/23` 或更大的子网 CIDR 块，以便为 AutoMQ 数据面部署和扩容预留充足地址。

* **配置公网 NAT 网关，支持访问公网服务：** AutoMQ 需要访问公网的镜像仓库等服务，因此 AutoMQ 所在的 Subnet 需要配置公网 NAT 网关。

* **配置 Storage Service Endpoint：** AutoMQ 需要访问 Azure Storage 服务，需要配置 Service Endpoint，通过私网访问对象存储服务，以免产生不必要的公网流量费用。配置方法参考本文末的附录内容。

<Tip>
  用户可参考本文附录章节，查看 Virtual Network 以及 Subnet 的配置方法。
</Tip>

### 步骤 2：使用 ARM 模板安装 AutoMQ

1. **访问** [ ](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAutoMQ%2Fautomq-labs%2Frefs%2Fheads%2Fmain%2Fbyoc-examples%2Fsetup%2F%2Fazure%2Farm%2Fmain.json/uiFormDefinitionUri/https%3A%2F%2Fraw.githubusercontent.com%2FAutoMQ%2Fautomq-labs%2Frefs%2Fheads%2Fmain%2Fbyoc-examples%2Fsetup%2F%2Fazure%2Farm%2FuiFormDefinition.json)[AutoMQ 安装链接](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAutoMQ%2Fautomq-labs%2Frefs%2Fheads%2Fmain%2Fbyoc-examples%2Fsetup%2F%2Fazure%2Farm%2Fmain.json/uiFormDefinitionUri/https%3A%2F%2Fraw.githubusercontent.com%2FAutoMQ%2Fautomq-labs%2Frefs%2Fheads%2Fmain%2Fbyoc-examples%2Fsetup%2F%2Fazure%2Farm%2FuiFormDefinition.json)**，** 打开安装界面。AutoMQ Cloud BYOC 环境在 Azure 上默认是通过 ARM 模板进行安装。

2. **参考下方参数说明，设置合适的 Basics 参数值。**

| **设置参数**<br />           | **取值说明**<br />                                                                                  |
| ------------------------ | ----------------------------------------------------------------------------------------------- |
| **Subscription**<br />   | <ul><li>说明：选择 Azure 订阅，AutoMQ 使用的所有云资源都会使用该订阅进行付费。</li><li>建议：建议和应用保持一致。</li></ul>              |
| **Resource group**<br /> | <ul><li>说明：选择 AutoMQ 归属的资源组，后续 AutoMQ 所有的云资源都建议放在相同的资源组下。</li></ul>                             |
| **Region**<br />         | <ul><li>说明：选择 AutoMQ 部署的目标地域，需要和使用 AutoMQ 的 Producer、Consumer 应用保持一致，不支持跨地域访问 AutoMQ。</li></ul> |

<img src="https://mintcdn.com/automq/-iO9wRHb0TWtFSro/zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/1.webp?fit=max&auto=format&n=-iO9wRHb0TWtFSro&q=85&s=1bcf0a3961e1b40e682bff122cbfb1be" width="1610" height="806" data-path="zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/1.webp" />

3. **参考下方参数说明，设置合适的 Virtual Machine Configuration 参数值。**

| **设置参数**<br />                  | **取值说明**<br />                                                                 |
| ------------------------------- | ------------------------------------------------------------------------------ |
| **VM Size**<br />               | <ul><li>说明：选择 AutoMQ 控制台使用的 VM 实例规格，至少需要 2vCPU 8GB Memory，建议保持默认即可。</li></ul>  |
| **Admin Username**<br />        | <ul><li>说明：设置后续 SSH 登录控制台 VM 使用的主机用户名。</li></ul>                               |
| **SSH public key source**<br /> | <ul><li>说明：设置后续 SSH 登录控制台 VM 使用的SSH Key-Pair。 支持创建新的 Key 或使用已有的 Key。</li></ul> |

<img src="https://mintcdn.com/automq/-iO9wRHb0TWtFSro/zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/2.webp?fit=max&auto=format&n=-iO9wRHb0TWtFSro&q=85&s=ff896c4b0721189c02d4a2353c95f3de" width="1570" height="504" data-path="zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/2.webp" />

4. **参考下方的参数说明，设置合适的 Network Configuration 参数值。**

| **设置参数**<br />              | **取值说明**<br />                                                                                                                                                                                                                                                                      |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Public IP Address**<br /> | <ul><li>说明：设置 AutoMQ 控制台对外提供服务时使用的公网 IP。后续用户可以通过该公网 IP 访问 AutoMQ 控制台。</li><li>可选参数值：</li><ul><li>**None：** 不需要分配公网 IP，后续直接通过私网 IP 地址访问控制台。该模式适用于企业具备 VPN、专线等方式连通 Virtual Network。</li><li>**(New) xxx：** 创建新的公网 IP，名称请自行设置。</li><li>**选择已有的公网 IP** ：选择已经创建、可用的公网 IP。</li></ul></ul> |
| **Virtual Network**<br />   | <ul><li>说明：设置 AutoMQ 控制台即将部署的目标 Virtual Network。 需要和 Producer、Consumer 应用保持一致。</li><li>可选参数值：</li><ul><li>**选择已有的 Virtual Network** ：选择应用所在的私有网络。该模式适用于生产场景。</li></ul></ul>                                                                                                         |
| **Subnet**<br />            | <ul><li>说明：设置 AutoMQ 控制台即将部署的目标子网。</li><li>可选参数值：</li><ul><li>Subnet 必须设置为选择已有 Subnet。</li></ul></ul><Tip><br />参考本文档附录章节，Subnet 需要配置公网 NAT 网关，AutoMQ 控制台需要访问公网服务。<br /></Tip><br />                                                                                                |

<img src="https://mintcdn.com/automq/-iO9wRHb0TWtFSro/zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/3.webp?fit=max&auto=format&n=-iO9wRHb0TWtFSro&q=85&s=70d875497a4dcd08810068076f34ee1d" width="1338" height="738" data-path="zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/3.webp" />

5. **参考下方的参数说明，设置合适的 Storage Configuration 参数值。**

| **设置参数**<br />            | **取值说明**<br />                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Storage Account**<br /> | <ul><li>说明：设置 AutoMQ Ops Bucket 使用的 Storage Account。后续 AutoMQ 会采集系统日志、Metrics 等数据上传到该 Storage Account 下，用于预警和分析。</li><li>可选参数值：</li><ul><li>**(New) xxx：** 创建新的 Storage Account。</li><li>**选择已有值** ：选择已经创建、可用的 Storage Account。</li></ul></ul><Info><br />关于 Ops Bucket 的工作原理参考[概述▸](/zh/automq-cloud/manage-environments/manage-environment-ops-authing/overview)。<br /></Info><br /> |

<img src="https://mintcdn.com/automq/-iO9wRHb0TWtFSro/zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/4.webp?fit=max&auto=format&n=-iO9wRHb0TWtFSro&q=85&s=b6b39f06f20d49df730f8fa1c042108a" width="1400" height="502" data-path="zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/4.webp" />

6. **预览配置并创建。查看控制台输出的初始账号密码以及控制台地址。**

| **输出**<br />                                    | **输出说明**<br />                                                                                       |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Automq Byoc Endpoint**<br />                  | <ul><li>AutoMQ BYOC 环境控制台的 URL 地址，用户可以在浏览器访问该地址，或者调用 API、Terraform 访问服务。</li></ul>                   |
| **Automq Byoc Initial  Username**<br />         | <ul><li>环境控制台的初始用户名。</li></ul>                                                                       |
| **Automq Byoc Initial Password**<br />          | <ul><li>环境控制台的初始密码。用户需要在首次登录后立即修改。</li></ul>                                                         |
| **Automq Byoc Managed Identity ClientID**<br /> | <ul><li>AutoMQ  控制台绑定的 Managed Identity ClientID，AutoMQ 控制台会使用该 Managed Identity 的身份访问云资源。</li></ul> |

<img src="https://mintcdn.com/automq/-iO9wRHb0TWtFSro/zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/5.webp?fit=max&auto=format&n=-iO9wRHb0TWtFSro&q=85&s=92a6cbe13e5fe05f565a241a2c74274a" width="2634" height="812" data-path="zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/5.webp" />

7. 使用上述信息登录 AutoMQ 控制台。

<img src="https://mintcdn.com/automq/-iO9wRHb0TWtFSro/zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/6.webp?fit=max&auto=format&n=-iO9wRHb0TWtFSro&q=85&s=346993c11d448b71acf8b00fdca3b86b" width="1664" height="1262" data-path="zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/6.webp" />

### 步骤 3：**完成 BYOC 环境运维授权**

BYOC 环境部署在用户的虚拟网络（VNet）中，将业务数据隔离在用户网络内。环境也会生成运维日志、指标和诊断数据。完成安装后，请按照[运维授权概述](/zh/automq-cloud/manage-environments/manage-environment-ops-authing/overview)授予 AutoMQ 监控服务健康状态和执行托管恢复操作所需的权限。

## 后续步骤

在 Azure 上 AutoMQ 仅支持部署到 AKS 集群。因此，在完成环境安装后，用户需要先准备 AKS 集群，然后再并配置到AutoMQ 控制台，将 AutoMQ 集群部署到 AKS。

准备 AKS 并完成后续部署的文档，请参考[部署到Azure AKS▸](/zh/automq-cloud/deploy-automq-on-kubernetes/deploy-to-azure-aks)。

## 附录

### 配置 Virtual Network 以及 Subnet

#### 配置 Subnet，确保提供充足的 IP 地址

在 Azure 门户中创建子网时，需要配置可提供不少于 512 个 IP 地址的 CIDR 块，建议使用 `/23` 或更大的子网。

<img src="https://mintcdn.com/automq/-iO9wRHb0TWtFSro/zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/7.webp?fit=max&auto=format&n=-iO9wRHb0TWtFSro&q=85&s=4f7f444bf23069416189a2c87384dbb0" width="942" height="846" data-path="zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/7.webp" />

#### 配置 Subnet 开启 NAT Gateway，用于访问公网服务

用户可在 Virtual Network 控制台创建 Subnet 时（或者编辑 Subnet）开启 NAT Gateway。

<img src="https://mintcdn.com/automq/-iO9wRHb0TWtFSro/zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/8.webp?fit=max&auto=format&n=-iO9wRHb0TWtFSro&q=85&s=0e473dd5b0d1157ddf58296cf45ae5d5" width="958" height="382" data-path="zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/8.webp" />

#### 配置 Subnet 开启 Storage Service Endpoint，用于访问 Blob Storage Service。

AutoMQ 需要访问 Azure Storage Service，因此部署 AutoMQ 的所有 Subnet 均需要开启 Storage Service Endpoint，参考下图选择 `Microsoft.Storage` 。

<img src="https://mintcdn.com/automq/-iO9wRHb0TWtFSro/zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/9.webp?fit=max&auto=format&n=-iO9wRHb0TWtFSro&q=85&s=62382d6fbc554757939916c5e7f03309" width="930" height="318" data-path="zh/automq-cloud/getting-started/install-byoc-environment/install-env-on-azure/9.webp" />
