Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

管理应用

如果您想根据模板进行自定义和部署，请创建应用。例如，您可能会创建一个计划部署以进行测试的应用。您可能会创建另一个应用以用于生产。

创建应用时，您可以指定一些信息，以便根据应用的预期用途对其进行分类。这些信息有助于您过滤和查找特定应用。您还可以配置组件和连接详细信息。

本文档介绍了如何管理应用的生命周期。您将了解如何根据模板创建应用草稿、配置其组件、修改其底层 Terraform 代码、创建新修订版本，以及在不再需要该应用时将其删除。

准备工作

请让您的管理员为您授予已启用应用的文件夹或管理项目的以下角色之一：

App Design Center Admin (roles/designcenter.admin)。
Application Admin (roles/designcenter.applicationAdmin)。
Application Editor (roles/designcenter.applicationEditor)。

创建应用草稿

您可以根据模板创建应用草稿，方法是指定详细信息并选择性地替换组件配置。然后，您可以部署草稿以创建应用。

设计画布

在导航菜单中，执行以下任一操作：
- 如需查看在您的空间中创建的模板，请点击模板。
  
  前往模板
- 如需查看从其他空间共享的模板，请点击共享模板 。
  
  前往共享模板
点击要使用的模板 ID 。
在设计画布中，点击配置应用 。然后点击创建新应用 。
在应用名称区域中，执行以下操作来命名和描述您的应用：
1. 在名称字段中，输入此空间中的唯一标识符。例如，使用唯一的名称和环境组合，如 web-app-staging。此字段是必填字段。
  
  您最多可以使用 63 个字符，包括小写字母、数字和连字符。名称必须以小写字母开头，且不能以连字符结尾。名称无法更改。
2. 在显示名字段中，输入要在 Google Cloud 控制台中显示的名称。
3. 在说明字段中，输入此应用的用途。
如需为项目 ID 字段为空的任何组件设置默认项目，请从部署项目 列表中选择一个项目。该项目必须符合以下条件：
- 该项目必须是所选已启用应用的文件夹的后代。
- 该项目不得是管理项目。
如果组件的项目 ID 字段中已指定项目，则系统会使用该项目，而不是此设置。
从区域列表中，选择部署组件的区域。系统会根据以下条件应用组件区域：
- 如果应用范围是全球（默认），则该区域会应用于尚未配置区域的组件。
- 如果应用范围是区域级，则该区域会应用于所有组件。
从环境列表中，选择要部署此应用的环境。例如，您可能需要在 TEST 中验证部署是否按预期运行。

**注意**：如果您计划部署此应用并在稍后将其删除，请部署到 TEST、DEVELOPMENT 或 STAGING。
从严重性 列表中，选择对业务的影响程度。例如，LOW 或 HIGH。
如需指定所有者，请在所有者 区域中，点击添加所有者 ，然后为以下所有者输入显示名 和电子邮件地址 ：
- 在业务所有者 区域中，输入负责质量和用户期望的所有者。
- 在开发者所有者 区域中，输入负责开发和编码的所有者。
- 在运维人员所有者 区域中，输入负责运维应用的所有者。
从范围列表中，选择下列选项之一：
- 全球（默认）：应用包含全球性资源，或者资源位于多个区域中。
- 区域级：所有资源都位于单个区域中。
此字段是必填字段。如需了解详情，请参阅比较全球级应用和区域级应用。
点击创建应用 。应用详情会显示。

gcloud CLI

找到要用于创建应用的模板的应用模板修订版本 URI。
```
 gcloud design-center spaces application-templates describe APPLICATION_TEMPLATE \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE \
 --format='yaml(name,latestRevision)'
```
替换以下内容：
- APPLICATION_TEMPLATE：您要用作应用基础的应用模板的模板 ID。
- PROJECT：您的管理项目 ID。
- LOCATION：应用模板区域。
- SPACE：您的空间 ID。
如需了解详情，请参阅 gcloud design-center spaces application-templates describe。
复制 latestRevision 输出。
根据模板创建应用草稿。
```
  gcloud design-center spaces applications create APPLICATION \
  --project=PROJECT \
  --location=LOCATION \
  --space=SPACE \
  --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION \
  --scope-type=SCOPE_TYPE
```
替换以下内容：
- APPLICATION：您要创建的应用草稿的应用 ID。
- PROJECT：您的管理项目 ID。
- LOCATION：应用区域。
- SPACE：您的空间 ID。
- SOURCE_APPLICATION_TEMPLATE_REVISION：您的应用模板 URI。例如，projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISION
- SCOPE_TYPE：应用的范围。可以是 regional 或 global。如果应用范围是“global, the region is applied to components that don't already have a configured region. If the application scope isregional”，则该区域会应用于所有组件。
如需了解详情，请参阅 gcloud design-center spaces applications create。

配置组件和连接

对于应用中的每个组件，您可以指定配置详细信息，例如创建资源的项目的名称以及部署资源的位置。

如果默认配置不符合您的要求，您还可以修改连接详细信息。例如，您可以修改环境变量键名称、更改连接端口或向服务账号添加其他角色。

您必须为每个受支持的资源配置所需的详细信息。

如需配置组件和连接，请执行以下操作：

设计画布

在设计画布中，点击一个组件。
在配置区域中，从项目 ID 列表中，选择要部署资源的项目。选择符合以下条件的项目：
- 该项目必须是所选已启用应用的文件夹的后代。
- 该项目不得是管理项目。
为资源配置其他设置。例如，对于 Cloud SQL，您可以配置以下内容：
- 区域
- 备份配置
- 数据库标志
- IP 配置
如需查看指向每个组件的配置文档的链接，请参阅受支持的资源。
在设计画布上连接组件时，系统会使用默认配置值来创建连接。如需添加或修改连接详细信息，请执行以下操作。
1. 在设计画布中，点击两个组件之间的连接。系统会打开连接面板并显示连接参数。
2. 执行下列其中一项操作：
  - 如需修改现有连接参数，请点击修改。
  - 如需添加新的连接参数，请点击添加参数 。
3. 更新键和值字段。例如，您可能需要修改以下详细信息：
  - 环境变量键名称，以符合应用要求。
  - 连接端口值。
  - 添加到服务帐号的角色。
点击保存。

gcloud CLI

描述应用以查看组件参数，并确定应用的必需参数。
```
 gcloud design-center spaces applications describe APPLICATION \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE \
 --format='yaml(name,componentParameters)'
```
替换以下内容：
- APPLICATION：应用 ID。
- PROJECT：您的管理项目 ID。
- LOCATION：应用区域。
- SPACE：您的空间 ID。
如需了解详情，请参阅 gcloud design-center spaces applications describe。

对于要修改的每个组件，请在主目录中创建一个包含参数值的 JSON 文件。

例如，您可以为 Cloud Run 组件创建以下文件：

  {
    "component": "projects/PROJECT/locations/us-central1/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/components/COMPONENT",
    "parameters": [
       {
          "key": "service_name",
          "value": "frontend-service"
       },
       {
          "key": "project_id",
          "value": "DEPLOYMENT_PROJECT"
       }
    ]
  }

更新应用以配置必需的参数。
```
 gcloud design-center spaces applications update APPLICATION \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE \
 --component-parameters=COMPONENT_FILE_PATH_1
```
替换以下内容：
- APPLICATION：应用 ID。
- PROJECT：您的管理项目 ID。
- LOCATION：应用区域。
- SPACE：您的空间 ID。
- COMPONENT_FILE_PATH_1：包含组件参数的 JSON 文件。对于每个额外的 JSON 文件，请添加另一个 --component-parameter 实参和值。
如需了解详情，请参阅 gcloud design-center spaces applications update。

如需了解部署步骤，请参阅部署应用。

修改 Terraform 代码

您的应用会生成 Terraform 代码，以反映设计和配置详细信息。您可以修改 Terraform 代码，以指定组件配置详细信息。

系统会生成以下 Terraform 文件：

main.tf：基础架构代码，其中包含模板中每个组件的模块。
outputs.tf：公开有关已部署的基础架构组件的信息。
variables.tf：为 main.tf 文件中使用的变量声明名称、类型和说明。
input.tfvars：为 main.tf 文件中使用的变量定义值。
providers.tf：定义有助于 Terraform 与 Google Cloud API 和资源交互的标签。

如需了解背景信息，请参阅 Terraform on 概览 Google Cloud。

如需修改 Terraform 代码，请执行以下操作：

在设计画布中，点击代码。系统会显示生成的 Terraform 文件。
点击 main.tf 。系统会显示每个组件的 Terraform 模块。
修改配置详细信息。如需了解详情，请参阅每个受支持资源的配置文档。

系统会自动验证您的修改，如果修改无效，则会显示错误。
如需突出显示和比较您的修改，请执行以下操作：
1. 点击查看差异 。
2. 如需还原更改，请在边距中点击点击以还原更改 。
3. 点击查看差异 以关闭比较视图。
如需保存修改，请点击保存代码更改 。
如需验证更改，请执行以下操作。
1. 点击设计。
2. 点击一个组件并查看其配置详细信息。

创建应用修订版本

创建应用修订版本以修改详细信息或组件。如果您在 App Design Center 之外修改应用组件，则在重新部署时，这些更改不会保留。

如需创建应用修订版本，请执行以下操作：

设计画布

在导航菜单中，点击应用。

打开“应用”
在表格中，点击要修订的应用名称 。
如需修改应用详细信息，请执行以下操作：
点击修改并修改详细信息。
点击保存以保存更改。
如需修改此应用中的组件，请执行以下操作：
1. 在设计画布中点击该组件，然后在配置区域中修改详细信息。
2. 点击保存以保存更改。

gcloud CLI

请参阅配置组件和连接。

如需了解部署步骤，请参阅部署应用。

删除应用

如果您不再需要某个应用，可以将其删除。例如，您可能会部署一个应用以在 TEST 环境中验证模板，然后删除该应用。

您可以删除以下应用：

尚未部署的应用。在应用页面上，状态列为草稿。
已部署到 TEST、DEVELOPMENT 或 STAGING 环境的应用。

删除应用时，会发生以下情况：

应用详细信息会从 App Design Center 中移除。
底层 App Hub 应用会被删除。
如果您已部署，则资源会被删除。

如需删除应用，请执行以下操作：

设计画布

在导航菜单中，点击应用。

打开“应用”
在表格中，点击应用名称 。
点击操作，然后选择删除应用 。
在删除字段中，输入应用名称。
点击删除。

gcloud CLI

删除应用。

    gcloud design-center spaces applications delete APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE

替换以下内容：

APPLICATION：要删除的应用的应用 ID。
PROJECT：您的管理项目 ID。
LOCATION：应用区域。
SPACE：您的空间 ID。

如需了解详情，请参阅 gcloud design-center spaces applications delete。

后续步骤

使用以下方法之一部署应用：

部署应用。
下载并部署。

管理应用 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

准备工作

创建应用草稿

设计画布

gcloud CLI

配置组件和连接

设计画布

gcloud CLI

修改 Terraform 代码

创建应用修订版本

设计画布

gcloud CLI

删除应用

设计画布

gcloud CLI

后续步骤

管理应用