選擇應用程式設定模型時,您會在管理專案中,為 App Hub 應用程式定義應用程式管理邊界。然後,您就可以在這個界線內的應用程式中註冊服務和工作負載。
如需導入應用程式管理實務的建議用途,請參閱「為應用程式管理做好準備」。如要建立應用程式及註冊資源,請參閱「將現有資源註冊至應用程式」。
為避免設定漂移並維持明確的可靠資料來源,建議您在原始定義應用程式元件的環境中管理這些元件:
從 Application Design Center 範本部署的應用程式: 使用 Application Design Center 管理及更新應用程式。 您可以修訂範本來變更應用程式設計,也可以建立應用程式修訂版本,更新應用程式和元件詳細資料等設定。
透過在 App Hub 註冊現有資源建立的應用程式: 直接在 App Hub 中管理應用程式、服務和工作負載。
本頁說明如何管理直接在 App Hub 中註冊的應用程式。您可以使用Google Cloud 控制台或 Google Cloud CLI 執行這些動作。如要瞭解從範本部署的應用程式,請參閱 App Design Center 說明文件。
事前準備
本文假設您已擁有向應用程式註冊的支援資源。
必要的角色
如要取得管理應用程式中應用程式所需的權限,請要求管理員在定義應用程式管理邊界的管理專案中,授予您下列 IAM 角色:
-
更新及刪除應用程式:
App Hub 編輯者 (
roles/apphub.editor) -
查看應用程式:
App Hub 檢視者 (
roles/apphub.viewer)
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
如要進一步瞭解 App Hub 角色,請參閱「App Hub 身分與存取權管理角色和權限」。
列出應用程式
請按照下列步驟,列出及篩選應用程式管理邊界內的所有應用程式:
控制台
在 Google Cloud 控制台,使用專案選擇工具選取管理專案。
從 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 控制台,使用專案選擇工具選取管理專案。
從 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 控制台,使用專案選擇工具選取管理專案。
從 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 控制台,使用專案選擇工具選取管理專案。
從 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 設定管理的所有資源,包括應用程式。