既存の Google Cloud リソースを App Hub アプリケーションのサービスとワークロードとして登録すると、ビジネス目的に基づいてリソースを整理して管理を簡素化できます。このアプローチにより、可視性、モニタリング、ガバナンス、運用管理が統合されます。
このガイドでは、アプリケーションとして正式に定義されていない既存の Google Cloud リソースをグループ化する方法について説明します。
始める前に
リソースをアプリケーションに整理する前に、アプリケーション管理の初期設定を完了する必要があります。このプロセスには通常、次のロールと手順が含まれます。
管理者向け:
- アプリケーションの設定モデルを選択する。管理プロジェクトを構成し、整理する Google Cloud リソースを含むアプリケーション管理境界を定義する必要があります。
- 使用するすべての Google Cloud リソースに必要な API を有効にします。
- ユーザーにアクセス権を付与する。アプリケーション ライフサイクルにおけるユーザーの責任に基づいて、適切な IAM ロールを割り当てます。
デベロッパーとオペレーター向け:
- 初期設定が完了していることを管理者に確認します。
- 実行するタスクに必要な IAM ロールがあることを確認します。
- Google Cloud コンソールで管理プロジェクトを開くか、Terraform または Google Cloud CLI の操作に使用する管理プロジェクトのプロジェクト ID を確認します。
アプリケーションを作成する
既存の Google Cloud リソースの論理コンテナとして機能するアプリケーションを App Hub で作成します。
コンソール
Google Cloud コンソールで、プロジェクト選択ツールを使用して管理プロジェクトを選択します。
App Hub から [アプリケーション] ページに移動します。
[アプリケーションを作成] をクリックします。
[アプリケーションの詳細] タブで、地理的な分散要件に基づいて、アプリケーションに最適なロケーションを選択します。
- [グローバル] を選択して、グローバル アプリケーションを作成します。
- マルチリージョン アプリケーションを作成するには、[マルチリージョン] を選択します。次に、アプリケーションでサポートされているマルチリージョン(
usまたはeu)を選択します。 - リージョン アプリケーションを作成するには、[リージョン] を選択します。次に、App Hub でサポート対象の地域に基づいて、アプリケーションの特定のリージョンを選択します。
アプリケーションに最適なロケーションの詳細については、グローバル、マルチリージョン、リージョン アプリケーションをご覧ください。
アプリケーションの名前を入力します。
この名前は、英小文字、数字、ハイフンのみを含む固有識別子です。アプリケーションの作成後にこの名前を変更することはできません。
必要に応じて、アプリケーションの表示名と説明を追加します。
これらは固有識別子ではないため、アプリケーションの作成後に変更できます。
[続行] をクリックします。
[アプリケーション リソース] タブで、インフラストラクチャ リソースを参照し、アプリケーションのサービスとワークロードとして登録するリソースのチェックボックスをオンにします。
一度に選択できるリソースは 10 個までです。
[続行] をクリックします。
[属性とオーナー] タブでは、重要度、環境、アプリケーション オーナーなど、アプリケーションの属性を追加できます。
アプリケーションに登録するリソースに同じ属性とオーナーを使用することも、後で定義することもできます。
[作成] をクリックします。
アプリケーションが作成されると、[アプリケーション] ページに、サービスとワークロードとして登録したリソースなどの詳細が表示されます。アプリケーションを作成したら、さらにサービスとワークロードを登録できます。
gcloud
Google Cloud CLI を使用して、ターミナルまたは Cloud Shell からアプリケーションを作成します。
gcloud apphub applications create APPLICATION_NAME \ --project=PROJECT_ID \ --scope-type=SCOPE_TYPE \ --location=LOCATION \ --display-name=DISPLAY_NAME \ --criticality-type=CRITICALITY \ --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_EMAILAPPLICATION_NAMEは、アプリケーションの名前に置き換えます。この名前は、英小文字、数字、ハイフンのみを使用できる固有識別子です。--criticality-typeなどのオプション フラグを使用して、アプリケーションの最上位の属性を定義し、検出可能性とガバナンスをサポートします。必須フラグとオプション フラグを次のように置き換えます。
- 必須:
PROJECT_ID: 管理プロジェクトの ID。 必須:
SCOPE_TYPE: 地理的な分散要件に基づくアプリケーションのロケーション。次のいずれかの値を使用します。REGIONAL: リージョン アプリケーションの場合。MULTI_REGIONAL: マルチリージョン アプリケーション。GLOBAL: グローバル アプリケーションの場合。
アプリケーションに最適なロケーションの詳細については、グローバル、マルチリージョン、リージョン アプリケーションをご覧ください。
必須:
LOCATION: アプリケーションの特定のロケーション。次の値のいずれかを使用できます。- アプリケーションの
--scope-typeロケーションがREGIONALに設定されている場合は、App Hub でサポート対象の地域名を指定します。 - アプリケーションの
--scope-typeの場所がMULTI_REGIONALに設定されている場合、usまたはeuを指定してください。 - アプリケーションの
--scope-typeロケーションがGLOBALに設定されている場合は、globalを使用します。
- アプリケーションの
省略可:
DISPLAY_NAME: アプリケーションの表示名。表示名は固有識別子ではないため、アプリケーションの作成後に変更できます。省略可:
CRITICALITY: オペレーションにおけるアプリケーションの重要度。次のいずれかの値を使用します。MISSION_CRITICALHIGHMEDIUMLOW
省略可:
ENVIRONMENT: ソフトウェア ライフサイクルのステージ。次の値のいずれかを使用できます。PRODUCTIONSTAGINGDEVELOPMENTTEST
省略可:
DEV_NAMEとDEV_EMAIL: デベロッパー オーナーの表示名とメールアドレス。省略可:
OPERATOR_NAMEとOPERATOR_EMAIL: オペレーター オーナーの表示名とメールアドレス。省略可:
BUSINESS_NAMEとBUSINESS_EMAIL: ビジネス オーナーの表示名とメールアドレス。
- 必須:
プロジェクト内のアプリケーションを一覧表示します。
gcloud apphub applications list \ --project=PROJECT_ID \ --location=LOCATION次のような出力が表示されます。
ID DISPLAY_NAME CREATE_TIME APPLICATION_NAME DISPLAY_NAME 2023-10-31T18:33:48
Terraform
Terraform を使用してアプリケーションを作成するには、google_apphub_application リソースを使用します。このリソースを使用すると、アプリケーションの名前、ロケーション、属性などのプロパティを定義できます。
次の例では、重要度、環境、オーナー属性を定義して、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."
scope {
type = "REGIONAL"
}
attributes {
criticality {
type = "MISSION_CRITICAL"
}
environment {
type = "PRODUCTION"
}
business_owners {
display_name = "Alice"
email = "alice@example.com"
}
developer_owners {
display_name = "Bob"
email = "bob@example.com"
}
operator_owners {
display_name = "Charlie"
email = "charlie@example.com"
}
}
}
サービスとワークロードを登録する
App Hub では、アプリケーション管理境界内にあるサポートされているリソースを選択して、サービスとワークロードとして登録できます。アプリケーションを作成したら、 Google Cloudリソースをサービスとワークロードとして登録できます。
排他的サービスは 1 つのアプリケーションにのみ登録できます。ただし、共有サービスは複数のアプリケーションに登録できます。App Hub は、共有サービスが別のアプリケーションにすでに登録されている場合でも、アプリケーションに登録するときに共有サービスを検出しますが、属性を変更できない場合があります。
コンソール
アプリケーションを作成したら、複数のリソースを登録できます。
Google Cloud コンソールで、プロジェクト選択ツールを使用して管理プロジェクトを選択します。
App Hub から [アプリケーション] ページに移動します。
Google Cloud リソースを登録するアプリケーションの名前をクリックします。
アプリケーションのページで、[サービスとワークロード] タブを選択します。
[ サービスまたはワークロードを登録する] をクリックします。
[サービスとワークロード] タブで、インフラストラクチャ リソースを参照し、アプリケーションのサービスまたはワークロードとして登録するリソースのチェックボックスをオンにします。
一度に選択できるリソースは 10 個までです。
[続行] をクリックします。
[属性とオーナー] タブでは、これらのリソースの属性(重要度、環境、リソース オーナーなど)を追加できます。
アプリケーションと同じ属性とオーナーを使用することも、後で別の属性を定義することもできます。
[Register] をクリックします。
[サービスとワークロード] タブには、アプリケーションの登録済みのサービスとワークロードがすべて表示されます。
gcloud
App Hub では、アプリケーション管理境界内にあるサポートされているリソースをサービスまたはワークロードとして選択できます。Google Cloud CLI を使用して、ターミナルまたは Cloud Shell からアプリケーションに登録できるサービスまたはワークロードを一覧表示します。サービスとワークロードでは、コマンドが少し異なります。
サービスを登録する
アプリケーションに登録可能なサービスを一覧表示します。
gcloud apphub discovered-services list \ --project=PROJECT_ID \ --location=REGION \ --filter=FILTER_EXPRESSION必須フラグとオプション フラグを次のように置き換えます。
- 必須:
PROJECT_ID: 管理プロジェクトの ID。 必須:
REGION: 地理的な分散に基づくサービスの特定のロケーション。次のいずれかの値を使用します。- サービスがリージョンの場合は、App Hub でサポート対象の地域名を指定します。
- サービスがマルチリージョンの場合は、
usまたはeuを指定します。 - サービスがグローバルの場合は、
globalを使用します。
省略可:
FILTER_EXPRESSION:--filterフラグのフィルタ式。アプリケーション管理境界内の指定されたプロジェクトのサービス、または特定のプロパティを持つサービスのみを表示します。次に例を示します。service_properties.gcp_project=projects/PROJECT_IDservice_properties.gcp_project=projects/PROJECT_ID AND service_reference.uri~"forwardingRules"
出力は次のようになります。
ID SERVICE_REFERENCE SERVICE_PROPERTIES SERVICE_ID {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/forwardingRules/forwarding-rule'} {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}- 必須:
出力からサービス ID
SERVICE_IDをコピーします。アプリケーションにサービスを登録します。
gcloud apphub applications services create SERVICE_NAME \ --project=PROJECT_ID \ --location=APPLICATION_LOCATION \ --application=APPLICATION_NAME \ --discovered-service=projects/PROJECT_ID/locations/REGION/discoveredServices/SERVICE_ID \ --display-name=SERVICE_DISPLAY_NAME \ --criticality-type=CRITICALITY \ --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_EMAILSERVICE_NAMEは、サービスをアプリケーションに登録するために使用する名前に置き換えます。--criticality-typeなどのオプション フラグを使用して、サービスの最上位属性を定義し、検出可能性とガバナンスをサポートします。必須フラグとオプション フラグを次のように置き換えます。
- 必須:
PROJECT_ID: 管理プロジェクトの ID。 必須:
APPLICATION_LOCATION: アプリケーションのロケーション。次の値のいずれかを使用できます。- アプリケーションがリージョンの場合は、App Hub でサポート対象の地域名を指定します。
- アプリケーションがマルチリージョンの場合は、
usまたはeuを指定します。 - アプリケーションがグローバルの場合は、
globalを使用します。
必須:
APPLICATION_NAME: サービスを登録するアプリケーションの名前。必須:
REGION: 前の出力から検出されたサービス。必須:
SERVICE_ID: 前の出力からコピーしたサービス ID。省略可:
SERVICE_DISPLAY_NAME: サービスの表示名。省略可:
CRITICALITY: オペレーションにおけるサービスの重要度。次の値のいずれかを使用できます。MISSION_CRITICALHIGHMEDIUMLOW
省略可:
ENVIRONMENT: ソフトウェア ライフサイクルのステージ。次の値のいずれかを使用できます。PRODUCTIONSTAGINGDEVELOPMENTTEST
省略可:
DEV_NAMEとDEV_EMAIL: デベロッパー オーナーの表示名とメールアドレス。省略可:
OPERATOR_NAMEとOPERATOR_EMAIL: オペレーター オーナーの表示名とメールアドレス。省略可:
BUSINESS_NAMEとBUSINESS_EMAIL: ビジネス オーナーの表示名とメールアドレス。
- 必須:
アプリケーション内の登録済みサービスを一覧表示します。
gcloud apphub applications services list \ --application=APPLICATION_NAME \ --project=PROJECT_ID \ --location=APPLICATION_LOCATION登録済みのサービスごとに、次のような出力が返されます。
ID DISPLAY_NAME SERVICE_REFERENCE CREATE_TIME SERVICE_NAME SERVICE_DISPLAY_NAME {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/forwardingRules/forwarding-rule'} 2023-11-01T21:38:08
ワークロードを登録する
アプリケーションに登録できる利用可能なワークロードを一覧表示します。
gcloud apphub discovered-workloads list \ --project=PROJECT_ID \ --location=REGION \ --filter=FILTER_EXPRESSION必須フラグとオプション フラグを次のように置き換えます。
- 必須:
PROJECT_ID: 管理プロジェクトの ID。 必須:
REGION: 地理的な分散に基づくワークロードの特定のロケーション。次の値のいずれかを使用できます。- ワークロードがリージョンの場合は、App Hub でサポート対象の地域名を指定します。
- ワークロードがマルチリージョンの場合は、
usまたはeuを指定します。 - ワークロードがグローバルの場合は、
globalを使用します。
省略可:
FILTER_EXPRESSION:--filterフラグのフィルタ式。アプリケーション管理境界内の指定されたプロジェクトのワークロード、または特定のプロパティ(workload_properties.gcp_project=projects/PROJECT_IDなど)を持つワークロードのみを表示します。
出力は次のようになります。
ID WORKLOAD_REFERENCE WORKLOAD_PROPERTIES WORKLOAD_ID {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'} {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}- 必須:
出力からワークロード ID
WORKLOAD_IDをコピーします。ワークロードをアプリケーションに登録します。
gcloud apphub applications workloads create WORKLOAD_NAME \ --project=PROJECT_ID \ --location=APPLICATION_LOCATION \ --application=APPLICATION_NAME \ --discovered-workload=projects/PROJECT_ID/locations/REGION/discoveredWorkloads/WORKLOAD_ID \ --display-name=WORKLOAD_DISPLAY_NAME \ --criticality-type=CRITICALITY \ --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_EMAILWORKLOAD_NAMEは、ワークロードをアプリケーションに登録するために使用する名前に置き換えます。--criticality-typeなどのオプション フラグを使用して、ワークロードの最上位の属性を定義し、検出可能性とガバナンスをサポートします。必須フラグとオプション フラグを次のように置き換えます。
- 必須:
PROJECT_ID: 管理プロジェクトの ID。 必須:
APPLICATION_LOCATION: アプリケーションのロケーション。次の値のいずれかを使用できます。- アプリケーションがリージョンの場合は、App Hub でサポート対象の地域名を指定します。
- アプリケーションがマルチリージョンの場合は、
usまたはeuを指定します。 - アプリケーションがグローバルの場合は、
globalを使用します。
必須:
APPLICATION_NAME: ワークロードを登録するアプリケーションの名前。必須:
REGION: 前の出力で検出されたワークロードのロケーション。必須:
WORKLOAD_ID: 前の出力からコピーしたワークロード ID。省略可:
WORKLOAD_DISPLAY_NAME: ワークロードの表示名。省略可:
CRITICALITY: オペレーションにおけるワークロードの重要度。次の値のいずれかを使用できます。MISSION_CRITICALHIGHMEDIUMLOW
省略可:
ENVIRONMENT: ソフトウェア ライフサイクルのステージ。次の値のいずれかを使用できます。PRODUCTIONSTAGINGDEVELOPMENTTEST
省略可:
DEV_NAMEとDEV_EMAIL: デベロッパー オーナーの表示名とメールアドレス。省略可:
OPERATOR_NAMEとOPERATOR_EMAIL: オペレーター オーナーの表示名とメールアドレス。省略可:
BUSINESS_NAMEとBUSINESS_EMAIL: ビジネス オーナーの表示名とメールアドレス。
- 必須:
アプリケーション内の登録済みワークロードを一覧表示します。
gcloud apphub applications workloads list \ --application=APPLICATION_NAME \ --project=PROJECT_ID \ --location=APPLICATION_LOCATION登録済みのワークロードごとに、次のような出力が返されます。
ID DISPLAY_NAME WORKLOAD_REFERENCE CREATE_TIME WORKLOAD_NAME WORKLOAD_DISPLAY_NAME {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'} 2023-11-01T21:38:08
Terraform
Terraform を使用して、アプリケーション管理境界内の Google Cloud リソースをアプリケーションのサービスまたはワークロードとして登録するには、google_apphub_discovered_service データソースと google_apphub_discovered_workload データソースを使用して、登録するリソースに関する情報を動的に取得します。
次に、google_apphub_service リソースまたは google_apphub_workload リソースを使用して、サービスまたはワークロードを登録します。
サービスを登録する
URI を使用してサービスに関する情報を取得します。
data "google_apphub_discovered_service" "my-service" { location = "LOCATION" service_uri = "SERVICE_URI" }検出されたサービスをアプリケーションに登録します。次に例を示します。
resource "google_apphub_service" "example" { project = "my-project-id" location = "us-central1" application_id = google_apphub_application.example.application_id service_id = "frontend-load-balancer" discovered_service = data.google_apphub_discovered_service.my-forwarding-rule.name display_name = "Frontend Load Balancer" description = "The primary load balancer for the frontend." }
ワークロードを登録する
URI を使用してワークロードに関する情報を取得します。
data "google_apphub_discovered_workload" "my-workload" { location = "LOCATION" workload_uri = "WORKLOAD_URI" }検出されたワークロードをアプリケーションに登録します。次に例を示します。
resource "google_apphub_workload" "example" { project = "my-project-id" location = "us-central1" application_id = google_apphub_application.example.application_id workload_id = "frontend-instance-group" discovered_workload = data.google_apphub_discovered_workload.my-mig.name display_name = "Frontend Instance Group" description = "The managed instance group for the frontend." }
プロジェクトまたはフォルダをアプリケーション管理境界外に移動するか、基盤となるリソースを削除すると、アプリケーションに登録されているサービスとワークロードの登録ステータスが接続解除に変わることがあります。接続が解除されたサービスとワークロードは、登録を解除するまでアプリケーションに残りますが、App Hub で管理またはモニタリングできなくなります。詳細については、サービスとワークロードの登録ステータスをご覧ください。
サービスまたはワークロードをアプリケーションに再接続するには、それらを再度登録する必要があります。
権限を付与してオペレーションを開始する
App Hub でアプリケーションを作成し、サービスとワークロードを登録したら、ライフサイクルの責任に基づいてユーザー アクセス権を付与し、この論理グループを 1 つのユニットとして管理する必要があります。
- アクセスニーズに応じて、個々のアプリケーションまたはすべてのアプリケーションに権限を付与できます。推奨されるロールの一覧については、ユーザーにアプリケーション中心のロールを付与するをご覧ください。
- 必要に応じて、Cloud Hub に移動して、定義したアプリケーションの統合オペレーション ダッシュボード(健全性、パフォーマンス、費用データなど)を表示します。