管理 App Hub 应用

设置 App Hub 时,您会为应用创建管理边界。此边界可以是管理项目,也可以是您为应用管理配置的宿主项目和服务项目的集合,具体取决于您的设置模式。服务和工作负载在此管理边界内注册为应用

为避免配置漂移并保持清晰的可靠来源,我们建议您在最初定义应用资源的环境中管理这些资源:

  • 对于根据 App Design Center 模板部署的应用:请使用 App Design Center 管理和更新应用。 您可以修改模板以更改应用设计,也可以创建应用修订版本来更新应用和组件详细信息等设置。

    前往 App Design Center

  • 对于通过在 App Hub 中注册资源创建的应用:直接在 App Hub 中管理应用、其服务和工作负载。

    前往 App Hub

本页介绍了如何管理直接在 App Hub 中注册的应用。您可以使用 Google Cloud 控制台或 Google Cloud CLI 执行这些操作。对于从模板部署的应用,请参阅 Application Design Center 文档。

准备工作

在 App Hub 中列出、查看、更新和删除应用之前,请完成以下步骤:

  1. 使用其中一种受支持的设置模式设置 App Hub
  2. 创建应用,并将要管理的受支持资源注册到该应用

所需的角色

如需获得管理 App Hub 中的应用所需的权限,请让管理员向您授予设置模型(管理项目或宿主项目和服务项目)中应用管理边界的以下 IAM 角色:

如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

如需详细了解 App Hub 角色,请参阅 App Hub IAM 角色和权限

列出应用

如需列出和过滤 App Hub 管理边界内的所有应用,请按以下步骤操作:

控制台

  1. 在 Google Cloud 控制台的欢迎页面中,使用项目选择器选择您的管理项目或宿主项目:

    前往“欢迎”页面

  2. 前往 App Hub 应用页面:

    打开“应用”

    该页面会显示您的申请列表。

  3. 如需过滤列表,请使用过滤条件字段。您可以按严重程度环境等属性进行过滤。

gcloud

  1. 查找管理项目或宿主项目的项目 ID

  2. 使用以下任一选项显示您的应用列表:

    • 列出所有应用:

      gcloud apphub applications list \
          --project=PROJECT_ID \
          --location=LOCATION
      

      替换以下内容:

      • PROJECT_ID:宿主项目或管理项目的 ID。
      • LOCATION:应用的位置。对于全球应用,请使用 global;对于区域级应用,请使用特定区域,例如 us-east1
    • 使用 --filter 标志根据属性过滤应用列表:

      gcloud apphub applications list \
          --project=PROJECT_ID \
          --location=LOCATION \
          --filter=FILTER_EXPRESSION \
      

      替换以下内容:

      • PROJECT_ID:宿主项目或管理项目的 ID。
      • LOCATION:应用的位置。对于全球应用,请使用 global;对于区域级应用,请使用特定区域,例如 us-east1
      • FILTER_EXPRESSION:用于指定属性的过滤表达式。例如,如需列出所有具有 PRODUCTION 环境类型的应用,请使用 attributes.environment.type=PRODUCTION

查看应用详情

如需查看特定应用的详细信息(包括其属性和元数据),请按以下步骤操作:

控制台

  1. 在 Google Cloud 控制台的欢迎页面中,使用项目选择器选择您的管理项目或宿主项目:

    前往“欢迎”页面

  2. 前往 App Hub 应用页面:

    打开“应用”

    该页面会显示您的申请列表。

  3. 点击要查看的应用的名称。

    系统会显示应用的详细信息标签页。

gcloud

  1. 查找管理项目或宿主项目的项目 ID

  2. 描述应用:

    gcloud apphub applications describe APPLICATION_NAME \
        --project=PROJECT_ID \
        --location=LOCATION
    

    替换以下内容:

    • APPLICATION_NAME:应用的名称。您可以在创建应用时指定此值。
    • PROJECT_ID:宿主项目或管理项目的 ID。
    • LOCATION:应用的位置。对于全球应用,请使用 global;对于区域级应用,请使用特定区域,例如 us-east1

更新应用属性

如需在创建应用后修改其用户定义的属性,请按以下步骤操作:

控制台

  1. 在 Google Cloud 控制台的欢迎页面中,使用项目选择器选择您的管理项目或宿主项目:

    前往“欢迎”页面

  2. 前往 App Hub 应用页面:

    打开“应用”

    该页面会显示您的申请列表。

  3. 对于要更新的应用,点击 修改

  4. 修改应用窗格中,根据需要修改字段。

  5. 点击保存

gcloud

  1. 查找管理项目或宿主项目的项目 ID

  2. 更新应用属性。您可以更新任何可变属性,例如 display-namecriticality-typeenvironment-type 和所有者:

    gcloud apphub applications update APPLICATION_NAME \
        --project=PROJECT_ID \
        --location=LOCATION \
        --display-name=DISPLAY_NAME \
        --criticality-type=CRITICALITY_LEVEL \
        --environment-type=ENVIRONMENT \
        --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
        --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
        --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL
    

    替换以下内容:

    • 必需:APPLICATION_NAME:应用的名称。您可以在创建应用时指定此值。
    • 必需:PROJECT_ID:宿主项目或管理项目的 ID。
    • 必需:LOCATION:应用的位置。对于全球应用,请使用 global;对于区域级应用,请使用特定区域,例如 us-east1
    • 可选:DISPLAY_NAME:应用的显示名称。
    • 可选:CRITICALITY_LEVEL:应用的优先级。请使用以下某个值:

      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • 可选:ENVIRONMENT:软件生命周期的阶段。请使用以下某个值:

      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • 可选:DEV_NAMEDEV_EMAIL:开发者所有者的显示名称和电子邮件地址(分别)。

    • 可选:OPERATOR_NAMEOPERATOR_EMAIL:分别是运营商所有者的显示名称和电子邮件地址。

    • 可选:BUSINESS_NAMEBUSINESS_EMAIL:商家所有者的显示名称和电子邮件地址(分别)。

删除应用

在删除应用之前,您必须先取消注册其所有关联的服务和工作负载。然后,按照以下步骤删除应用:

控制台

  1. 在 Google Cloud 控制台的欢迎页面中,使用项目选择器选择您的管理项目或宿主项目:

    前往“欢迎”页面

  2. 前往 App Hub 应用页面:

    打开“应用”

    该页面会显示您的申请列表。

  3. 点击要删除的应用的名称。

  4. 前往服务和工作负载标签页,确保您已取消注册所有与应用关联的资源。如需了解详情,请参阅取消注册服务和工作负载

  5. 取消注册所有服务和工作负载后,返回到应用详情,然后点击删除

gcloud

  1. 查找管理项目或宿主项目的项目 ID

  2. 确保您已取消注册应用的所有关联资源。如需了解详情,请参阅取消注册服务和工作负载

  3. 当应用没有已注册的资源时,请将其删除:

    gcloud apphub applications delete APPLICATION_NAME \
        --project=PROJECT_ID \
        --location=LOCATION
    

    替换以下内容:

    • APPLICATION_NAME:应用的名称。您可以在创建应用时指定此值。
    • PROJECT_ID:宿主项目或管理项目的 ID。
    • LOCATION:应用的位置。对于全球应用,请使用 global;对于区域级应用,请使用特定区域,例如 us-east1

后续步骤