部署到 Azure AKS

​

安装环境控制台

​

准备 AKS 集群和节点池

​

步骤 1：创建 AKS 集群

​

Console UAMI 访问 AKS 集群

• 控制台使用 Console UAMI 通过 Microsoft Entra token 进行认证。
• 控制台使用 clusterUser kubeconfig，使 Kubernetes 请求携带控制台的具体身份。

​

Console Kubernetes 权限

• 在目标 AKS cluster scope 为 Console UAMI 授予 Azure Kubernetes Service RBAC Cluster Admin。
• 授予 System Initialization 页面生成的 AKS access 权限。该权限至少应包含 Microsoft.ContainerService/managedClusters/listClusterUserCredential/action，用于获取 clusterUser kubeconfig；它本身不授予 Kubernetes 管理权限。

​

数据面访问 Azure 资源

​

网络和出站

• 使用 Azure CNI Node Subnet。创建 AKS 集群时必须显式配置 --network-plugin azure，且不要配置 --network-plugin-mode overlay。确保 Pod IP 可以从 AKS 集群外的控制台直接访问。
• 确保控制台能够访问 AKS API Server 和 AutoMQ 服务端口。
• 确保节点能够访问容器镜像仓库、Azure APIs 和 AutoMQ 所需外部服务。

​

生产环境的可用区

​

步骤 2：检查网络访问路径

• AutoMQ 控制台可以访问 AKS API Server。
• AutoMQ 控制台可以访问 AutoMQ 数据面的 Pod 或 Service 端口。
• Kafka client 所在网络可以按业务需要访问 AutoMQ service。
• AKS node 可以访问容器镜像仓库、Azure APIs 和 AutoMQ 所需外部服务；无 Public IP 时需要 NAT Gateway 或其他出站路径。
• 对于 private AKS API Server，控制台 VM 必须能够连接 AKS VNet，并能够解析 AKS private DNS name。
• 对于启用 authorized IP ranges 的 public AKS API Server，该范围必须包含控制台的出口地址。

az aks show \
  --resource-group <resource-group> \
  --name <cluster-name> \
  --query '{networkPlugin:networkProfile.networkPlugin,networkPluginMode:networkProfile.networkPluginMode}' \
  --output yaml

​

步骤 3：准备 AutoMQ 专用节点池

• 根据 概述 选择 VM size 和节点数量。
• 建议跨 3 个 Availability Zone，并启用 Cluster Autoscaler。
• 添加 taint：dedicated=automq:NoSchedule。

​

步骤 4：准备 AutoMQ workload identity

​

创建 AutoMQ Instance

​

步骤 1：在控制台创建实例

1. AKS cluster：选择目标集群。API 或自动化场景使用完整 ARM ID：/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.ContainerService/managedClusters/<aks-name>。
2. Node pool：填写所选 AKS cluster 内的 node pool short name。
3. Virtual Network：填写 selected VNet 的完整 ARM ID。Kubernetes 部署不将 Subnet 作为 workload placement 输入。
4. Data bucket：选择 Managed resource，或输入 Customer-Provided Blob container。Azure Bucket ID 格式为 <storage-account>:<container>。
5. Private DNS Zone：选择 Managed resource，或输入 Customer-Provided Private DNS Zone 的完整 ARM ID。Customer-Provided Zone 必须已有指向 selected VNet 的 resolution-only VNet Link。
6. Instance identity：选择 Managed identity，或输入 Customer-Provided UAMI 的完整 ARM ID。
7. Namespace 和 ServiceAccount：使用 Customer-Provided identity 时，填写 Federated Identity Credential 中 subject 对应的值。
8. 预览配置并完成创建。

​

步骤 2：检查并配置 Placeholder

# 1. 确认当前 kubeconfig 指向实例所在的 Kubernetes 集群
kubectl config current-context

# 2. 安装依赖并下载脚本
python3 -m pip install pyyaml
curl -fL https://www.automq.com/downloads/check-placeholder.py \
  -o check-placeholder.py

# 3. 替换为 AutoMQ 控制台中的实例 ID，检查 Placeholder Deployment
INSTANCE_ID="<instance-id>"
python3 check-placeholder.py --instance-id "$INSTANCE_ID"

# 输出文件已存在时，使用 --output <new-file.yaml> 指定新文件名
# 4. 本次检查生成 YAML 时，检查文件后执行脚本输出的 kubectl apply 命令
# 所有可用区均为 EXISTS 时，继续第 5 步；出现 ERROR 时，处理后重试
# kubectl apply -f placeholder.yaml

# 5. 查看 Pod 状态，等待 STATUS 为 Running、READY 中所有容器就绪
kubectl get pods -n automq-placeholders \
  -l app=low-priority-placeholder -o wide

# 更多选项（指定 context、输出文件名或镜像等）
# python3 check-placeholder.py --help

​

后续步骤