在 Google Cloud 上安装 AutoMQ

​

概述

​

前置条件

• VPC 环境：AutoMQ 控制台和 GKE 集群需要运行在您的 VPC 中，通常应与 Kafka 客户端应用部署在相同 VPC 或可连通的 VPC 中。

​

操作步骤

​

步骤 1：在 AutoMQ 官网注册环境

1. 访问 AutoMQ Cloud，登录您的账户。
2. 在控制台页面，点击 创建环境。
3. 根据向导填写环境名称、云厂商、地域等信息。
4. 完成创建后，复制安装向导中生成的 Docker 启动命令。

​

步骤 2：准备控制台 VM 并部署控制台

PROJECT_ID="<service-project-id>"
CONSOLE_SA_ID="automq-console"

gcloud iam service-accounts create "${CONSOLE_SA_ID}" \
  --project="${PROJECT_ID}" \
  --display-name="AutoMQ console"

​

基本要求

1. 实例规格
   • 至少 2 核 CPU 和 8 GB 内存。
   • 系统盘至少 20 GiB。
   • 建议为控制台数据准备独立数据盘或稳定的数据目录。
2. 网络位置
   • 控制台 VM 应位于后续 GKE 集群可访问的 VPC 和子网中。
   • 如果使用 Shared VPC，请确认控制台所在 Service Project 与 VPC 所在 Host Project 的权限边界。
   • 控制台服务默认监听 8080 端口。请在防火墙规则中允许您的运维访问来源访问控制台 VM 的 8080 端口，并根据实际办公网络或跳板机网段收敛来源 CIDR。
   如需通过 gcloud 创建防火墙规则，可参考如下命令。该示例通过 --target-service-accounts 将目标收敛到绑定了控制台 Google Service Account 的 VM。NETWORK_PROJECT_ID 是 VPC 和防火墙规则所在项目；非 Shared VPC 场景下通常就是 Service Project。
   NETWORK_PROJECT_ID="<network-project-id>"
   VPC_NAME="<vpc-name>"
   CONSOLE_SA_EMAIL="<console-service-account-email>"
   SOURCE_CIDR="<operator-source-cidr>"
   
   gcloud compute firewall-rules create "automq-console-allow-8080" \
     --project="${NETWORK_PROJECT_ID}" \
     --network="${VPC_NAME}" \
     --direction=INGRESS \
     --action=ALLOW \
     --source-ranges="${SOURCE_CIDR}" \
     --target-service-accounts="${CONSOLE_SA_EMAIL}" \
     --rules=tcp:8080
   
3. 公网访问或出网能力
   • 控制台 VM 需要能够拉取 Docker 镜像并同步必要元数据。可以通过公网 IP、Cloud NAT 或其他出网方式实现。
   • 如果控制台 VM 不配置公网 IP，也没有通过 Cloud NAT 或其他方式提供出网能力，请为控制台 VM 所在子网启用 Private Google Access，使 VM 可以访问 Cloud Storage、GKE、IAM、Cloud DNS 等 Google APIs。该配置只覆盖 Google API 访问；如果需要访问外部镜像仓库等非 Google 端点，仍需要公网 IP、Cloud NAT 或其他出网路径。可参考 Google Cloud 官方文档《配置 Private Google Access》。
4. VM 服务账号
   • 创建 VM 时，将前面准备的控制台 Google Service Account 绑定到该 VM。这里绑定的是本步骤开始时创建的同一个服务账号，后续权限初始化也会围绕它完成。
   • 创建 VM 的操作者需要具备对该服务账号的 iam.serviceAccounts.actAs 权限，才能将该服务账号绑定到 VM。
   • 将 VM 的访问范围设置为允许访问所有 Cloud APIs（https://www.googleapis.com/auth/cloud-platform）。Google Cloud 的默认访问范围只包含 Cloud Storage 只读、Logging、Monitoring 等有限权限。
   • 即使控制台 Google Service Account 已具备 IAM 权限，VM 访问范围不足仍可能导致控制台无法调用 GKE、IAM、Cloud DNS 或写入 GCS。可参考 Google Cloud 官方文档《创建使用用户管理的服务账号的虚拟机》。

​

安装并启动 Docker

sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker
sudo docker version

​

启动 AutoMQ 控制台

sudo docker ps
sudo docker logs -f "<container-name-or-id>"

​

步骤 3：配置控制台权限并完成初始化

​

后续步骤

• 部署到 GKE：完成控制台安装和权限初始化后，请参考 部署到 Google Cloud GKE。
• 通过 WebUI 使用 AutoMQ：继续通过环境控制台创建实例，并体验产品功能。体验 AutoMQ▸
• 通过 Terraform 使用 AutoMQ：安装控制台后，用户可以通过 AutoMQ Terraform Provider 管理和使用 AutoMQ。通过 Terraform 方式使用 AutoMQ，请参考 Terraform Provider 文档。