App Hub アプリケーションを管理する

App Hub では、登録済みのアプリケーションの表示、属性の更新、アプリケーションの削除を行うことができるため、アプリケーション インベントリを正確に維持できます。構成ドリフトを回避するには、App Hub を使用して直接登録したアプリケーションのみを更新または削除し、Application Design Center のテンプレートに基づいてアプリケーションを管理します。

概要

アプリケーション設定モデルを選択するときに、管理プロジェクトで App Hub アプリケーションのアプリケーション管理境界を定義します。その後、この境界内のアプリケーションにサービスとワークロードを登録できます。

アプリケーション管理プラクティスを導入するための推奨ユースケースについては、アプリケーション管理の準備をご覧ください。アプリケーションを作成してリソースを登録するには、既存のリソースをアプリケーションに登録するをご覧ください。

構成のずれを回避し、信頼できる情報源を明確に維持するため、アプリケーション コンポーネントは、最初に定義された環境で管理することをおすすめします。

  • Application Design Center テンプレートからデプロイされたアプリケーションの場合: Application Design Center を使用してアプリケーションを管理、更新します。アプリケーション設計の変更のためにテンプレートを改訂するか、アプリケーション リビジョンを作成して、アプリケーションやコンポーネントの詳細などの設定を更新できます。

    App Design Center に移動

  • App Hub で既存のリソースを登録して作成されたアプリケーションの場合: App Hub 内でアプリケーション、サービス、ワークロードを直接管理します。

    App Hub に移動

App Hub では、Google Cloud コンソールまたは Google Cloud CLI を使用してこれらのアクションを実行できます。テンプレートからデプロイされたアプリケーションについては、Application Design Center のドキュメントをご覧ください。

始める前に

このドキュメントでは、サポートされているリソースが登録されているアプリケーションがあることを前提としています。

必要なロール

App Hub でアプリケーションを管理するために必要な権限を取得するには、アプリケーション管理境界を定義する管理プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

  • アプリケーションを更新して削除する: App Hub 編集者(roles/apphub.editor)
  • アプリケーションを表示する: App Hub 閲覧者(roles/apphub.viewer)

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

App Hub のロールの詳細については、App Hub の IAM ロールと権限をご覧ください。

アプリケーションの一覧表示

アプリケーション管理境界内のすべてのアプリケーションを一覧表示してフィルタリングする手順は次のとおりです。

コンソール

  1. Google Cloud コンソールで、プロジェクト選択ツールを使用して管理プロジェクトを選択します。

  2. App Hub から [アプリケーション] ページに移動します。

    [アプリケーション] に移動

    このページには、アプリケーションのリストが表示されます。

  3. リストをフィルタするには、[フィルタ] フィールドを使用します。[重要度] や [環境] などの属性でフィルタできます。

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 から [アプリケーション] ページに移動します。

    [アプリケーション] に移動

    このページには、アプリケーションのリストが表示されます。

  3. 表示するアプリケーションの名前をクリックします。

    アプリケーションの [詳細] タブが表示されます。

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 から [アプリケーション] ページに移動します。

    [アプリケーション] に移動

    このページには、アプリケーションのリストが表示されます。

  3. 更新するアプリケーションの [編集] をクリックします。

  4. [アプリケーションの編集] ペインで、必要に応じてフィールドを変更します。

  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 から [アプリケーション] ページに移動します。

    [アプリケーション] に移動

    このページには、アプリケーションのリストが表示されます。

  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 または eu)、リージョン アプリケーションの場合は特定のリージョン(us-east1 など)を使用します。

Terraform

Terraform で管理されているアプリケーションを削除するには、次のオプションがあります。

  • 構成からリソースを削除する: Terraform ファイルから google_apphub_application リソース ブロックを削除し、terraform apply を実行します。Terraform は、リソースが構成に存在しないことを認識し、プロジェクトから削除します。
  • すべてのリソースを終了する: terraform destroy コマンドを実行して、アプリケーションを含む、Terraform 構成で管理されているすべてのリソースを終了します。

次のステップ