修改已啟用應用程式的資料夾中的 App Hub 資源

您可以在啟用應用程式的資料夾中，使用 Google Cloud 控制台或 Google Cloud CLI (位於終端機或 Cloud Shell 中)，列出、查看、更新及刪除 App Hub 資源。

必要條件

修改 App Hub 資源前，請先完成下列工作：

  1. 按照先決條件設定應用程式中心。
  2. 視要修改的資源類型而定，請確保已執行設定 App Hub 的步驟。詳情請參閱「設定 App Hub」。

必要的角色

如要取得修改 App Hub 資源所需的權限，請管理員在啟用應用程式的資料夾中，授予下列 IAM 角色：

  • 如要建立及更新應用程式、註冊及取消註冊服務和工作負載，以及更新相關聯的屬性：
  • 如要查看應用程式、服務和工作負載及其屬性： App Hub 檢視者 (roles/apphub.viewer)
  • 如要查看應用程式、服務和工作負載，以及支援應用程式管理的服務屬性，請執行下列操作： App Hub 管理檢視者 (roles/apphub.appManagementViewer) Google Cloud

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

您或許還可透過自訂角色或其他預先定義的角色取得必要權限。

列出應用程式

您可以在啟用應用程式的資料夾中列出及篩選應用程式。

控制台

  1. 如要在啟用應用程式的資料夾中查看應用程式，請前往Google Cloud 控制台的 App Hub「應用程式」頁面。

    前往「Applications」(應用程式)

    系統隨即會顯示應用程式清單。

  2. 如要篩選應用程式，請按照下列步驟操作：

    1. 在「篩選器」欄位中，選取篩選器，例如「嚴重程度」。
    2. 指定篩選器的值。舉例來說，如要顯示高重要性的應用程式，請選取「高」做為值。
      系統會顯示符合指定篩選條件的應用程式清單。

gcloud

  1. 如要查看已啟用應用程式管理功能的資料夾中的應用程式，請按照下列步驟操作：

    gcloud apphub applications list \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    更改下列內容：

    • MANAGEMENT_PROJECT_ID：管理專案的 ID。您可以在 Google Cloud 控制台的「Identity and Access Management (IAM) & Admin Settings」(身分與存取管理 (IAM) 與管理設定) 頁面中，找到管理專案 ID。如果找不到管理專案 ID，可能是因為您不在已啟用應用程式的資料夾中。從範圍挑選器 (或專案選取器) 中，選取已啟用應用程式的資料夾。如要進一步瞭解如何為資料夾啟用應用程式管理功能，請參閱「啟用應用程式管理功能」。
    • REGION：應用程式的區域。視應用程式的 --scope-type 而定，請將此值設為 global 或應用程式的地區，例如 us-east1。如要進一步瞭解如何為應用程式設定 --scope-type，請參閱「建立應用程式」。

  2. 如要根據變數屬性篩選應用程式，請使用 --filter 旗標。舉例來說，如要列出 environment-type 屬性設為 PRODUCTION 的所有應用程式，請執行下列指令：

    gcloud apphub applications list \
    --filter='attributes.environment.type=PRODUCTION' \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

查看應用程式

您可以在已啟用應用程式管理功能的資料夾中描述應用程式。

控制台

  1. 前往 Google Cloud 控制台的 App Hub「Applications」頁面。

    前往「Applications」(應用程式)

  2. 在應用程式清單中，按一下要查看詳細資料的應用程式。

  3. 按一下「詳細資料」分頁標籤，顯示應用程式詳細資料。

gcloud

gcloud apphub applications describe APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

將 APPLICATION_NAME 換成應用程式名稱。名稱只能包含小寫英數字元，且不得有空格。

更新 App Hub 應用程式

應用程式建立後，您可以更新應用程式的屬性。

控制台

  1. 前往 Google Cloud 控制台的 App Hub「Applications」頁面。

    前往「Applications」(應用程式)

  2. 在應用程式清單中，找出要更新的應用程式，然後按一下「編輯」。

  3. 視需要編輯欄位。

  4. 按一下 [儲存]。

gcloud

  1. 使用 criticality-type、environment-type 和擁有者類型屬性更新應用程式：

    gcloud apphub applications update APPLICATION_NAME \
    --display-name='APPLICATION_DISPLAY_NAME' \
    --criticality-type='CRITICALITY_LEVEL' \
    --environment-type='ENVIRONMENT' \
    --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
    --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
    --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    更改下列內容：

    • APPLICATION_NAME：應用程式名稱。 名稱只能包含小寫英數字元，且不得有空格。
    • REGION：應用程式的區域。

    你可以更新下列任何資訊：

    • APPLICATION_DISPLAY_NAME：表示應用程式的顯示名稱。
    • CRITICALITY_LEVEL：指出應用程式、服務或工作負載對業務營運的重要性。請提供下列其中一個值：
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT：表示軟體生命週期的階段。請提供下列其中一個值：
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER、DISPLAY-NAME-OPERATOR 和 DISPLAY-NAME-BUSINESS：分別是開發人員、營運者和企業主的顯示名稱。
    • EMAIL-NAME-DEVELOPER、 EMAIL-NAME-OPERATOR 和 EMAIL-NAME-BUSINESS：分別是開發人員、營運人員和企業主的電子郵件地址。這些值必須採用 username@yourdomain 格式，例如 222larabrown@gmail.com。

    例如：

    gcloud apphub applications update my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --project=google-mpf-FOLDER-ID \
    --location=us-east1

查看服務和工作負載

您可以查看、列出及篩選應用程式中的服務和工作負載。

控制台

  1. 如要列出服務和工作負載：

    1. 前往 Google Cloud 控制台的「App Hub」頁面。

      前往「服務和工作負載」

    2. 在「Region」(區域) 清單中，選取要查看服務和工作負載的區域。例如選取 us-east1。
      「Services and Workloads」(服務和工作負載) 頁面會顯示與 us-east1 相關聯的附加服務專案中，所有服務和工作負載。

  2. 如要篩選服務或工作負載：

    1. 在「Filter」(篩選器) 欄位中，選取「Environment」(環境) 等篩選器。
    2. 指定篩選器的值。舉例來說，如要查看正式環境中的服務和工作負載，請選取「Production」做為值。
      畫面會顯示符合指定篩選條件的服務和工作負載清單。

gcloud

列出探索到的服務

您可以將探索到的服務註冊至應用程式。

  1. 如要列出探索到的服務：

    gcloud apphub discovered-services list \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    畫面會顯示類似以下內容的輸出：

    ID                      SERVICE_REFERENCE                                                                                                                   SERVICE_PROPERTIES
[DISCOVERED_SERVICE_ID] {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}

  2. 選用：篩選探索到的服務清單。舉例來說，如要篩選應用程式啟用資料夾中具有轉送規則的探索服務，請執行下列操作：

    gcloud apphub discovered-services list \
    --filter='service_reference.uri~"forwardingRules"' \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

列出已註冊的服務

從應用程式列出及篩選已註冊的 App Hub 服務。

  1. 如要列出應用程式中已註冊的服務：

    gcloud apphub applications services list \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    畫面會顯示類似以下內容的輸出：

    ID             DISPLAY_NAME            SERVICE_REFERENCE                                                                                                                CREATE_TIME
SERVICE_NAME   mywebserver-service1    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule'}   2023-11-01T21:38:08

    已註冊但已分離的服務會在 SERVICE_REFERENCE 欄位中以空白值表示。

  2. 選用：篩選已註冊的服務清單。舉例來說，如要篩選應用程式中 environment-type 屬性設為 PRODUCTION 的已註冊服務，請按照下列步驟操作：

    gcloud apphub applications services list \
    --filter='attributes.environment.type=PRODUCTION' \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

列出已探索的工作負載

您可以向應用程式註冊已探索的工作負載。

  1. 如要列出探索到的工作負載，請執行下列步驟：

    gcloud apphub discovered-workloads list \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    畫面會顯示類似以下的輸出內容，包括未註冊的 MIG：

    ID                        WORKLOAD_REFERENCE                                                                                                   WORKLOAD_PROPERTIES
[DISCOVERED_WORKLOAD_ID]  {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}

  2. 選用：篩選探索到的工作負載清單。舉例來說，如要篩選出應用程式已啟用資料夾中具有運算資源的探索工作負載清單，請執行下列步驟：

    gcloud apphub discovered-workloads list \
    --filter='workload_reference.uri~"compute"'
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

列出已註冊的工作負載

列出及篩選應用程式中已註冊的 App Hub 工作負載。

  1. 如要列出應用程式中已註冊的工作負載：

    gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    畫面會顯示類似以下內容的輸出：

    ID               DISPLAY_NAME               WORKLOAD_REFERENCE                                                                                                     CREATE_TIME
WORKLOAD_NAME    mywebserver-deployment1    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'}    2023-10-31T18:34:23

    已註冊但已分離的工作負載，會在 WORKLOAD_REFERENCE 欄位中以空值表示。如要進一步瞭解註冊狀態，請參閱「App Hub 的屬性和屬性」。

  2. 選用：篩選已註冊的工作負載清單。舉例來說，如要篩選應用程式中 environment-type 屬性設為 PRODUCTION 的工作負載，請執行下列步驟：

    gcloud apphub applications workloads list \
    --filter='attributes.environment.type=PRODUCTION' \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

更新服務和工作負載

您可以更新向應用程式註冊的服務和工作負載。

控制台

  1. 前往 Google Cloud 控制台的 App Hub「Applications」頁面。

    前往「Applications」(應用程式)

  2. 按一下應用程式名稱。
    系統會顯示「服務和工作負載」分頁，其中列出服務專案中已註冊的服務和工作負載。

  3. 如要更新服務或工作負載，請執行下列操作：

    1. 在「服務和工作負載」分頁中，找到要更新的服務或工作負載，按一下 more_vert，然後點選「編輯服務」或「編輯工作負載」。
    2. 在「編輯服務」或「編輯工作負載」窗格中，視需要編輯欄位，然後按一下「儲存」。

gcloud

  1. 使用 criticality-type、environment-type 和擁有者類型屬性更新服務：

    gcloud apphub applications services update SERVICE_NAME \
    --application=APPLICATION_NAME \
    --display-name='SERVICE_DISPLAY_NAME' \
    --criticality-type='CRITICALITY_LEVEL' \
    --environment-type='ENVIRONMENT' \
    --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
    --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
    --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    將 SERVICE_NAME 改為 App Hub 服務的名稱。

    你可以更新下列任何資訊：

    • SERVICE_DISPLAY_NAME：表示服務的顯示名稱。
    • CRITICALITY_LEVEL：指出應用程式、服務或工作負載對業務營運的重要性。請提供下列其中一個值：
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT：表示軟體生命週期的階段。請提供下列其中一個值：
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER、DISPLAY-NAME-OPERATOR 和 DISPLAY-NAME-BUSINESS：分別是開發人員、營運者和企業主的顯示名稱。
    • EMAIL-NAME-DEVELOPER、 EMAIL-NAME-OPERATOR 和 EMAIL-NAME-BUSINESS：分別是開發人員、營運人員和企業主的電子郵件地址。這些值必須採用 username@yourdomain 格式，例如 222larabrown@gmail.com。

    例如：

    gcloud apphub applications workloads update my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --project=google-mpf-FOLDER-ID \
    --location=us-east1

  2. 使用 criticality-type、environment-type 和擁有者類型屬性更新工作負載：

    gcloud apphub applications workloads update WORKLOAD_NAME \
    --application=APPLICATION_NAME \
    --display-name='WORKLOAD_DISPLAY_NAME' \
    --criticality-type='CRITICALITY_LEVEL' \
    --environment-type='ENVIRONMENT' \
    --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
    --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
    --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    將 WORKLOAD_NAME 替換為 App Hub 工作負載的名稱。

    你可以更新下列任何資訊：

    • WORKLOAD_DISPLAY_NAME：表示服務的顯示名稱。
    • CRITICALITY_LEVEL：指出應用程式、服務或工作負載對業務營運的重要性。請提供下列其中一個值：
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT：表示軟體生命週期的階段。請提供下列其中一個值：
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER、DISPLAY-NAME-OPERATOR 和 DISPLAY-NAME-BUSINESS：分別是開發人員、營運者和企業主的顯示名稱。
    • EMAIL-NAME-DEVELOPER、 EMAIL-NAME-OPERATOR 和 EMAIL-NAME-BUSINESS：分別是開發人員、營運人員和企業主的電子郵件地址。這些值必須採用 username@yourdomain 格式，例如 222larabrown@gmail.com。

    例如：

    gcloud apphub applications workloads update my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --project=google-mpf-FOLDER-ID \
    --location=us-east1

刪除應用程式、服務和工作負載

刪除現有應用程式，移除與啟用應用程式的資料夾相關聯的已註冊資源。如要刪除應用程式，請先取消註冊應用程式的服務和工作負載。

控制台

  1. 前往 Google Cloud 控制台的 App Hub「Applications」頁面。

    前往「Applications」(應用程式)

  2. 按一下應用程式名稱。 系統會顯示已向應用程式註冊的服務和工作負載清單。

  3. 取消註冊服務或工作負載。

    1. 在「服務和工作負載」分頁的「已註冊的服務和工作負載」部分，按一下要取消註冊的服務或工作負載名稱。
    2. 在開啟的已註冊服務或工作負載頁面中，按一下「取消註冊」，將服務或工作負載更新為「已發現」資源。在「服務和工作負載」分頁中，系統會顯示工作負載已取消註冊的警示。
    3. 針對每項服務和工作負載重複執行這些操作說明。

  4. 前往 App Hub 的「Applications」(應用程式) 頁面。

    前往「Applications」(應用程式)

  5. 按一下應用程式名稱。

  6. 在應用程式詳細資料頁面中，按一下「刪除」。

gcloud

  1. 列出應用程式中已註冊的服務：

    gcloud apphub applications services list \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

  2. 從應用程式取消註冊服務：

    gcloud apphub applications services delete SERVICE_NAME \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    這項服務現在是可供探索的服務，可以註冊至應用程式。

  3. 重複執行上一個指令，從應用程式取消註冊所有剩餘的已註冊服務。

  4. 列出應用程式中已註冊的工作負載：

    gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

  5. 從應用程式取消註冊工作負載：

    gcloud apphub applications workloads delete WORKLOAD_NAME \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    工作負載現在是可向應用程式註冊的已發現工作負載。

  6. 重複執行上一個指令，從應用程式中刪除所有剩餘的已註冊工作負載。

  7. 刪除應用程式：

    gcloud apphub applications delete APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

後續步驟