管理 App Hub 應用程式

設定 App Hub 時,您會為應用程式建立管理邊界。這個界線是管理專案,或是您為應用程式管理設定的主機和服務專案集合,視您的設定模型而定。服務和工作負載會在這個管理界線內註冊為應用程式

為避免設定漂移並維持明確的資訊來源,建議您在原始定義應用程式資源的環境中管理這些資源:

  • 從 Application Design Center 範本部署的應用程式: 使用 Application Design Center 管理及更新應用程式。 您可以修訂範本來變更應用程式設計,也可以建立應用程式修訂版本,更新應用程式和元件詳細資料等設定。

    前往 App Design Center

  • 透過在 App Hub 中註冊資源建立的應用程式:直接在 App Hub 中管理應用程式、服務和工作負載。

    前往 App Hub

本頁面說明如何管理直接在 App Hub 中註冊的應用程式。您可以使用 Google Cloud 控制台或 Google Cloud CLI 執行這些動作。如要瞭解如何從範本部署應用程式,請參閱 App Design Center 說明文件。

事前準備

如要在 App Hub 中列出、查看、更新及刪除應用程式,請先完成下列步驟:

  1. 使用其中一種支援的設定模型設定 App Hub
  2. 建立應用程式,並向要管理的應用程式註冊支援的資源

必要的角色

如要取得管理 App Hub 應用程式所需的權限,請管理員在設定模型 (管理專案或主機和服務專案) 的應用程式管理邊界,授予您下列 IAM 角色:

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

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

如要進一步瞭解 App Hub 角色,請參閱App Hub 身分與存取權管理角色和權限

列出應用程式

請按照下列步驟,列出及篩選 App Hub 管理邊界內的所有應用程式:

主控台

  1. 在 Google Cloud 控制台的「Welcome」頁面中,使用專案選擇工具選取管理專案或主專案:

    前往「歡迎」

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

    前往「Applications」(應用程式)

    這個頁面會顯示應用程式清單。

  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 控制台的「Welcome」頁面中,使用專案選擇工具選取管理專案或主專案:

    前往「歡迎」

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

    前往「Applications」(應用程式)

    這個頁面會顯示應用程式清單。

  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 控制台的「Welcome」頁面中,使用專案選擇工具選取管理專案或主專案:

    前往「歡迎」

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

    前往「Applications」(應用程式)

    這個頁面會顯示應用程式清單。

  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 控制台的「Welcome」頁面中,使用專案選擇工具選取管理專案或主專案:

    前往「歡迎」

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

    前往「Applications」(應用程式)

    這個頁面會顯示應用程式清單。

  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

後續步驟