Skip to main content

从 AWS Marketplace 安装环境

参考概述▸ ，使用 AutoMQ Cloud 需要先安装环境。本文介绍如何从 AWS Marketplace 安装 BYOC 环境。

本文中提及 AutoMQ 产品服务方、AutoMQ 服务方、AutoMQ，均特指 AutoMQHK Limited及其附属公司。

前置条件​

条件一：云账号操作权限​

创建 BYOC 环境，需要操作的云账号为主账号 或者是已经被授权相关操作权限的 IAM 子账号 。如果当前操作 AWS 控制台使用了 IAM 子账号，需要先授权再进行服务开通操作。

通常可以为 IAM 子账号，授予下方的AWS 托管策略，即可进行后续的部署安装：

  • AmazonVPCFullAccess：管理专有网络 VPC 的权限。

  • AmazonEC2FullAccess：管理 EC2 产品的权限。

  • AmazonS3FullAccess：管理对象存储 S3 的权限。

  • AmazonRoute53FullAccess：管理 Route 53 服务的权限。

  • IAMFullAccess：管理 AWS IAM 授权策略和角色的权限。

操作流程​

步骤 1：准备 VPC​

AutoMQ BYOC 环境部署在用户 VPC 内，以保障数据隐私和安全。从 AWS Marketplace 安装 AutoMQ 环境时，支持以下两种方式：

  • 自动创建新的 VPC 安装环境： 选择此选项后由 Marketplace CloudFormation 自动创建 VPC 等资源，无需用户手工配置，推荐用于首次 POC 和测试。

  • 由用户提供 VPC 安装环境： Marketplace 不会主动创建 VPC 网络，由用户指定已有的 VPC 网络。

如果选择 由用户提供 VPC 安装环境 ，则必须参考准备 VPC▸准备 VPC 网络，确保符合 AutoMQ 的要求。否则会导致安装失败。

步骤 2：从 Marketplace 订阅 AutoMQ​

AutoMQ Cloud BYOC 环境安装包在 AWS 上通过 Marketplace CloudFormation 商品提供分发，用户可以从 Marketplace 订阅 AutoMQ，商品链接是 AutoMQ for Kafka (BYOC FreeTier)。

前往 AWS Marketplace，访问商品页面 AutoMQ for Kafka (BYOC FreeTier)。

点击 Continue to Subscribe，首次访问，请点击确认用户协议。

选择从 CloudFormation Template 配置，按照提示填写表单。

步骤 3：使用 CloudFormation 模板安装环境​

在上一步，选择CloudFormation Template 配置后，会跳往 CloudFormation 产品界面，创建新的 Stack。

按照提示填写如下参数，继续配置，启动创建流程。

设置参数
取值说明
Stack Name
  • 说明：当前 CloudFormation Stack 名称。
  • 限制：该名称会用于命名资源变量，建议仅设置大小写字母、数字。
ExistingVPCId
  • 说明：指定环境部署的目标 VPC Id，如果不设置留空，则会自动创建新的 VPC 。
ExistingPublicSubnetId
  • 说明：指定环境部署的目标子网 Id， 当设置 ExistingVPCId 时，即使用已有 VPC 时，此参数必须设置。
ExistingPubliceSubnetAvailabilityZone
  • 说明：指定环境部署的目标子网所在的可用区， 当设置 ExistingPublicSubnetId 时，即使用已有子网时，此参数必须设置。
MsgBucket
  • 说明：设置消息 S3 Bucket 名称，该 Bucket 用于存储 Kafka 消息数据 。
  • 如果不设置，则会自动创建一个全新的 Bucket。
OpsBucket
  • 说明：设置运维 S3 Bucket 名称，该 Bucket 用于存储 AutoMQ 的系统日志、Metrics 等数据，不含应用数据。
  • 如果不设置，则会自动创建一个全新的 Bucket。
WebConsoleInstanceType
  • 说明：设置部署 AutoMQ BYOC 环境控制台的 EC2 实例类型。
  • 限制：建议至少选择 2 核 8G 的机型。
SecurityGroupCIDR
  • 说明：设置访问 AutoMQ 环境控制台的安全组来源 CIDR。
KeyName
  • 说明：设置访问 AutoMQ 环境控制台所在的 EC2 实例的登录证书 KeyName。
  • 如果不设置，则不会创建 EC2 Key，后续无法通过 SSH 登录 EC2 实例。
集群部署类型
  • 说明：设置该环境后续将 AutoMQ 数据集群安装到 Kubernetes 还是 VM 上。
  • 可选值：
    • vm：设置该选项后，默认将 AutoMQ 集群安装到 EC2 上。
    • k8s：设置该选项后，则需要参考 部署到AWS EKS▸，配置 EKS 集群。后续会将 AutoMQ 集群安装到用户提供的 EKS 上。

注意：
如果选择 vm 模式，则安装环境后即可直接创建 AutoMQ 实例（集群）；如果选择 k8s 模式，则需要先配置 EKS 集群，然后可以创建 AutoMQ 实例（集群）。

步骤 4：获取 CloudFormation 输出，访问环境​

上一步安装完成后，查看当前 CloudFormation 的 Output，获取访问环境的初始信息。

输出返回
输出说明
AutoMQWebConsoleURL
  • AutoMQ BYOC 环境控制台的 URL 地址，用户可以在浏览器访问该地址，或者调用 API、Terraform 访问服务。
DefaultUserName
  • 环境控制台的初始用户名。
DefaultPassword
  • 环境控制台的初始密码。用户需要在首次登录后立即修改。
IAMRoleforAutoMQEnvironmentConsole
  • AutoMQ BYOC 环境控制台绑定的 IAM Role，用于授权 AutoMQ 控制台访问 AWS EKS 等查询权限。
IAMRoleforAutoMQDedicatedNodeGroup
  • AutoMQ 集群需要使用独占的节点组，该角色绑定到独享节点组，授权节点组内的AutoMQ 组件访问 AWS S3 等云服务。

步骤 5：完成 BYOC 环境运维授权​

BYOC 环境部署在用户 VPC，具备数据安全和隐私隔离的效果，但 BYOC 环境内部会产生系统日志、Metrics 等业务无关的系统数据。环境安装完成后，用户需要参考管理环境运维授权▸ 对 AutoMQ 服务方提供相应的运维授权，方便 AutoMQ 服务方进行系统稳定性监控和故障自愈等运维操作。

后续步骤​

  • 配置 EKS（EKS 模式需要处理）： 如果在安装 BYOC 环境时选择将 AutoMQ 部署到 EKS，则在完成环境安装后，用户需要先准备 EKS 集群，然后再并配置到 AutoMQ 控制台，将 AutoMQ 集群部署到 EKS。准备 EKS 并完成后续部署的文档，请参考部署到AWS EKS▸。

  • 通过 WebUI 使用 AutoMQ： 通过浏览器访问步骤 3 返回的控制台地址，输入初始用户名密码，即可进入环境控制台创建实例，并体验产品功能。体验 AutoMQ for Kafka▸

  • 通过 Terraform 使用 AutoMQ： 环境安装完成后，用户可以通过 AutoMQ Terraform Provider 管理和使用 AutoMQ。通过 Terraform 方式使用 AutoMQ ，请参考文档。

附录​

  • 安装的云资源清单以及说明见 云资源清单▸

  • AutoMQ 在 AWS 上的整体部署架构图如下：

AutoMQ 使用 Amazon Linux 2 AMI 系统镜像，确保提供安全、可靠的操作系统。