部署到 Google Cloud GKE

​

操作流程

​

步骤 1： 安装环境控制台

• 通过 Marketplace 安装控制台**（推荐）** ，参考从 GCP Marketplace 安装环境▸。
• 通过 Terraform 安装控制台，参考使用 Terraform Module 安装环境▸。

​

步骤 2：创建 IAM 服务账号

1. 前往 IAM 控制台，点击 Service Accounts ，创建 Service Accounts 。填写自定义服务账号名称。

2. 授予服务账号必要的系统角色，系统角色列表如下：
   • roles/resourcemanager.tagUser
   • roles/artifactregistry.reader
   • roles/autoscaling.metricsWriter
   • roles/monitoring.metricWriter
   • roles/stackdriver.resourceMetadata.writer
   • roles/monitoring.viewer
   • roles/logging.logWriter

3. 完成服务账号创建，记录服务账号的名称和 ID，后续创建节点池需要填写。

​

步骤 3： 创建 GKE 集群

​

设置 GKE 集群类型和地域

1. 登录 Google Cloud GKE 控制台。点击创建集群 。

2. 选择集群类型为Standard: You manage your cluster。

3. 填写集群名称、地域信息：
   • Location Type： 选择 Regional ，这样后续可以创建三可用区的 AutoMQ 实例。
   • Target Release Channel： 建议选择稳定版本。

​

设置 GKE 集群网络

1. 切换至Networking 配置 ，选择目标 VPC 和子网 。

2. 修改网络配置。需要确保设置如下选项：
   1. 开启 VPC-native traffic routing 。
   2. 开启 Dataplane V2 。

​

设置 GKE 集群公共节点池

​

添加 AutoMQ 专用节点池

1. 点击上方添加节点池 按钮，配置 AutoMQ 专用节点池。

2. 开启 Cluster AutoScaler。 并配置为Balanced 类型均衡**，** 大小限制设置为 Total limits ，设置合适的上限（建议上限设置 50-100）。

3. 在Nodes 标签页中，参考概述▸配置符合 AutoMQ 要求的机型列表。

4. 在Security 标签页中，绑定步骤 2 创建的 AutoMQ 节点池专用的服务账号 。

5. 在元数据标签页中，设置 AutoMQ 独占使用的污点。污点的键是dedicated，值是 automq，效果是 NO_SCHEDULE。

​

点击创建 GKE 集群

1. 检查所有配置无误后，点击下方 Create，创建 GKE 集群 。
2. GKE 集群创建完成后，复制集群 Name 。用于步骤 3 配置使用。

3. 查看 GKE 集群列表找到集群，对该集群添加 Tag，用于约定后续 AutoMQ 控制台的管理权限。

​

关闭 GKE 元数据服务器（GKE 集群开启 Workload Identity 时需要）

1. 查看 AutoMQ 专用节点池，点击编辑。
2. 查看安全选项，关闭 GKE 元数据服务器 。

3. 点击保存提交，GKE 会重新更新所有节点的配置。

​

部署 AutoMQ Placeholder Deployment

kubectl apply -f automq-low-priority.yaml

• metadata.name : 建议修改成具有意义的 Placeholder 名称，例如 placeholder-for-nodegroup-A 。
• replicas : Placeholder pod 预留数量，默认为 1，如果是多可用区部署，建议每个可用区保留 1 台机器，即数量设置为可用区的数量。
• affinity.nodeAffinity : 用于选择 Placeholder 部署的节点，需要修改 matchExpressions 中的 key 和 values 来精确匹配 AutoMQ 的节点池。在示例的 yaml 文件中提供 2 个选项筛选节点。
  • cloud.google.com/gke-nodepool ：在 GKE 上使用 cloud.google.com/gke-nodepool 标签筛选指定的节点池。
  • node.kubernetes.io/instance-type ：在 GKE 上使用 node.kubernetes.io/instance-type 标签筛选指定的节点机型。
• resources :
  • limits 的 cpu/memory 与 Node Group 具体的规格保持一致，比如2C16G 。
  • requests 的 cpu/memory 略小于 Node Group 具体的规格，比如实际占用 3/4 比例，确保 Placeholder Pod 能调度到额外 Node 并保证独占效果，避免集群其他 Pod 非预期占用导致实际 Failover 时因资源不足调度失败。

metadata:
  # TODO: Replace with your custom name
  name: {Replace with your custom placeholder deployment name}
spec:
  # TODO: Replace with your custom node nums
  replicas: 1
    spec:
      affinity:
        nodeAffinity:
          requiredDuringSchedulingIgnoredDuringExecution:
            nodeSelectorTerms:
              - matchExpressions:
                - key: cloud.google.com/gke-nodepool
                  operator: In
                  values:
                  # TODO: Replace with your custom Node Pool Name
                  - "Replace with your custom Node Pool Name"
                - key: node.kubernetes.io/instance-type
                  operator: In
                  values:
                  # TODO: Replace with your custom Node Pool VM Size
                  - "Replace with your custom Node Pool VM Size"
      containers:
        - name: placeholder
          resources:
          # TODO: Replace with your custom Memory and CPU size
            limits:
              cpu: 2000m
              memory: 16Gi
            requests:
              cpu: 1000m
              memory: 12Gi               

kubectl apply -f automq-gke-placeholder.yaml

kubectl get pods -l app=low-priority-placeholder -o wide

​

步骤 4：进入环境控制台，创建部署配置

1. 复制步骤3 创建的 GKE 集群的集群名称 。
2. 登录控制台，录入集群名称等配置，点击下一步。
   1. 部署类型：选择 Kubernetes。
   2. Kubernetes 集群：填写 GKE 集群的集群名称。
   3. DNS ZoneId：填写用于部署 AutoMQ 的 Private DNS 的 ZoneId。
   4. Bucket 名称：填写用于部署 AutoMQ 存储消息的数据 Bucket，支持添加多个 GCS Bucket。

3. 填写云资源信息后，生成数据面 GKE 节点池需要授权的权限。参考控制台指引，创建自定义授权策略 。然后将授权策略绑定到步骤 2 创建的 AutoMQ IAM 委托，并录入该节点池委托名称 ，点击下一步预览 。

4. 预览部署配置信息，完成创建 。即可前往实例管理页面创建实例。