設定 App Hub 時，您會為應用程式建立管理邊界。這個界線是管理專案，或是您為應用程式管理設定的主機和服務專案集合，視您的設定模型而定。服務和工作負載會在這個管理界線內註冊為應用程式。
為避免設定漂移並維持明確的資訊來源，建議您在原始定義應用程式資源的環境中管理這些資源：
從 Application Design Center 範本部署的應用程式： 使用 Application Design Center 管理及更新應用程式。 您可以修訂範本來變更應用程式設計，也可以建立應用程式修訂版本，更新應用程式和元件詳細資料等設定。
透過在 App Hub 中註冊資源建立的應用程式：直接在 App Hub 中管理應用程式、服務和工作負載。
本頁面說明如何管理直接在 App Hub 中註冊的應用程式。您可以使用 Google Cloud 控制台或 Google Cloud CLI 執行這些動作。如要瞭解從範本部署的應用程式，請參閱應用程式設計中心說明文件。
事前準備
如要在 App Hub 中列出、查看、更新及刪除應用程式，請先完成下列步驟：
- 使用其中一種支援的設定模型設定 App Hub。
- 建立應用程式，並向要管理的應用程式註冊支援的資源。
必要的角色
如要取得管理 App Hub 應用程式所需的權限，請管理員在設定模型 (管理專案或主機和服務專案) 的應用程式管理邊界，授予您下列 IAM 角色：
-
更新及刪除應用程式：
App Hub 編輯者 (
roles/apphub.editor) -
查看應用程式：
App Hub 檢視者 (
roles/apphub.viewer)
如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。
如要進一步瞭解 App Hub 角色，請參閱App Hub 身分與存取權管理角色和權限。
列出應用程式
請按照下列步驟，列出及篩選 App Hub 管理邊界內的所有應用程式：
主控台
在 Google Cloud 控制台的「Welcome」頁面中，使用專案選擇工具選取管理專案或主專案：
前往 App Hub 的「Applications」(應用程式) 頁面：
這個頁面會顯示應用程式清單。
如要篩選清單，請使用「篩選」欄位。您可以依重要性或環境等屬性進行篩選。
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。
查看應用程式詳細資料
如要查看特定應用程式的詳細資訊 (包括屬性和中繼資料)，請按照下列步驟操作：
主控台
在 Google Cloud 控制台的「Welcome」頁面中，使用專案選擇工具選取管理專案或主專案：
前往 App Hub 的「Applications」(應用程式) 頁面：
這個頁面會顯示應用程式清單。
按一下要查看的應用程式名稱。
系統會顯示應用程式的「詳細資料」分頁。
gcloud
描述應用程式：
gcloud apphub applications describe APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION更改下列內容：
APPLICATION_NAME：應用程式名稱。您可以在建立應用程式時指定這個值。PROJECT_ID：主專案或管理專案的 ID。LOCATION：應用程式的位置。全域應用程式請使用global，區域應用程式則使用特定區域，例如us-east1。
更新應用程式屬性
如要在應用程式建立後修改使用者定義的屬性，請按照下列步驟操作：
主控台
在 Google Cloud 控制台的「Welcome」頁面中，使用專案選擇工具選取管理專案或主專案：
前往 App Hub 的「Applications」(應用程式) 頁面：
這個頁面會顯示應用程式清單。
找到要更新的應用程式，然後按一下「編輯」。
在「編輯應用程式」窗格中，視需要修改欄位。
按一下 [儲存]。
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_CRITICALHIGHMEDIUMLOW
選用：
ENVIRONMENT：軟體生命週期的階段。請使用下列其中一個值：PRODUCTIONSTAGINGDEVELOPMENTTEST
選用：
DEV_NAME和DEV_EMAIL：分別是開發人員擁有者的顯示名稱和電子郵件地址。選用：
OPERATOR_NAME和OPERATOR_EMAIL分別是營運商擁有者的顯示名稱和電子郵件地址。選用：
BUSINESS_NAME和BUSINESS_EMAIL分別是企業主的顯示名稱和電子郵件地址。
- 必要：
Terraform
如要使用 Terraform 更新應用程式屬性，請修改設定檔中google_apphub_application 資源區塊內的引數。套用變更後，Terraform 會更新應用程式，使其符合新設定。
下列範例會更新 us-central1 中區域應用程式的重要性與環境屬性：
resource "google_apphub_application" "example" {
project = "my-project-id"
location = "us-central1"
application_id = "my-application"
display_name = "My Application"
description = "This application represents our platform."
attributes {
criticality {
type = "HIGH" # Updated criticality
}
environment {
type = "PRODUCTION"
}
# ... other attributes
}
}
刪除應用程式
如要刪除應用程式，請先取消註冊所有相關聯的服務和工作負載。然後按照下列步驟刪除應用程式：
主控台
在 Google Cloud 控制台的「Welcome」頁面中，使用專案選擇工具選取管理專案或主專案：
前往 App Hub 的「Applications」(應用程式) 頁面：
這個頁面會顯示應用程式清單。
按一下要刪除的應用程式名稱。
前往「服務和工作負載」分頁，確認您已取消註冊所有與應用程式相關聯的資源。詳情請參閱「取消註冊服務和工作負載」。
取消註冊所有服務和工作負載後，返回應用程式詳細資料頁面，然後按一下「刪除」。
gcloud
請確認您已取消註冊應用程式的所有相關資源。詳情請參閱「取消註冊服務和工作負載」。
應用程式沒有已註冊的資源後，請刪除應用程式：
gcloud apphub applications delete APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION更改下列內容：
APPLICATION_NAME：應用程式名稱。您可以在建立應用程式時指定這個值。PROJECT_ID：主專案或管理專案的 ID。LOCATION：應用程式的位置。全域應用程式請使用global，區域應用程式則使用特定區域，例如us-east1。
Terraform
如要刪除由 Terraform 管理的應用程式，可以選擇下列做法：
- 從設定中移除資源：從 Terraform 檔案中刪除
google_apphub_application資源區塊，然後執行terraform apply。Terraform 會辨識出資源已不在設定中，並從專案中刪除該資源。 - 終止所有資源：執行
terraform destroy指令，終止 Terraform 設定管理的所有資源，包括應用程式。