安装 Terraform

Terraform 安装分为以下两个阶段，必须按指定顺序完成

1. private-cloud-bootstrap
2. private-cloud

引导创建主要 Qt Insight 私有云安装所需资源。

以下 Terraform 命令示例中，第一条命令创建了一个计划，第二条命令应用了该计划。这允许您在资源创建之前查看 Terraform 将创建哪些资源。

首次使用 Terraform 安装 Qt Insight

private-cloud-bootstrap

• 部署引导

  cd infra
  terraform -chdir=private-cloud-bootstrap init
  terraform -chdir=private-cloud-bootstrap plan -var-file=private-cloud-dev.tfvars -out ../private-cloud-bootstrap.plan
  terraform -chdir=private-cloud-bootstrap apply ../private-cloud-bootstrap.plan

  有关详细信息和要求，请参阅 private-cloud-bootstrap/INSTALL.md。

private-cloud

引导部署完成后，您可以部署 Qt Insight 私有云。

1. 将 Insight 容器镜像推送到 AWS 弹性容器注册表 (ECR)

   容器镜像作为安装包的一部分提供。您可以使用提供的脚本提取镜像并将它们推送到引导步骤中创建的容器注册表。

   • AWS cli 已安装和配置
   • Docker 已安装
   • Terraform 已安装
   • Java 已安装
   • amazon-ecr-credential-helper

   脚本将 AWS 配置文件名称作为可选参数。

   注意：您也可以通过设置 AWS_PROFILE 环境变量来设置配置文件。

   ./docker/push-images.sh <profile>

2. 创建 Terraform 后端配置。

   私有云安装使用在引导中创建的 S3 存储桶和 DynamoDB 表来存储 Terraform 状态。为此，创建一个包含 Terraform 后端配置的 qtanalytics.s3.tfbackend 文件。

   profile        = "<aws_profile>"
   bucket         = "<terraform_backend_bucket_name>"
   region         = "<region>"
   dynamodb_table = "qt_analytics_terraform"

3. 部署 Qt Insight 私有云

   cd infra
   terraform -chdir=private-cloud init -backend-config=../qtanalytics.s3.tfbackend
   terraform -chdir=private-cloud plan -compact-warnings -var-file=../env/sandbox.tfvars -out ../private-cloud.plan
   terraform -chdir=private-cloud apply ../private-cloud.plan

4. 在 private-cloud Terraform 为您选择的子域名创建 Route 53 主机区域之后，您可以在 AWS 证书管理器中验证证书。有关更多信息，请参阅 AWS 文档 - DNS 验证。

   在初始安装后或更新时，您只需按上述说明再次部署 Qt Insight 私有云即可。