跳转到主要内容

​
概述

在 AWS 上使用 AutoMQ Cloud BYOC 环境，您首先需要安装 AutoMQ 控制台。控制台是一个部署在您账户下的 Web 应用，您将通过它来创建、管理和监控您的 AutoMQ 集群。

​
前置条件

在开始安装 AutoMQ 控制台之前，请确保您已经按照要求准备好了基础的 AWS 云资源。
  • VPC 环境：AutoMQ 控制台和集群需要运行在您自己的 VPC 中，一般是和 Kafka 应用部署在相同的 VPC。

​
操作步骤

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

首先，您需要在 AutoMQ 官网注册您的部署环境，以获取环境安装的元信息。
  1. 访问 AutoMQ Cloud，登录您的账户。
  2. 在控制台页面，点击 创建环境。
  3. 根据向导，输入以下信息：
    • 环境名称：为您的环境设置一个自定义名称。
    • 描述：输入环境的相关描述。
    • 云厂商：选择 AWS。
    • 地域：选择您计划部署 AutoMQ 的 AWS 地域。
  4. 完成创建后，您将获得用于部署的环境元信息。

​
步骤 2：准备 EC2 实例并部署控制台

AutoMQ 控制台是管理 AutoMQ Cloud BYOC 环境的核心组件，它本身是部署在一台独立的 EC2 实例上。因此，在安装之前，您需要提前准备好这台 EC2 实例。

​
基本要求

为确保控制台的稳定运行，您准备的 EC2 实例需要满足以下基本要求：
  1. 实例规格：
    • 配置：至少需要 2 核 CPU 和 8 GB 内存。
    • 系统卷：至少需要 20 GiB 的存储空间。
    • 数据卷：必须额外挂载一块数据卷用于存储元数据，空间不得少于 20 GiB。
重要提示：为了防止 EC2 实例迁移或故障导致控制台元数据丢失，请务必为 AutoMQ 控制台的 EC2 实例挂载额外的数据卷，并将元数据存储在该数据卷上。
  1. 网络位置：
    • 该 EC2 实例必须和后续部署的 AutoMQ 集群位于同一个 VPC 内。
    • 通常，这个 VPC 也应该与您的应用服务所在的 VPC 保持一致，以确保网络连通性。
  2. 公网访问：
    • 该 EC2 实例必须能够访问互联网，以便下载安装包和同步必要的元数据。您可以通过关联 EIP（弹性公网 IP）或配置公网 NAT 网关来实现。

​
创建与部署步骤

  1. 登录 AWS EC2 控制台，点击 启动实例。
  2. 操作系统 (AMI)：选择一个您熟悉的 Linux 发行版，例如 Amazon Linux 2 或 Ubuntu。
  3. 实例类型：选择满足上述规格要求的实例类型（例如 t3.large 或更高配置）。
  4. 网络设置：
    • 选择目标 VPC 和一个公网子网（如果使用 EIP）或私网子网（如果使用 NAT 网关）。
    • 确保安全组开放了必要的端口，例如 SSH (22) 端口以便您登录和管理，以及控制台服务的服务端口（默认为 8080）。访问来源可根据您的需求设置为 0.0.0.0/0（允许所有 IP 访问，适用于测试环境）或限制为特定 IP 范围。
  5. 存储配置：
    • 配置系统卷（根卷）大小至少为 20 GiB。
    • 点击 添加新卷，额外添加一个数据卷，并确保其大小不小于 20 GiB。
  6. 完成其他配置后，启动实例。
  7. 挂载数据卷：
    • 实例启动后，登录到 EC2 实例。
    • 将您在存储配置中额外添加的数据卷挂载到操作系统的指定目录（例如 /data）。此路径将作为后续启动 Docker 容器时的数据挂载路径。
    • 请确保挂载点具有正确的权限。
  8. 安装并启动 Docker 服务：
    • 在 EC2 实例上安装 Docker。以下是针对 Amazon Linux 2023 的参考命令：
    # 更新软件包
sudo dnf update -y
# 安装 Docker
sudo dnf install docker -y
# 启动 Docker 服务
sudo systemctl start docker
# 将当前用户添加到 docker 组，以便无需 sudo 即可运行 Docker 命令
sudo usermod -aG docker ec2-user
# 启用 Docker 服务开机自启
sudo systemctl enable docker
# 验证 Docker 是否安装成功
docker version
    • 注意：如果您使用的是其他 Linux 发行版（如 Amazon Linux 2），请参考 Docker 官方文档或使用对应的包管理器进行安装。
  9. 部署 AutoMQ 控制台
    • EC2 实例准备完成后，即可参考安装向导，复制安装命令，启动 AutoMQ 控制台。

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

AutoMQ 控制台启动成功后，您需要登录控制台，首次访问时需要为其授予必要的 AWS 云资源操作权限。
  1. 登录控制台
    • 使用浏览器访问 http://<您的 EC2 公网 IP>:8080。
    • 输入初始用户名和密码登录。
  2. 为控制台授予 IAM 权限 登录后，界面会引导您为 AutoMQ 控制台完成 IAM 授权。这是为了让控制台有权限在您的 AWS 账户中创建和管理集群资源。操作流程如下：
    1. 创建 IAM Policy：
      • 根据控制台界面提供的策略 JSON，前往 AWS IAM 控制台创建一个新的客户管理策略（Customer managed policy）。
    2. 创建 IAM Role：
      • 创建一个新的 IAM Role。
      • 在选择信任实体时，选择 AWS service 和 EC2。
      • 将上一步创建的 IAM Policy 附加到这个 Role 上。
    3. 关联 IAM Role 到 EC2 实例：
      • 前往 AWS EC2 控制台，找到您用于部署控制台的 EC2 实例。
      • 在 操作 -> 安全 -> 修改 IAM 角色 中，将上一步创建的 IAM Role 关联到该实例上。
  3. 完成初始化
    • 返回 AutoMQ 控制台页面，点击 确认授权 或 下一步。
    • 控制台会自动验证权限是否配置正确。验证通过后，您就可以正式进入 AutoMQ 控制台并开始创建您的第一个集群了。

​
后续步骤

  • 通过 WebUI 使用 AutoMQ： 继续通过环境控制台创建实例，并体验产品功能。体验 AutoMQ▸
  • 通过 Terraform 使用 AutoMQ： 安装控制台后，用户可以通过 AutoMQ Terraform Provider 管理和使用 AutoMQ。通过 Terraform 方式使用 AutoMQ ，请参考文档。