部署、修订版本和预览概览

本页面介绍了部署和修订版本,包括以下内容:

  • 为每个部署存储的元数据列表。
  • 部署名称和修订版本名称的格式。

部署

Infra Manager 会将资源预配到 Google Cloud 作为部署。

部署可以将 Google Cloud 资源预配到多个位置和多个项目。请注意:

  • 相应位置需要提供特定资源。例如,如需查看 Cloud Run 可在哪些位置使用,请参阅 Cloud Run 位置
  • 服务账号必须具有部署到指定项目所需的权限。如需了解详情,请参阅配置服务账号

部署元数据

Infra Manager 会在运行 Infra Manager 的项目和位置中创建一个存储桶。创建部署后,Infrastructure Manager 制品会位于此存储桶中,该存储桶的名称为:gs://PROJECT_NUMBER-LOCATION-blueprint-config

Infra Manager 使用术语蓝图来指代 Terraform 配置。

其中,您需要替换以下项:

  • PROJECT_ID:运行 Infra Manager 的项目 ID。
  • LOCATION:运行 Infra Manager 的位置。

存储桶中的部署制品包括:

  • Cloud Build 日志。
  • Terraform 日志。
  • Terraform 配置的副本。

Infra Manager 还会存储 Terraform 状态文件的副本。如需详细了解状态文件(包括如何访问该文件),请参阅管理 Terraform 状态文件

修订版本是部署的版本,因此 Infra Manager 会为每个修订版本存储此部署元数据。

部署 ID

部署 ID 是用户为部署资源指定的标识符。使用部署 ID 以以下格式引用部署:

projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID

替换以下内容:

  • PROJECT_ID 是运行 Infra Manager 的项目 ID。
  • LOCATION 是 Infra Manager 的运行位置。如需查看有效位置的列表,请参阅Infrastructure Manager 位置
  • DEPLOYMENT_ID 是部署 ID,即用户指定的名称。此 ID 必须满足以下要求:
    • 只能包含小写字母、数字或连字符。
    • 以小写字母开头。
    • 以数字或小写字母结尾
    • 不能是字符串 archived-deploymentsarchived-previews
    • 在运行 Infra Manager 的项目和位置中必须是唯一的。

例如:

projects/my-project/locations/us-central1/deployments/my-deployment

修订版本

修订版本是部署的版本。您最初创建的部署也是一个修订版本,其修订版本 ID 为 r-0

修订版本名称

创建 Infra Manager 部署时,系统会自动为其分配修订版本标识符 r-0。如果您更新部署,Infrastructure Manager 会创建一个标识符为 r-1 的新修订版本。每新增一个修订版本,标识符就会增加 1。修订版本标识符只能由 Infrastructure Manager 设置。

例如,修订版本名称可以是:

projects/my-project/locations/us-central1/deployments/my-deployment/revisions/r-1

预览

预览描述了用于实现特定 Terraform 配置的操作。 在创建新部署或更新部署之前,您可以预览部署,以验证计划配置的资源。

预览元数据

Infra Manager 会在运行 Infra Manager 的项目和位置中创建一个存储桶。预览版创建完毕后,Infra Manager 制品会位于以下名称的存储桶中:gs://PROJECT_NUMBER-LOCATION-blueprint-config

对于新部署的预览版,元数据以 new-previews 前缀开头,例如: gs://PROJECT_NUMBER-LOCATION-blueprint-config/new-previews/preview-name

您还可以预览对现有部署的更新。对于以现有部署为目标的这些预览版,工件会存储在与部署工件相同的存储桶中。名称为 gs://PROJECT_ID-LOCATION-blueprint-config/deployment-ID/previews/preview-ID 的存储桶。

Infrastructure Manager 使用术语蓝图来指代 Terraform 配置。

替换以下内容:

  • PROJECT_ID:运行 Infra Manager 的项目 ID。
  • LOCATION:运行 Infra Manager 的位置。

存储桶中的预览工件包括:

  • Cloud Build 日志。
  • Terraform 日志。
  • Terraform 配置的副本。

预览版名称

预览名称的格式为:

projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID

其中:

  • PROJECT_ID 是运行 Infra Manager 的项目 ID。
  • LOCATION 是 Infra Manager 的运行位置。如需查看有效位置的列表,请参阅Infrastructure Manager 位置
  • PREVIEW_ID 是预览标识符,也是用户指定的名称。此名称必须满足以下条件:
    • 只能包含小写字母、数字或连字符。
    • 以小写字母开头。
    • 以数字或小写字母结尾
    • 不能是字符串 archived-deploymentsarchived-previews
    • 在运行 Infra Manager 的项目和位置中必须是唯一的。

例如:

projects/my-project/locations/us-central1/previews/my-preview

后续步骤