既存のリソースをアプリケーションに登録する

既存の Google Cloud リソースを App Hub アプリケーションのサービスとワークロードとして登録すると、ビジネス目的に基づいてリソースを整理して管理を簡素化できます。このアプローチにより、可視性、モニタリング、ガバナンス、運用管理が統合されます。

このガイドでは、アプリケーションとして正式に定義されていない既存の Google Cloud リソースをグループ化する方法について説明します。

始める前に

リソースをアプリケーションに整理する前に、アプリケーション管理の初期設定を完了する必要があります。このプロセスには通常、次のロールと手順が含まれます。

アプリケーションを作成する

既存の Google Cloud リソースの論理コンテナとして機能するアプリケーションを App Hub で作成します。

コンソール

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

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

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

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

  4. [アプリケーションの詳細] タブで、地理的な分散要件に基づいて、アプリケーションに最適なロケーションを選択します。

    • [グローバル] を選択して、グローバル アプリケーションを作成します。
    • マルチリージョン アプリケーションを作成するには、[マルチリージョン] を選択します。次に、アプリケーションでサポートされているマルチリージョン(us または eu)を選択します。
    • リージョン アプリケーションを作成するには、[リージョン] を選択します。次に、App Hub でサポート対象の地域に基づいて、アプリケーションの特定のリージョンを選択します。

    アプリケーションに最適なロケーションの詳細については、グローバル、マルチリージョン、リージョン アプリケーションをご覧ください。

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

    この名前は、英小文字、数字、ハイフンのみを含む固有識別子です。アプリケーションの作成後にこの名前を変更することはできません。

  6. 必要に応じて、アプリケーションの表示名と説明を追加します。

    これらは固有識別子ではないため、アプリケーションの作成後に変更できます。

  7. [続行] をクリックします。

  8. [アプリケーション リソース] タブで、インフラストラクチャ リソースを参照し、アプリケーションのサービスとワークロードとして登録するリソースのチェックボックスをオンにします。

    一度に選択できるリソースは 10 個までです。

  9. [続行] をクリックします。

  10. [属性とオーナー] タブでは、重要度、環境、アプリケーション オーナーなど、アプリケーションの属性を追加できます。

    アプリケーションに登録するリソースに同じ属性とオーナーを使用することも、後で定義することもできます。

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

アプリケーションが作成されると、[アプリケーション] ページに、サービスとワークロードとして登録したリソースなどの詳細が表示されます。アプリケーションを作成したら、さらにサービスとワークロードを登録できます。

gcloud

  1. 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_EMAIL
    

    APPLICATION_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_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • 省略可: ENVIRONMENT: ソフトウェア ライフサイクルのステージ。次の値のいずれかを使用できます。

      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • 省略可: DEV_NAME と DEV_EMAIL: デベロッパー オーナーの表示名とメールアドレス。

    • 省略可: OPERATOR_NAME と OPERATOR_EMAIL: オペレーター オーナーの表示名とメールアドレス。

    • 省略可: BUSINESS_NAME と BUSINESS_EMAIL: ビジネス オーナーの表示名とメールアドレス。

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

    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 は、共有サービスが別のアプリケーションにすでに登録されている場合でも、アプリケーションに登録するときに共有サービスを検出しますが、属性を変更できない場合があります。

コンソール

アプリケーションを作成したら、複数のリソースを登録できます。

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

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

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

  3. Google Cloud リソースを登録するアプリケーションの名前をクリックします。

  4. アプリケーションのページで、[サービスとワークロード] タブを選択します。

  5. [ サービスまたはワークロードを登録する] をクリックします。

  6. [サービスとワークロード] タブで、インフラストラクチャ リソースを参照し、アプリケーションのサービスまたはワークロードとして登録するリソースのチェックボックスをオンにします。

    一度に選択できるリソースは 10 個までです。

  7. [続行] をクリックします。

  8. [属性とオーナー] タブでは、これらのリソースの属性(重要度、環境、リソース オーナーなど)を追加できます。

    アプリケーションと同じ属性とオーナーを使用することも、後で別の属性を定義することもできます。

  9. [Register] をクリックします。

[サービスとワークロード] タブには、アプリケーションの登録済みのサービスとワークロードがすべて表示されます。

gcloud

App Hub では、アプリケーション管理境界内にあるサポートされているリソースをサービスまたはワークロードとして選択できます。Google Cloud CLI を使用して、ターミナルまたは Cloud Shell からアプリケーションに登録できるサービスまたはワークロードを一覧表示します。サービスとワークロードでは、コマンドが少し異なります。

サービスを登録する

  1. アプリケーションに登録可能なサービスを一覧表示します。

    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_ID
      • service_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'}
    
  2. 出力からサービス ID SERVICE_ID をコピーします。

  3. アプリケーションにサービスを登録します。

    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_EMAIL
    

    SERVICE_NAME は、サービスをアプリケーションに登録するために使用する名前に置き換えます。

    --criticality-type などのオプション フラグを使用して、サービスの最上位属性を定義し、検出可能性とガバナンスをサポートします。

    必須フラグとオプション フラグを次のように置き換えます。

    • 必須: PROJECT_ID: 管理プロジェクトの ID。
    • 必須: APPLICATION_LOCATION: アプリケーションのロケーション。次の値のいずれかを使用できます。

      • アプリケーションがリージョンの場合は、App Hub でサポート対象の地域名を指定します。
      • アプリケーションがマルチリージョンの場合は、us または eu を指定します。
      • アプリケーションがグローバルの場合は、global を使用します。
    • 必須: APPLICATION_NAME: サービスを登録するアプリケーションの名前。

    • 必須: REGION: 前の出力から検出されたサービス。

    • 必須: SERVICE_ID: 前の出力からコピーしたサービス ID。

    • 省略可: SERVICE_DISPLAY_NAME: サービスの表示名。

    • 省略可: CRITICALITY: オペレーションにおけるサービスの重要度。次の値のいずれかを使用できます。

      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • 省略可: ENVIRONMENT: ソフトウェア ライフサイクルのステージ。次の値のいずれかを使用できます。

      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • 省略可: DEV_NAME と DEV_EMAIL: デベロッパー オーナーの表示名とメールアドレス。

    • 省略可: OPERATOR_NAME と OPERATOR_EMAIL: オペレーター オーナーの表示名とメールアドレス。

    • 省略可: BUSINESS_NAME と BUSINESS_EMAIL: ビジネス オーナーの表示名とメールアドレス。

  4. アプリケーション内の登録済みサービスを一覧表示します。

    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
    

ワークロードを登録する

  1. アプリケーションに登録できる利用可能なワークロードを一覧表示します。

    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'}
    
  2. 出力からワークロード ID WORKLOAD_ID をコピーします。

  3. ワークロードをアプリケーションに登録します。

    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_EMAIL
    

    WORKLOAD_NAME は、ワークロードをアプリケーションに登録するために使用する名前に置き換えます。

    --criticality-type などのオプション フラグを使用して、ワークロードの最上位の属性を定義し、検出可能性とガバナンスをサポートします。

    必須フラグとオプション フラグを次のように置き換えます。

    • 必須: PROJECT_ID: 管理プロジェクトの ID。
    • 必須: APPLICATION_LOCATION: アプリケーションのロケーション。次の値のいずれかを使用できます。

      • アプリケーションがリージョンの場合は、App Hub でサポート対象の地域名を指定します。
      • アプリケーションがマルチリージョンの場合は、us または eu を指定します。
      • アプリケーションがグローバルの場合は、global を使用します。
    • 必須: APPLICATION_NAME: ワークロードを登録するアプリケーションの名前。

    • 必須: REGION: 前の出力で検出されたワークロードのロケーション。

    • 必須: WORKLOAD_ID: 前の出力からコピーしたワークロード ID。

    • 省略可: WORKLOAD_DISPLAY_NAME: ワークロードの表示名。

    • 省略可: CRITICALITY: オペレーションにおけるワークロードの重要度。次の値のいずれかを使用できます。

      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • 省略可: ENVIRONMENT: ソフトウェア ライフサイクルのステージ。次の値のいずれかを使用できます。

      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • 省略可: DEV_NAME と DEV_EMAIL: デベロッパー オーナーの表示名とメールアドレス。

    • 省略可: OPERATOR_NAME と OPERATOR_EMAIL: オペレーター オーナーの表示名とメールアドレス。

    • 省略可: BUSINESS_NAME と BUSINESS_EMAIL: ビジネス オーナーの表示名とメールアドレス。

  4. アプリケーション内の登録済みワークロードを一覧表示します。

    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 リソースを使用して、サービスまたはワークロードを登録します。

サービスを登録する

  1. URI を使用してサービスに関する情報を取得します。

    data "google_apphub_discovered_service" "my-service" {
        location = "LOCATION"
        service_uri = "SERVICE_URI"
    }
    
  2. 検出されたサービスをアプリケーションに登録します。次に例を示します。

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

ワークロードを登録する

  1. URI を使用してワークロードに関する情報を取得します。

    data "google_apphub_discovered_workload" "my-workload" {
        location = "LOCATION"
        workload_uri = "WORKLOAD_URI"
    }
    
  2. 検出されたワークロードをアプリケーションに登録します。次に例を示します。

    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 つのユニットとして管理する必要があります。

  1. アクセスニーズに応じて、個々のアプリケーションまたはすべてのアプリケーションに権限を付与できます。推奨されるロールの一覧については、ユーザーにアプリケーション中心のロールを付与するをご覧ください。
  2. 必要に応じて、Cloud Hub に移動して、定義したアプリケーションの統合オペレーション ダッシュボード(健全性、パフォーマンス、費用データなど)を表示します。