管理 App Hub 應用程式

App Hub 可讓您查看已註冊的應用程式、更新其屬性,以及刪除應用程式,以便準確掌握應用程式。為避免設定偏移,請只使用 App Hub 更新或刪除直接註冊的應用程式,並在 Application Design Center 中根據範本管理應用程式。

總覽

選擇應用程式設定模型時,您會在管理專案中,為 App Hub 應用程式定義應用程式管理邊界。接著,您可以在這個邊界內的應用程式中註冊服務和工作負載。

如需導入應用程式管理做法的建議用途,請參閱「準備應用程式管理」。如要建立應用程式並註冊資源,請參閱「將現有資源註冊至應用程式」。

為避免設定偏移並維持明確的可靠資料來源,建議您在最初定義應用程式元件的環境中管理這些元件:

在 App Hub 中,您可以使用Google Cloud 控制台或 Google Cloud CLI 執行這些動作。如果是從範本部署的應用程式,請參閱 Application Design Center 說明文件。

事前準備

本文假設您已建立應用程式,並註冊支援的資源。

必要的角色

如要取得在 App Hub 管理應用程式所需的權限,請要求管理員在定義應用程式管理邊界的管理專案中,授予您下列 IAM 角色:

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

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

如要進一步瞭解 App Hub 角色,請參閱「App Hub IAM 角色和權限」。

列出應用程式

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

控制台

  1. 在 Google Cloud 控制台,使用專案挑選器選取管理專案。

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

    前往「Applications」(應用程式)

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

  3. 如要篩選清單,請使用「Filter」(篩選器) 欄位。您可以依「Criticality」(重要性) 或「Environment」(環境) 等屬性篩選。

gcloud

  1. 找出管理專案的專案 ID。

  2. 使用下列其中一個選項,顯示應用程式清單:

    • 列出所有應用程式:

      gcloud apphub applications list \
          --project=PROJECT_ID \
          --location=LOCATION
      

      更改下列內容:

      • PROJECT_ID:管理專案的 ID。
      • LOCATION:應用程式的位置。如果是全球性應用程式,請使用 global;如果是多區域應用程式,請使用多區域 (us 或 eu);如果是區域性應用程式,請使用特定區域,例如 us-east1。
    • 使用 --filter 旗標,依據屬性篩選應用程式清單:

      gcloud apphub applications list \
          --project=PROJECT_ID \
          --location=LOCATION \
          --filter=FILTER_EXPRESSION \
      

      更改下列內容:

      • PROJECT_ID:管理專案的 ID。
      • LOCATION:應用程式的位置。如果是全球性應用程式,請使用 global;如果是多區域應用程式,請使用多區域 (us 或 eu);如果是區域性應用程式,請使用特定區域,例如 us-east1。
      • FILTER_EXPRESSION:指定屬性的篩選運算式。例如,如要列出環境類型為 PRODUCTION 的所有應用程式,請使用 attributes.environment.type=PRODUCTION。

查看應用程式詳細資料

如要查看特定應用程式的詳細資訊 (包括屬性和中繼資料),請按照下列步驟操作:

控制台

  1. 在 Google Cloud 控制台,使用專案挑選器選取管理專案。

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

    前往「Applications」(應用程式)

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

  3. 按一下要查看的應用程式名稱。

    系統會顯示應用程式的「Details」(詳細資料) 分頁。

gcloud

  1. 找出管理專案的專案 ID。

  2. 說明應用程式:

    gcloud apphub applications describe APPLICATION_NAME \
        --project=PROJECT_ID \
        --location=LOCATION
    

    更改下列內容:

    • APPLICATION_NAME:應用程式名稱。您可以在建立應用程式時指定這個值。
    • PROJECT_ID:管理專案的 ID。
    • LOCATION:應用程式的位置。如果是全球性應用程式,請使用 global;如果是多區域應用程式,請使用多區域 (us 或 eu);如果是區域性應用程式,請使用特定區域,例如 us-east1。

更新應用程式屬性

如要在建立應用程式後修改其屬性,請按照下列步驟操作。服務和工作負載在註冊期間,也可以使用相同的應用程式屬性。

控制台

  1. 在 Google Cloud 控制台,使用專案挑選器選取管理專案。

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

    前往「Applications」(應用程式)

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

  3. 找到要更新的應用程式,然後按一下 「Edit」(編輯)。

  4. 在「Edit application」(編輯應用程式) 窗格中,視需要修改欄位。

  5. 按一下「儲存」。

gcloud

  1. 找出管理專案的專案 ID。

  2. 更新應用程式屬性。您可以更新任何可變動屬性,例如 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 或 eu);如果是區域性應用程式,請使用特定區域,例如 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:分別是業主的顯示名稱和電子郵件地址。

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
    }
}

刪除應用程式

如要刪除應用程式,請先取消註冊所有服務和工作負載。接著,請按照下列步驟刪除應用程式:

控制台

  1. 在 Google Cloud 控制台,使用專案挑選器選取管理專案。

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

    前往「Applications」(應用程式)

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

  3. 按一下要刪除的應用程式名稱。

  4. 前往「Services and workloads」(服務和工作負載) 分頁,確認您已取消註冊所有應用程式元件。詳情請參閱「取消註冊服務和工作負載」。

  5. 取消註冊所有服務和工作負載後,返回應用程式詳細資料頁面,然後按一下「Delete」(刪除)。

gcloud

  1. 找出管理專案的專案 ID。

  2. 請確認您已取消註冊所有應用程式元件。詳情請參閱「取消註冊服務和工作負載」。

  3. 應用程式沒有註冊的元件後,請將其刪除:

    gcloud apphub applications delete APPLICATION_NAME \
        --project=PROJECT_ID \
        --location=LOCATION
    

    更改下列內容:

    • APPLICATION_NAME:應用程式名稱。您可以在建立應用程式時指定這個值。
    • PROJECT_ID:管理專案的 ID。
    • LOCATION:應用程式的位置。如果是全球性應用程式,請使用 global;如果是多區域應用程式,請使用多區域 (us 或 eu);如果是區域性應用程式,請使用特定區域,例如 us-east1。

Terraform

如要刪除由 Terraform 管理的應用程式,請選擇下列任一做法:

  • 從設定中移除資源:從 Terraform 檔案中刪除 google_apphub_application 資源區塊,然後執行 terraform apply。Terraform 會辨識出設定中已不含該資源,並將其從專案中刪除。
  • 終止所有資源:執行 terraform destroy 指令,終止 Terraform 設定管理的所有資源,包括應用程式。

後續步驟