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

Application Design Center でテンプレートからアプリケーションの下書きを作成すると、テスト環境や本番環境などの環境ごとに個別のアプリケーション インスタンスをカスタマイズしてデプロイできます。アプリケーションの下書きを作成するときに、アプリケーションを分類してフィルタリングする属性を指定し、コンポーネントと接続を構成します。必要に応じて、生成された Terraform コードを編集します。要件の変更に応じて新しいリビジョンを作成することもできます。また、デプロイされたリソースが不要になった場合は、アプリケーションを削除することもできます。

始める前に

このドキュメントのタスクを実行するには、次の表に示すように、アプリ対応フォルダまたは管理プロジェクトに必要なロールを付与するよう管理者に依頼してください。

タスク 必要なロール
アプリケーションの下書きの作成、構成、編集、バージョニング Application Design Center 管理者(roles/designcenter.admin)、または
アプリケーション管理者(roles/designcenter.applicationAdmin)、または
アプリケーション編集者(roles/designcenter.applicationEditor)
アプリケーションを削除する Application Design Center 管理者(roles/designcenter.admin)、または
アプリケーション管理者(roles/designcenter.applicationAdmin)

ロールの詳細については、IAM を使用したアクセス制御をご覧ください。

アプリケーションのドラフトを作成する

詳細を指定し、必要に応じてコンポーネント構成をオーバーライドして、テンプレートからアプリケーションの下書きを作成します。その後、ドラフトをデプロイしてアプリケーションを作成できます。

デザイン キャンバス

  1. ナビゲーション メニューから、次のいずれかを行います。

  2. 使用するテンプレート ID をクリックします。

  3. デザイン キャンバスで、[アプリの設定] をクリックします。次に、[新しいアプリケーションを作成] をクリックします。

  4. [アプリケーション名] 領域で、次の操作を行い、アプリケーションの名前と説明を入力します。

    1. [名前] フィールドに、このスペースの一意の識別子を入力します。たとえば、web-app-staging のような一意の名前と環境の組み合わせを使用します。これは必須項目です。

      英小文字、数字、ハイフンを含む最大 63 文字を使用できます。名前は小文字で始まる必要があり、末尾をハイフンにすることはできません。名前は変更できません。

    2. [表示名] フィールドに、Google Cloud コンソールに表示する名前を入力します。

    3. [説明] フィールドに、このアプリケーションの目的を入力します。

  5. [プロジェクト ID] フィールドが空のコンポーネントにデフォルトのプロジェクトを設定するには、[デプロイ プロジェクト] リストからプロジェクトを選択します。フォルダレベルの境界では、プロジェクトに次の資格が必要です。

    コンポーネントの [プロジェクト ID] フィールドにプロジェクトがすでに指定されている場合は、この設定ではなく、そのプロジェクトが使用されます。

  6. [リージョン] リストから、コンポーネントがデプロイされているリージョンを選択します。コンポーネントのリージョンは、次の条件に基づいて適用されます。

    • アプリケーションのスコープが [グローバル](デフォルト)の場合、リージョンがまだ構成されていないコンポーネントにリージョンが適用されます。

    • アプリケーションのスコープがリージョンの場合、リージョンはすべてのコンポーネントに適用されます。

  7. [Environment] リストから、このアプリケーションをデプロイする環境を選択します。たとえば、TEST でデプロイが想定どおりに動作することを確認する場合などです。

  8. [重要度] リストで、ビジネスへの影響度を選択します。たとえば、LOW や HIGH です。

  9. オーナーを指定するには、[オーナー] 領域で [オーナーを追加] をクリックし、次の表示名とメールを入力します。

    • [ビジネス オーナー] 領域に、品質とユーザーの期待に責任を持つオーナーを入力します。

    • [デベロッパー オーナー] 領域に、開発とコーディングを担当するオーナーを入力します。

    • [オペレーター オーナー] 領域に、アプリケーションの運用を担当するオーナーを入力します。

  10. [スコープ] リストから、次のいずれかを選択します。

    • グローバル(デフォルト): アプリケーションにグローバル リソースが含まれているか、リソースが複数のリージョンに存在します。

    • リージョン: すべてのリソースが単一のリージョンにあります。

    これは必須項目です。詳細については、グローバル、マルチリージョン、リージョン アプリケーションをご覧ください。

  11. [アプリケーションを作成] をクリックします。アプリケーションの詳細が表示されます。

gcloud CLI

  1. アプリケーションの作成に使用するテンプレートのアプリケーション テンプレート リビジョン URI を特定します。

     gcloud design-center spaces application-templates describe APPLICATION_TEMPLATE \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --format='yaml(name,latestRevision)'
    

    次のように置き換えます。

    • APPLICATION_TEMPLATE: アプリケーションのベースとして使用するアプリケーション テンプレートのテンプレート ID。
    • PROJECT: 実際の管理プロジェクト ID。
    • LOCATION: アプリケーション テンプレートのリージョン。
    • SPACE: スペース ID。

    詳細については、gcloud design-center spaces application-templates describe をご覧ください。

  2. latestRevision の出力をコピーします。

  3. テンプレートに基づいてアプリケーションのドラフトを作成します。

      gcloud design-center spaces applications create APPLICATION \
      --project=PROJECT \
      --location=LOCATION \
      --space=SPACE \
      --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION \
      --scope-type=SCOPE_TYPE
    

    次のように置き換えます。

    • APPLICATION: 作成するアプリケーション ドラフトのアプリケーション ID。
    • PROJECT: 実際の管理プロジェクト ID。
    • LOCATION: アプリケーションのリージョン。
    • SPACE: スペース ID。
    • SOURCE_APPLICATION_TEMPLATE_REVISION: アプリケーション テンプレートのリビジョン URI(projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISION など)。
    • SCOPE_TYPE: アプリケーションのスコープ。regional、global のいずれかです。アプリケーション スコープが global の場合、リージョンがまだ構成されていないコンポーネントにリージョンが適用されます。アプリケーション スコープが regional の場合、リージョンはすべてのコンポーネントに適用されます。

    詳細については、gcloud design-center spaces applications create をご覧ください。

コンポーネントと接続を構成する

アプリケーションのコンポーネントごとに、リソースが作成されるプロジェクトやデプロイされるロケーションなどの構成の詳細を指定できます。

デフォルトの構成が要件を満たしていない場合は、接続の詳細を変更することもできます。たとえば、環境変数のキー名の変更、接続ポートの変更、サービス アカウントへのロールの追加などを行うことができます。

サポートされているリソースごとに必要な詳細を構成する必要があります。

コンポーネントと接続を構成する手順は次のとおりです。

デザイン キャンバス

  1. デザイン キャンバスで、コンポーネントをクリックします。

  2. [構成] 領域の [プロジェクト ID] リストで、リソースをデプロイするプロジェクトを選択します。次の条件を満たすプロジェクトを選択します。

  3. リソースの追加設定を構成します。たとえば、Cloud SQL の場合は、次のように構成します。

    • リージョン
    • バックアップ構成
    • データベース フラグ
    • IP 構成

    各コンポーネントの構成ドキュメントへのリンクについては、サポートされているリソースをご覧ください。

  4. デザイン キャンバスでコンポーネントを接続すると、デフォルトの構成値を使用して接続が作成されます。接続の詳細を追加または変更する手順は次のとおりです。

    1. デザイン キャンバスで、2 つのコンポーネント間の接続をクリックします。[接続] パネルが開き、接続パラメータが表示されます。

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

      • 既存の接続パラメータを変更するには、[編集] をクリックします。

      • 新しい接続パラメータを追加するには、[パラメータを追加] をクリックします。

    3. [キー] フィールドと [値] フィールドを更新します。たとえば、次の詳細を変更できます。

      • アプリケーションの要件に合わせて調整する環境変数のキー名。
      • 接続ポートの値。
      • サービス アカウントに追加されたロール。
  5. [保存] をクリックします。

gcloud CLI

  1. アプリケーションを記述してコンポーネント パラメータを表示し、アプリケーションに必要なパラメータを特定します。

     gcloud design-center spaces applications describe APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --format='yaml(name,componentParameters)'
    

    次のように置き換えます。

    • APPLICATION: アプリケーション ID。
    • PROJECT: 実際の管理プロジェクト ID。
    • LOCATION: アプリケーションのリージョン。
    • SPACE: スペース ID。

    詳細については、gcloud design-center spaces applications describe をご覧ください。

  2. 変更するコンポーネントごとに、パラメータ値を含む JSON ファイルをホーム ディレクトリに作成します。

    たとえば、Cloud Run コンポーネント用に次のファイルを作成します。

      {
        "component": "projects/PROJECT/locations/us-central1/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/components/COMPONENT",
        "parameters": [
           {
              "key": "service_name",
              "value": "frontend-service"
           },
           {
              "key": "project_id",
              "value": "DEPLOYMENT_PROJECT"
           }
        ]
      }
    
  3. 必要なパラメータを構成するようにアプリケーションを更新します。

     gcloud design-center spaces applications update APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --component-parameters=COMPONENT_FILE_PATH_1
    

    次のように置き換えます。

    • APPLICATION: アプリケーション ID。
    • PROJECT: 実際の管理プロジェクト ID。
    • LOCATION: アプリケーションのリージョン。
    • SPACE: スペース ID。
    • COMPONENT_FILE_PATH_1: コンポーネント パラメータを含む JSON ファイルのパス。追加の JSON ファイルごとに、別の --component-parameters フラグと値を追加します。

    詳細については、gcloud design-center spaces applications update をご覧ください。

デプロイ手順については、アプリケーションをデプロイするをご覧ください。

セキュリティ コンプライアンスを確認する

アプリケーションのセキュリティ評価を実行して、Security Command Center フレームワークに照らして構成を検証できます。この包括的な評価では、次の項目が評価されます。

  • コンポーネント構成値: テンプレートから自動的に継承された構成設定、またはこのアプリケーション用に変更した設定。
  • アプリケーション パラメータ: デプロイ リージョンや環境など、アプリケーションに指定されたインスタンス固有の詳細。
  • 許可されたコンポーネント: 組織で使用が許可されている現在のアプリケーションのサービスとワークロード。

アプリケーションは、テンプレートから Security Command Center フレームワークを継承します。まず、管理者がアプリケーション テンプレートにセキュリティ フレームワークを接続する必要があります。次に、アプリケーションからセキュリティ コンプライアンスを評価する手順は次のとおりです。

gcloud CLI

アプリケーションの評価レポートを生成します。

gcloud alpha design-center spaces applications generate-assessment-report \
    APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE

次のように置き換えます。

  • APPLICATION: 評価するアプリケーションのアプリケーション ID。
  • PROJECT: 実際の管理プロジェクト ID。
  • LOCATION: アプリケーションのリージョン。
  • SPACE: スペース ID。

出力には、テンプレートにアタッチされたフレームワークに基づいて、アプリケーションの評価レポートが表示されます。詳細については、gcloud alpha design-center spaces applications generate-assessment-report をご覧ください。

Terraform コードを編集する

アプリケーションは、設計と構成の詳細を反映する Terraform コードを生成します。Terraform を編集して、コンポーネントの構成の詳細を指定できます。

システムによって次の Terraform ファイルが生成されます。

  • main.tf: テンプレート内の各コンポーネントのモジュールを含むインフラストラクチャ コード。
  • outputs.tf: デプロイされているインフラストラクチャ コンポーネントに関する情報を公開します。
  • variables.tf: main.tf ファイルで使用される変数の名前、型、説明を宣言します。
  • input.tfvars: main.tf ファイルで使用される変数の値を定義します。
  • providers.tf: Terraform が Google Cloud API とリソースを操作する際に役立つラベルを定義します。

背景情報については、Google Cloudでの Terraform の概要をご覧ください。

Terraform コードを編集する手順は次のとおりです。

  1. デザイン キャンバスで、[コード] をクリックします。生成された Terraform ファイルが表示されます。

  2. [main.tf] をクリックします。各コンポーネントの Terraform モジュールが表示されます。

  3. 構成の詳細を編集します。詳細については、サポートされている各リソースの構成ドキュメントをご覧ください。

    編集内容は自動的に検証され、無効な編集がある場合はエラーが表示されます。

  4. 編集内容をハイライト表示して比較する手順は次のとおりです。

    1. [差分を表示] をクリックします。

    2. 変更を元に戻すには、マージンで [クリックして変更を元に戻す] をクリックします。

    3. [差分を表示] をクリックして、比較ビューを閉じます。

  5. 編集内容を保存するには、[コードの変更を保存] をクリックします。

  6. 変更を確認するには、次の操作を行います。

    1. [デザイン] をクリックします。
    2. コンポーネントをクリックして、構成の詳細を確認します。

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

アプリケーション リビジョンを作成して、詳細またはコンポーネントを変更します。App Design Center の外部でアプリケーション コンポーネントを変更した場合、再デプロイ時にそれらの変更は保持されません。

アプリケーション リビジョンを作成するには、次の操作を行います。

デザイン キャンバス

  1. ナビゲーション メニューで [アプリケーション] をクリックします。

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

  2. 表で、修正するアプリケーション名をクリックします。

  3. アプリケーションの詳細を変更するには、次の操作を行います。

    1. [編集] をクリックして詳細を変更します。
    2. [保存] をクリックして、変更を保存します。
  4. このアプリケーションのコンポーネントを変更するには、次の操作を行います。

    1. デザイン キャンバスでコンポーネントをクリックし、[構成] 領域で詳細を編集します。

    2. [保存] をクリックして、変更を保存します。

gcloud CLI

コンポーネントと接続を構成するをご覧ください。

デプロイ手順については、アプリケーションをデプロイするをご覧ください。

アプリケーションを削除する

不要になったアプリケーションは削除できます。たとえば、アプリケーションをデプロイして TEST 環境でテンプレートを検証し、アプリケーションを削除できます。

次のアプリケーションを削除できます。

  • デプロイされていないアプリケーション。[アプリケーション] ページで、[ステータス] が [下書き] と表示されます。
  • TEST、DEVELOPMENT、または STAGING の環境にデプロイされたアプリケーション。

アプリケーションを削除すると、次のようになります。

  • App Design Center からアプリケーションの詳細が削除されます。
  • 基盤となる App Hub アプリケーションが削除されます。
  • デプロイした場合は、リソースが削除されます。

アプリケーションを削除するには、次の操作を行います。

デザイン キャンバス

  1. ナビゲーション メニューで [アプリケーション] をクリックします。

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

  2. 表で [アプリケーション名] をクリックします。

  3. [アクション] をクリックして、[アプリケーションを削除] を選択します。

  4. [削除] フィールドにアプリケーション名を入力します。

  5. [削除] をクリックします。

gcloud CLI

アプリケーションを削除する。

    gcloud design-center spaces applications delete APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE

次のように置き換えます。

次のステップ