App Hub を設定する

Console

1. Google Cloud コンソールでプロジェクトの選択ページに移動します。

   プロジェクト セレクタに移動

2. App Hub ホスト プロジェクトとして使用する Google Cloud プロジェクトを選択または作成します。

3. Enable the required API.

   Enable the API

4. プロジェクト作成者にはオーナーロール（roles/owner）が付与されます。デフォルトでは、この IAM ロールには、ほとんどの Google Cloud リソースに対する完全アクセスに必要な権限が含まれています。

   プロジェクト作成者でない場合は、プロジェクトで必要な権限を適切なプリンシパルに付与する必要があります。たとえば、プリンシパルは Google アカウント（エンドユーザーの場合）やサービス アカウント（アプリケーションとコンピューティング ワークロードの場合）になることもあります。このチュートリアルを完了するために必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

   1. Google Cloud コンソールの [IAM] ページに移動します。

      [IAM] に移動

   2. [person_addアクセスを許可] をクリックします。アクセス権の付与ペインが開きます。

   3. [新しいプリンシパル] フィールドに、ホスト プロジェクトの App Hub 管理者のロール、つまり App Hub を管理するユーザーのメールアドレスを入力します。

   4. [ロールを選択] をクリックし、[フィルタ] フィールドに「App Hub」と入力します。

   5. App Hub 管理者のロールを選択し、[保存] をクリックします。

   6. 各 App Hub サービス プロジェクトで、同じユーザーに App Hub 管理者のロールを付与します。

5. Google Cloud コンソールで、App Hub の [設定] ページに移動します。

   [設定] に移動

6. [設定] ページで、[プロジェクトを接続] をクリックします。

7. 次のいずれかを行います。

   • プロジェクトのリストで、サービス プロジェクトとして追加するプロジェクトのチェックボックスをオンにします。
   • プロジェクトを検索し、サービス プロジェクトとして追加するプロジェクトを選択します。

8. [選択] をクリックします。 [接続されたサービス プロジェクト] テーブルに、選択したサービス プロジェクトが表示されます。

9. [閉じる] をクリックします。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Google Cloud CLI の最新バージョンがインストールされていることを確認します。Cloud Shell から次のコマンドを実行します。

   gcloud components update

3. App Hub のホスト プロジェクトとして新しいプロジェクト HOST_PROJECT_ID を作成するか、選択します。

   • Google Cloud プロジェクトを作成する

     gcloud projects create HOST_PROJECT_ID

   • 作成した Google Cloud プロジェクトを選択します。

     gcloud config set project HOST_PROJECT_ID

4. 作成したホスト プロジェクトで App Hub API を有効にします。

   gcloud services enable apphub.googleapis.com \
       --project=HOST_PROJECT_ID
   

5. プロジェクト作成者にはオーナーロール（roles/owner）が付与されます。デフォルトでは、この IAM ロールには、ほとんどの Google Cloud リソースに対する完全アクセスに必要な権限が含まれています。

   プロジェクト作成者でない場合は、プロジェクトで必要な権限を適切なプリンシパルに付与する必要があります。たとえば、プリンシパルは Google アカウント（エンドユーザーの場合）やサービス アカウント（アプリケーションとコンピューティング ワークロードの場合）になることもあります。このチュートリアルを完了するために必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

   1. 必要に応じて、App Hub を管理するユーザーにホスト プロジェクトの App Hub 管理者のロールを付与します。管理者ごとに次のコマンドを繰り返します。

      gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
          --member='user:HOST_PROJECT_ADMIN' \
          --role='roles/apphub.admin'
      

      HOST_PROJECT_ADMIN は、ホスト プロジェクトで App Hub 管理者のロールを持つユーザーに置き換えます。この値の形式は username@yourdomain です（例: robert.smith@example.com）。

   2. App Hub を管理するユーザーに、サービス プロジェクトの App Hub 管理者のロールを付与します。サービス プロジェクトをホスト プロジェクトに追加するには、App Hub 管理者のロールが必要です。サービス プロジェクトごとに、このロールを持つユーザーが少なくとも 1 人必要です。1 人のユーザーが複数のサービス プロジェクトでロールを持ちます。

      gcloud projects add-iam-policy-binding SERVICE_PROJECT_1 \
          --member='user:HOST_PROJECT_ADMIN' \
          --role='roles/apphub.admin'
      

      gcloud projects add-iam-policy-binding SERVICE_PROJECT_2 \
          --member='user:HOST_PROJECT_ADMIN' \
          --role='roles/apphub.admin'
      

      gcloud projects add-iam-policy-binding SERVICE_PROJECT_3 \
          --member='user:HOST_PROJECT_ADMIN' \
          --role='roles/apphub.admin'
      

      以下を置き換えます。

      • SERVICE_PROJECT_1: この例の 3 つのサービス プロジェクトのうちの 1 番目のプロジェクト。
      • SERVICE_PROJECT_2: この例の 3 つのサービス プロジェクトのうちの 2 番目のプロジェクト。
      • SERVICE_PROJECT_3: この例の 3 つのサービス プロジェクトのうちの 3 番目のプロジェクト。

6. サービス プロジェクトを App Hub ホスト プロジェクトに追加します。

   gcloud apphub service-projects add SERVICE_PROJECT_1 \
       --project=HOST_PROJECT_ID
   

   gcloud apphub service-projects add SERVICE_PROJECT_2 \
       --project=HOST_PROJECT_ID
   

   gcloud apphub service-projects add SERVICE_PROJECT_3 \
       --project=HOST_PROJECT_ID
   

Console

1. Google Cloud コンソールで、[settings設定] ページに移動します。

   [設定] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。

2. [指標のスコープ] を選択します。

   [指標スコープ] タブには、現在の Google Cloud プロジェクトでモニタリングされているリソースが一覧表示されます。また、指標スコープに現在の Google Cloud プロジェクトが含まれる Google Cloud プロジェクトも一覧表示されます。

3. Google Cloud プロジェクトを指標スコープに追加するには:

   1. [Google Cloud プロジェクト] ペインで、[プロジェクトを追加] をクリックします。
   2. [Google Cloud プロジェクトを追加] ダイアログで [プロジェクトを選択] をクリックし、モニタリングする必要なサービス プロジェクトのチェックボックスをオンにします。

   3. 変更を保存するには、[プロジェクトを追加] をクリックします。

      [設定] ページが表示され、そのページの表が更新されて選択内容が一覧表示されます。

プロジェクトを指標スコープに追加した後、変更がすべての Monitoring システム全体に反映されるまで約 60 秒かかります。

Google Cloud コンソールを使用して指標スコープを構成する方法については、指標スコープを構成するをご覧ください。

gcloud

サービス プロジェクトをモニタリング対象リソース コンテナとして App Hub ホスト プロジェクトに追加するには:

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_1 \
    --project=HOST_PROJECT_ID

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_2 \
    --project=HOST_PROJECT_ID

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_3 \
    --project=HOST_PROJECT_ID

Google Cloud CLI を使用して指標スコープを構成する方法については、API を使用して指標スコープを構成するをご覧ください。

Console

1. ホスト プロジェクトに移動していることを確認します。

2. Google Cloud コンソールで、App Hub の [アプリケーション] ページに移動します。

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

3. [アプリケーションを作成] をクリックします。

4. [アプリケーションの作成] ページの [アプリケーションのリージョンと名前を選択] ペインで、アプリケーションに登録するサービスとワークロードのスコープに基づいて、次のいずれかを行います。

   • グローバル ロケーションからサービスとワークロードを登録できるアプリケーションを作成するには、[グローバル]（プレビュー）を選択します。

   • 1 つの場所からサービスとワークロードを登録できるアプリケーションを作成するには:

     1. [リージョン] を選択します。
     2. リージョンを選択します。

5. [アプリケーション名] を入力し、[続行] をクリックします。

6. 必要に応じて、次のフィールドにアプリケーションの詳細を追加します。詳しくは、このドキュメントの既存の App Hub アプリケーションを更新するをご覧ください。

7. [作成] をクリックします。

gcloud

1. APPLICATION_NAME という名前の新しいアプリケーションを作成し、表示名 APPLICATION_DISPLAY_NAME を設定します。

   gcloud apphub applications create APPLICATION_NAME \
     --scope-type=SCOPE_TYPE \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   以下を置き換えます。

   • APPLICATION_NAME: アプリケーションの名前。 名前にはスペースなしの小文字の英数字のみを使用します。
   • SCOPE_TYPE: アプリケーションに登録できるサービスとワークロードを定義するアプリケーションのスコープ。次の値のいずれかを使用できます。
     • REGIONAL
     • GLOBAL（プレビュー）
   • REGION: アプリケーションのリージョン。--scope-type に応じて、値を us-east1 または global（プレビュー版）にします。

2. ホスト プロジェクト内のアプリケーションを一覧表示します。

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

   出力は次のようになります。

   ID                DISPLAY_NAME              CREATE_TIME
   APPLICATION_NAME  APPLICATION_DISPLAY_NAME  2023-10-31T18:33:48
   

3. 作成したアプリケーションの詳細を取得します。

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

   このコマンドは、次のような YAML 形式の情報を返します。

   createTime: '2023-10-31T18:33:48.199394108Z'
   displayName: APPLICATION_DISPLAY_NAME
   name: projects/HOST_PROJECT_ID/locations/REGION/applications/APPLICATION_NAME
   scope:
     type: SCOPE_TYPE
   state: ACTIVE
   uid: [APPLICATION_UID]
   updateTime: '2023-10-31T18:33:48.343303819Z'
   
   

Console

1. Google Cloud コンソールで、App Hub の [アプリケーション] ページに移動します。

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

2. アプリケーションの一覧で、更新するアプリケーションの [edit編集] をクリックします。

3. 必要に応じてフィールドを編集し、[保存] をクリックします。

4. 省略可: アプリケーションの重要性を示す [重要度] リストで、次のいずれかを選択します。

   • ミッション クリティカル
   • 高
   • 中
   • 低

5. 省略可: ソフトウェア ライフサイクルのステージを示す [環境] リストで、次のいずれかを選択します。

   • 本番環境
   • ステージング環境
   • 開発環境
   • テスト

6. 省略可: デベロッパー オーナー、オペレーター オーナー、ビジネス オーナーに必要であるため、次の詳細を追加します。表示名を追加する場合は、所有者のメールアドレスを入力する必要があります。

   1. 所有者の表示名を入力します。
   2. オーナーのメールアドレスを入力します。この値は、username@yourdomain の形式（例: 222larabrown@gmail.com）にする必要があります。

7. デベロッパー、オペレーター、ビジネス オーナーごとにこの手順を繰り返します。

8. [保存] をクリックします。

gcloud

1. criticality-type、environment-type、owner 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=HOST_PROJECT_ID \
     --location=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）にする必要があります。

2. 属性 environment-type の値が PRODUCTION のアプリケーションを一覧表示します。

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

   出力は次のようになります。

   ID                DISPLAY_NAME              CREATE_TIME
   APPLICATION_NAME  APPLICATION_DISPLAY_NAME  2023-10-31T18:33:48
   

Console

1. Google Cloud コンソールで、App Hub の [アプリケーション] ページに移動します。

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

2. アプリケーションの名前をクリックします。[サービスとワークロード] タブに、サービス プロジェクトに存在する登録済みのサービスとワークロードのリストが表示されます。

3. 登録するサービスまたはワークロードごとに、次の操作を行います。

   1. [サービスとワークロード] タブで、[サービス / ワークロードを登録] をクリックします。
   2. [サービスまたはワークロードの登録] ページの [リソースの選択] ペインで、[参照] をクリックして、サービスまたはワークロードを [リソース] として選択します。
   3. [リソースの選択] ペインで、サービスまたはワークロードを選択し、[選択] をクリックします。
   4. [リソースの選択] ペインで、サービスまたはワークロードの名前を入力し、[続行] をクリックします。
   5. 必要に応じて、[属性を追加] ペインで、次のフィールドにサービスまたはワークロードの詳細を追加します。詳しくは、このドキュメントの既存の App Hub アプリケーションを更新するをご覧ください。[重要度] フィールドと [環境] フィールドの値は、アプリケーションの作成時に設定した値とは異なる値を選択できます。
   6. [続行] をクリックします。
   7. 必要に応じて、[オーナーを追加] セクションで、次のフィールドにサービスまたはワークロードのオーナーの詳細を追加します。詳しくは、このドキュメントの既存の App Hub アプリケーションを更新するをご覧ください。
   8. [Register] をクリックします。

[サービスとワークロード] タブに、登録済みのサービスまたはワークロードが表示されます。登録ステータスの詳細については、App Hub のプロパティと属性をご覧ください。

gcloud

1. App Hub 編集者の権限を持つユーザーを追加します。

   gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
     --member='user:APP_HUB_EDITOR' \
     --role='roles/apphub.editor'
   

   APP_HUB_EDITOR は、ホスト プロジェクトで App Hub 編集者のロールを持つユーザーに置き換えます。この値の形式は username@yourdomain です（例: robert.smith@example.com）。

2. ホスト プロジェクトに接続されているサービス プロジェクト 2 から検出されたワークロードを一覧表示します。このコマンドによって、アプリケーションに登録可能なワークロードが返されます。

   gcloud apphub discovered-workloads list \
     --filter='workload_properties.gcp_project=projects/SERVICE_PROJECT_2' \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   出力は次のようになります。未登録の MIG が含まれます。

   ID                           WORKLOAD_REFERENCE                                                                                                      WORKLOAD_PROPERTIES
   [DISCOVERED_WORKLOAD_ID_1]   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-1'}     {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}
   [DISCOVERED_WORKLOAD_ID_2]   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}     {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}
   

   出力からワークロード ID をコピーして、次の手順で使用します。

3. 前の手順で作成したワークロードをアプリケーションに登録します。

   gcloud apphub applications workloads create WORKLOAD_NAME \
     --discovered-workload='projects/HOST_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID_2' \
     --display-name='mywebserver-deployment1' \
     --application=APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   以下を置き換えます。

   • WORKLOAD_NAME: ワークロードを登録するときの名前。
   • DISCOVERED_WORKLOAD_ID_2: 前の手順の出力から取得したワークロード ID。

4. 上記の 2 つの手順を繰り返して、サービス プロジェクト 3 から必要なワークロードをフィルタして登録します。

5. 省略可: criticality-type、environment-type、owner 属性を使用してワークロードを更新できます。

   gcloud apphub applications workloads update WORKLOAD_NAME \
     --application=APPLICATION_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=HOST_PROJECT_ID \
     --location=REGION
   

   criticality-type と environment-type に指定された値のいずれかを指定する必要がありますが、この値は、アプリケーションの作成時に設定した値とは異なる場合があります。

6. アプリケーションに登録されているワークロードを一覧表示します。

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

   出力は次のようになります。

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

   登録済みだが切断されたワークロードは、WORKLOAD_REFERENCE フィールドの空の値で表されます。登録ステータスの詳細については、App Hub のプロパティと属性をご覧ください。

7. ホスト プロジェクトに接続されている Service Project 1 で、転送ルールを使用して検出されたサービスを一覧表示します。このコマンドによって、アプリケーションに登録可能なサービスが返されます。

   gcloud apphub discovered-services list \
     --filter='service_properties.gcp_project=projects/SERVICE_PROJECT_1 AND service_reference.uri~"forwardingRules"' \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   出力は次のようになります。

   ID                           SERVICE_REFERENCE                                                                                                                    SERVICE_PROPERTIES
   [DISCOVERED_SERVICE_ID_1]    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}     {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}
   [DISCOVERED_SERVICE_ID_2]    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}     {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}
   

   次のステップで使用するサービス ID DISCOVERED_SERVICE_ID_2 を出力からコピーします。

8. サービス プロジェクト 1 の転送ルール testing-forwarding-rule-2 をサービスとして登録します。

   gcloud apphub applications services create SERVICE_NAME \
     --discovered-service='projects/HOST_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE_ID_2' \
     --display-name='mywebserver-service1' \
     --application=APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   以下を置き換えます。

   • SERVICE_NAME: サービスを登録するときの名前。
   • DISCOVERED_SERVICE_ID_2: 前の手順の出力から取得したサービス ID。

9. サービスを一覧表示し、それらのサービスにフィルタを適用して、サービス プロジェクト 1、2、3 にサービスを登録する前の手順を繰り返します。

10. criticality-type 属性と environment-type 属性を使用してサービスを更新します。

    gcloud apphub applications services update SERVICE_NAME \
      --criticality-type='CRITICALITY_LEVEL' \
      --environment-type='ENVIRONMENT' \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID  \
      --location=REGION
    

11. APPLICATION_NAME アプリケーションと HOST_PROJECT_ID ホスト プロジェクトに登録されているサービスを一覧表示します。

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

    各サービスの出力は、次のようになります。

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

    登録されているが切断されたサービスは、SERVICE_REFERENCE フィールドの空の値で表されます。

12. APPLICATION_NAME アプリケーションと HOST_PROJECT_ID ホスト プロジェクト内のサービスを、environment-type 属性が PRODUCTION に設定されているものにフィルタリングします。

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

Console

サービス プロジェクトをホスト プロジェクトに追加するには:

1. Google Cloud コンソールで、App Hub の [設定] ページに移動します。

   [設定] に移動

2. [設定] ページで、[プロジェクトを接続] をクリックします。

3. 開かれたペインで、表示されたリストからプロジェクトを検索し、サービス プロジェクトとして追加するプロジェクトのチェックボックスをオンにします。

4. [選択] をクリックします。 [接続されたサービス プロジェクト] テーブルに、選択したプロジェクトがホスト プロジェクトのサービス プロジェクトとして表示されます。

5. [閉じる] をクリックします。

ホスト プロジェクトからサービス プロジェクトを削除するには:

1. Google Cloud コンソールで、App Hub の [設定] ページに移動します。

   [設定] に移動

2. [設定] ページで、サービス プロジェクトとして削除するプロジェクトのチェックボックスをオンにします。

3. [プロジェクトを接続解除] をクリックします。[接続されたサービス プロジェクト] テーブルが更新され、ホスト プロジェクトに接続されたプロジェクトのみが表示されます。

gcloud

サービス プロジェクトをホスト プロジェクトに追加するには:

gcloud apphub service-projects add SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

gcloud apphub service-projects remove SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

Console

• プロジェクト内のアプリケーションを表示するには:

  1. Google Cloud コンソールで、App Hub の [アプリケーション] ページに移動します。

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

  2. 省略可: アプリケーションをフィルタするには:

     1. [フィルタ] フィールドで、[重要度] などのフィルタを選択します。
     2. 値として [高] を選択します。
        ホスト プロジェクトで作成された重要度の高いアプリケーションのリストが表示されます。

• サービスとワークロードを一覧表示するには:

  アプリケーション

  1. Google Cloud コンソールで、App Hub の [アプリケーション] ページに移動します。

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

  2. アプリケーションの名前をクリックします。アプリケーションに登録されているサービスとワークロードのリストを含むページが表示されます。

  3. 省略可: サービスまたはワークロードをフィルタするには:

     1. [フィルタ] フィールドで、[重要度] などのフィルタを選択します。
     2. 値として [高] を選択します。
        アプリケーションに登録されている重要度の高いサービスとワークロードのリストが表示されます。

  サービスとワークロード

  1. Google Cloud コンソールで、App Hub の [サービスとワークロード] ページに移動します。

     [サービスとワークロード] に移動

  2. [リージョン] リストで、サービスとワークロードを表示するリージョンを選択します。たとえば、[us-east1] を選択します。
     [サービスとワークロード] ページには、us-east1 に関連付けられた、接続済みのサービス プロジェクトのすべてのサービスとワークロードが表示されます。

  3. 省略可: サービスまたはワークロードをフィルタするには:

     1. [フィルタ] フィールドで、[環境] などのフィルタを選択します。
     2. 値として [本番環境] を選択します。
        アプリケーションに登録されている本番環境のサービスとワークロードのリストが表示されます。

gcloud

• プロジェクト内のアプリケーションを表示するには:

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

• アプリケーション内の登録済みサービスを一覧表示するには:

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

• アプリケーション内の登録済みワークロードを一覧表示するには:

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

• 省略可: 変数属性に基づいてリソースをフィルタするには、上記のコマンドに filter コマンドフラグを追加します。たとえば、criticality-type 属性が HIGH に設定されているすべての登録済みワークロードを一覧表示するには、次のようにします。

  gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --filter='attributes.criticality.type=HIGH' \
    --project=HOST_PROJECT_ID \
    --location=REGION
  

  フィルタに使用できる属性について詳しくは、このページの既存の App Hub アプリケーションを更新するをご覧ください。

Console

1. Google Cloud コンソールで、App Hub の [アプリケーション] ページに移動します。

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

2. アプリケーションの名前をクリックします。アプリケーションに登録されているサービスとワークロードのリストが表示されます。

3. サービスまたはワークロードの登録を解除します。

   1. [サービスとワークロード] タブの [登録済みのサービスとワークロード] セクションで、登録を解除するサービスまたはワークロードの名前をクリックします。
   2. [詳細] タブで [登録を解除] をクリックして、サービスまたはワークロードを [検出済み] リソースとして更新します。
      [サービスとワークロード] タブに、ワークロードの登録が解除されたことを示すアラートが表示されます。
   3. サービスとワークロードごとに、上記の手順を繰り返します。

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

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

5. アプリケーションの名前をクリックします。

6. アプリケーションの詳細が表示されているページで、[削除] をクリックします。

7. ホスト プロジェクトからサービス プロジェクトを削除するには、このドキュメントのサービス プロジェクトを追加または削除するをご覧ください。

8. ホスト プロジェクトの指標スコープからサービス プロジェクトを削除するには:

   1. Google Cloud コンソールで、[settings設定] ページに移動します。

      [設定] に移動

      検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。

   2. [指標のスコープ] を選択します。
   3. [Google Cloud プロジェクト] ペインで [プロジェクトを削除] をクリックし、確認ダイアログを完了します。

gcloud

1. アプリケーションに登録されているワークロードを一覧表示します。

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

2. アプリケーションからワークロードの登録を解除します。

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

   これで、ワークロードは、アプリケーションに登録可能な検出されたワークロードになります。

3. 先ほどのコマンドを繰り返して、残りの登録済みワークロードをアプリケーションから削除します。

4. アプリケーションに登録されているサービスを一覧表示します。

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

5. アプリケーションからサービスを登録解除します。

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

   これで、サービスが検出されたサービスになり、アプリケーションに登録できるようになりました。

6. 前のコマンドを繰り返して、残りの登録済みサービスをアプリケーションから登録解除します。

7. アプリケーションを削除します。

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

8. ホスト プロジェクトからサービス プロジェクトを削除します。

   gcloud apphub service-projects remove SERVICE_PROJECT_ID \
     --project=HOST_PROJECT_ID
   

9. 前のコマンドを繰り返して、ホスト プロジェクトからすべてのサービス プロジェクトを削除します。

10. ホスト プロジェクトの指標スコープからサービス プロジェクトを削除します（プレビュー）。

    gcloud beta monitoring metrics-scopes delete projects/SERVICE_PROJECT_ID \
      --project=HOST_PROJECT_ID
    

11. 前のコマンドを繰り返して、指標スコープのホスト プロジェクトからすべてのサービス プロジェクトを削除します。