预览部署的更新

本页介绍了如何使用 Infrastructure Manager 预览 Terraform 配置中定义的资源的部署。

预览会说明用于启用特定 Terraform 配置的操作。在创建新的部署或更新部署之前，您可以预览部署，以验证计划预配的资源。

预览会执行 Terraform plan 命令。本页假定您熟悉 Terraform。如需了解详情，请参阅 Terraform 和 Infrastructure Manager。

如需创建预览，Terraform 配置需要与受支持的 Terraform 版本之一兼容。

准备工作

  1. 启用 Infra Manager。
  2. 确保您拥有创建预览所需的 IAM 权限：roles/config.admin。
  3. 确保您拥有具有所需权限的服务账号。如需了解详情，请参阅配置服务账号。
  4. 指定要预览的 Terraform 配置。确保此 Terraform 配置符合限制，包括配置不包含敏感数据。

预览部署的更新

您用于更新部署的 Terraform 配置可以位于存储桶中，也可以位于 Git 代码库中。

您还可以使用此 Terraform 配置预览更新。

使用存储在 Cloud Storage 存储桶中的 Terraform 配置进行预览

更新部署时，部分现有资源可能不会发生变化。预览更新时，您可以查看计划预配或删除的资源，以及计划不修改的资源。

  1. 确定要更新的部署。

  2. 确保 Terraform 配置已上传到 Cloud Storage 存储桶。如需了解详情，请参阅将配置上传到存储桶。

    借助存储桶，您可以控制对配置的访问权限。您还可以部署存储在 Git 代码库或本地机器上的 Terraform 配置。

  3. 如需预览更新，请执行以下操作：

    gcloud infra-manager previews create projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID \
    --service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \
    --deployment=projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \
    --gcs-source gs://BUCKET_NAME/OBJECT_NAME \
    --input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \
    --tf-version-constraint=TERRAFORM_VERSION

    您需要进行如下替换：

    • PROJECT_ID 是运行 Infrastructure Manager 的项目 ID。
    • LOCATION 是 Infra Manager 的运行位置。如需查看有效位置的列表，请参阅 Infrastructure Manager 位置。
    • PREVIEW_ID 是您指定的预览标识符。如需详细了解预览 ID 的限制，请参阅预览名称。
    • SERVICE_ACCOUNT 是您用于调用 Infra Manager 的服务账号的名称。
    • SERVICE_ACCOUNT_PROJECT_ID 是服务账号的项目 ID。通常，此项目与 Infra Manager 运行的项目相同。
    • DEPLOYMENT_ID 是您要更新的部署的部署标识符。
    • BUCKET_NAME 是存储配置的存储桶的名称。

    • OBJECT_NAME 是配置文件的对象名称。此对象可以是目录或 ZIP 文件，但不能是 Terraform 文件。如果您使用的是对象版本控制，还可以指定对象的世代号。如需了解详情，请参阅使用具有版本控制的对象。

      如果存储桶是 Terraform 配置的根路径，则 OBJECT_NAME 是可选的。

    • INPUT_1_NAME=VALUE 和 INPUT_2_NAME=VALUE：Terraform 配置中的任何输入值，包括默认未定义的值。例如，您可以将部署资源的项目指定为 project_id=my-project。

      如果配置中默认定义了所有输入值，则此标志为可选标志。

    • 可选：TERRAFORM_VERSION：Infrastructure Manager 用于创建部署的 Terraform 版本。如需查看受支持版本的列表，请参阅受支持的 Terraform 版本。如果您移除此可选标志，系统会使用最新的受支持版本的 Terraform。

    除非您在预览命令中指定了新值，否则部署中的字段（例如 Terraform 配置、变量和服务账号）会自动合并到预览中。

现在，您已创建预览，可以导出和查看结果，以查看部署方案。

使用存储在 Git 代码库中的 Terraform 配置进行预览

更新部署时，部分现有资源可能不会发生变化。预览更新时，您可以查看计划预配或删除的资源，以及计划不修改的资源。

  1. 如果您的 Terraform 配置存储在私有 Git 代码库中，并且您尚未这样做，请确保您已使用 Cloud Build 连接到您的 GitHub 主机和 GitHub 代码库，以便 Infra Manager 访问您的代码库。

  2. 如需更新部署，请执行以下操作：

    gcloud infra-manager previews create projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID \
    --service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \
    --deployment=projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \
    --git-source-repo="GIT_REPO" \
    --git-source-directory="DIRECTORY" \
    --git-source-ref="REF" \
    --input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \
    --tf-version-constraint=TERRAFORM_VERSION

    您需要进行如下替换：

    • PROJECT_ID 是运行 Infrastructure Manager 的项目 ID。
    • LOCATION 是 Infra Manager 的运行位置。如需查看有效位置的列表，请参阅 Infrastructure Manager 位置。
    • PREVIEW_ID 是您指定的预览标识符。如需详细了解预览 ID 的限制，请参阅预览名称。
    • SERVICE_ACCOUNT 是您用于调用 Infra Manager 的服务账号的名称。
    • SERVICE_ACCOUNT_PROJECT_ID 是服务账号的项目 ID。通常，此项目与 Infra Manager 运行的项目相同。
    • DEPLOYMENT_ID 是您要更新的部署的部署标识符。
    • GIT_REPO：Git 代码库。
    • DIRECTORY：包含 Terraform 配置的目录。
    • REF：配置的 Git 参考。引用是可选的。如果您未指定引用，则系统会使用 Git 代码库的默认配置分支。

    • INPUT_1_NAME=VALUE 和 INPUT_2_NAME=VALUE：Terraform 配置中的任何输入值，包括默认未定义的值。例如，您可以将部署资源的项目指定为 project_id=my-project。

      如果配置中默认定义了所有输入值，则此标志为可选标志。

    • 可选：TERRAFORM_VERSION：Infrastructure Manager 用于创建部署的 Terraform 版本。如需查看受支持版本的列表，请参阅受支持的 Terraform 版本。如果您移除此可选标志，系统会使用最新的受支持版本的 Terraform。

除非您在预览命令中指定了新值，否则部署中的字段（例如 Terraform 配置、变量和服务账号）会自动合并到预览中。

现在，您已创建预览，可以导出和查看结果，以查看部署方案。

后续步骤