设置 App Hub 时,您会为应用创建管理边界。此边界可以是管理项目,也可以是您为应用管理配置的宿主项目和服务项目的集合,具体取决于您的设置模式。服务和工作负载在此管理边界内注册为应用。
为避免配置漂移并保持清晰的可靠来源,我们建议您在最初定义应用资源的环境中管理这些资源:
对于根据 App Design Center 模板部署的应用:请使用 App Design Center 管理和更新应用。 您可以修改模板以更改应用设计,也可以创建应用修订版本来更新应用和组件详细信息等设置。
对于通过在 App Hub 中注册资源创建的应用:直接在 App Hub 中管理应用、其服务和工作负载。
本页介绍了如何管理直接在 App Hub 中注册的应用。您可以使用 Google Cloud 控制台或 Google Cloud CLI 执行这些操作。对于从模板部署的应用,请参阅 Application Design Center 文档。
准备工作
在 App Hub 中列出、查看、更新和删除应用之前,请完成以下步骤:
- 使用其中一种受支持的设置模式设置 App Hub。
- 创建应用,并将要管理的受支持资源注册到该应用。
所需的角色
如需获得管理 App Hub 中的应用所需的权限,请让管理员向您授予设置模型(管理项目或宿主项目和服务项目)中应用管理边界的以下 IAM 角色:
-
更新和删除应用:
App Hub Editor (
roles/apphub.editor
) -
查看应用:App Hub Viewer (
roles/apphub.viewer
)
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
如需详细了解 App Hub 角色,请参阅 App Hub IAM 角色和权限。
列出应用
如需列出和过滤 App Hub 管理边界内的所有应用,请按以下步骤操作:
控制台
gcloud
使用以下任一选项显示您的应用列表:
列出所有应用:
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
。
查看应用详情
如需查看特定应用的详细信息(包括其属性和元数据),请按以下步骤操作:
控制台
gcloud
描述应用:
gcloud apphub applications describe APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION
替换以下内容:
APPLICATION_NAME
:应用的名称。您可以在创建应用时指定此值。PROJECT_ID
:宿主项目或管理项目的 ID。LOCATION
:应用的位置。对于全球应用,请使用global
;对于区域级应用,请使用特定区域,例如us-east1
。
更新应用属性
如需在创建应用后修改其用户定义的属性,请按以下步骤操作:
控制台
gcloud
更新应用属性。您可以更新任何可变属性,例如
display-name
、criticality-type
、environment-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_NAME
和DEV_EMAIL
:开发者所有者的显示名称和电子邮件地址(分别)。可选:
OPERATOR_NAME
和OPERATOR_EMAIL
:分别是运营商所有者的显示名称和电子邮件地址。可选:
BUSINESS_NAME
和BUSINESS_EMAIL
:商家所有者的显示名称和电子邮件地址(分别)。
- 必需:
删除应用
在删除应用之前,您必须先取消注册其所有关联的服务和工作负载。然后,按照以下步骤删除应用:
控制台
在 Google Cloud 控制台的欢迎页面中,使用项目选择器选择您的管理项目或宿主项目:
前往 App Hub 应用页面:
该页面会显示您的申请列表。
点击要删除的应用的名称。
前往服务和工作负载标签页,确保您已取消注册所有与应用关联的资源。如需了解详情,请参阅取消注册服务和工作负载。
取消注册所有服务和工作负载后,返回到应用详情,然后点击删除。
gcloud
确保您已取消注册应用的所有关联资源。如需了解详情,请参阅取消注册服务和工作负载。
当应用没有已注册的资源时,请将其删除:
gcloud apphub applications delete APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION
替换以下内容:
APPLICATION_NAME
:应用的名称。您可以在创建应用时指定此值。PROJECT_ID
:宿主项目或管理项目的 ID。LOCATION
:应用的位置。对于全球应用,请使用global
;对于区域级应用,请使用特定区域,例如us-east1
。