アプリケーションのデプロイ

テンプレートからアプリケーションのドラフトを作成したら、アプリケーションをデプロイできます。App Design Center を使用してアプリケーションをデプロイすると、アプリケーションは App Hub に自動的に登録されます。デプロイ プロセスでは、次のことができます。

  • Terraform がインフラストラクチャに加える予定の変更をプレビューする。
  • アプリケーションに必要なリソース API を有効にする。 Google Cloud
  • デプロイに関する問題を調査する。
  • テレメトリー データを使用してリソースのパフォーマンスを分析する。
  • テンプレート リビジョンを特定してアプリケーションに適用する。

このドキュメントでは、テンプレート リビジョンをデプロイ、管理、アプリケーションに適用する方法について説明します。

始める前に

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

タスク 必要なロール
アプリケーションをデプロイしてテンプレート リビジョンを適用する アプリケーション管理者（roles/designcenter.applicationAdmin）、または
アプリケーション オペレーター（roles/designcenter.applicationOperator）
デプロイ時にサービス アカウントを自動的に作成する プロジェクト IAM 管理者（roles/resourcemanager.projectIamAdmin）

既存のサービス アカウントを使用してアプリケーションをデプロイするには、サービス アカウントにロールを付与するをご覧ください。

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

アプリケーションをデプロイする

サービス アカウントのオプションを選択して、アプリケーションをデプロイします。アプリケーションをデプロイすると、 リソースが作成され、それらのリソースに関連する料金が発生し始めます。 Google Cloud

デザイン キャンバス

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

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

  2. 表からアプリケーション名 をクリックします。

  3. [アプリケーションの詳細] ページで詳細を確認し、[編集] をクリックして変更します。

  4. [デプロイ] をクリックします。

  5. 次のいずれかのサービス アカウントを選択して、アプリケーションをデプロイします。

    • [**サービス アカウントを選択**]: [**サービス アカウント**] フィールドに、 既存のサービス アカウントの名前を入力します。サービス アカウントを構成するには、サービス アカウントにロールを付与するをご覧ください。

    • [**新しいサービス アカウントを作成**]: サービス アカウントに必要なデプロイロールを割り当てるために使用されるプロジェクト IAM 管理者 (roles/resourcemanager.projectIamAdmin) ロールが必要です。

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

  7. Terraform がインフラストラクチャに加える予定の変更をプレビューするには、次の操作を行います。

    1. [プレビュー] をクリックします。

    2. 変更内容を確認し、[コピーして閉じる] をクリックします。プレビューがクリップボードにコピーされます。

    3. プレビューを保存するには、任意のドキュメントに貼り付けて保存します。

  8. [API の確認] 領域で、アプリケーションに必要な API のリストを確認します。API はデプロイ時に自動的に有効になります。

  9. [デプロイ] をクリックします。デプロイが完了すると、アプリケーションの詳細とデプロイ ステータスが表示されます。

  10. デプロイに問題がある場合は、次の操作を行います。

    1. [アプリケーションの詳細] パネルで [デプロイ] をクリックします。

    2. エラー メッセージを確認します。

    3. [ログを表示] をクリックして、ビルドの詳細情報を表示します。

    4. デプロイ エラーを修正するための提案を表示するには、[デプロイのトラブルシューティング] (プレビュー) をクリックします。

      詳細については、デプロイに関する問題のトラブルシューティングと解決をご覧ください。

  11. デプロイしたアプリケーションを管理するには、アプリケーションの詳細を表示するをご覧ください。

gcloud CLI

  1. デプロイする前にアプリケーションをプレビューして、Terraform コードを表示します。 このオペレーションが完了するまでに数分かかることがあります。次のいずれかを行います。

    • サービス アカウントを自動的に作成するには、次のコマンドを使用します。

      gcloud design-center spaces applications preview APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--create-sa \
--service-account=SERVICE_ACCOUNT

    • 独自のサービス アカウントを使用するには、次のコマンドを使用します。

      gcloud design-center spaces applications preview APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--service-account=SERVICE_ACCOUNT

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

    • APPLICATION: アプリケーション ID。
    • PROJECT: 管理プロジェクト ID。
    • LOCATION: アプリケーション リージョン。
    • SPACE: スペース ID。
    • SERVICE_ACCOUNT: 次のいずれかを行います。
      • 新しいサービス アカウントを作成するには、サービス アカウントの名前を指定します。
      • 独自のサービス アカウントを使用するには、projects/PROJECT/serviceAccounts/EMAIL_ADDRESS の形式で完全なリソース名を指定します。

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

  2. アプリケーションを非同期でデプロイし、オペレーションの完全な名前をコピーします。次のいずれかを行います。

    • サービス アカウントを自動的に作成するには、次のコマンドを使用します。

       gcloud design-center spaces applications deploy APPLICATION \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE \
 --create-sa \
 --service-account=SERVICE_ACCOUNT \
 --async

    • 独自のサービス アカウントを使用するには、次のコマンドを使用します。

       gcloud design-center spaces applications deploy APPLICATION \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE \
 --service-account=SERVICE_ACCOUNT \
 --async

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

    • APPLICATION: アプリケーション ID。
    • PROJECT: 管理プロジェクト ID。
    • LOCATION: アプリケーション リージョン。
    • SPACE: スペース ID。
    • SERVICE_ACCOUNT: 次のいずれかを行います。
      • 新しいサービス アカウントを作成するには、サービス アカウントの名前を指定します。
      • 独自のサービス アカウントを使用するには、projects/PROJECT/serviceAccounts/EMAIL_ADDRESS の形式で完全なリソース名を指定します。

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

  3. デプロイが完了するまでに数分かかります。デプロイ ステータスを追跡します。

    gcloud design-center operations describe OPERATION\
--project=PROJECT \
--location=LOCATION

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

    • OPERATION: コマンドの出力からコピーされたオペレーションの完全な名前（projects/PROJECT/locations/LOCATION/operations/operation-<var>OPERATION_ID</var> の形式）。deploy
    • PROJECT: 管理プロジェクト ID。
    • LOCATION: アプリケーション リージョン。

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

デプロイに関する問題のトラブルシューティングと解決

アプリケーションのデプロイが失敗した場合は、エラーの概要を表示し、詳細な分析を取得して、解決手順を特定し、一部の問題を自動的に修正できます。

エラーのトラブルシューティングと修正を行うには、次の操作を行います。

  1. [アプリケーションの詳細] パネルで [デプロイ] をクリックします。

  2. エラーを分析して修正を提案するには、[デプロイのトラブルシューティング] をクリックします。

    [トラブルシューティングの詳細] パネルには、ドキュメントの提案、構成の変更、デプロイ エラーの解決に役立つその他の情報が表示されます。

  3. デプロイ エラーと推奨事項を確認します。

    1. 分析の結果、コンポーネント構成の推奨事項が表示された場合は、提案された変更を確認し、[アプリケーションを更新] をクリックして変更を適用します。

    2. 分析の結果、他の推奨事項が表示された場合は、エラーを解決するために実行できる gcloud CLI コマンドが表示されます。Cloud Shell で gcloud CLI コマンドを実行するには、[コマンドを実行] をクリックします。

アプリケーションの詳細を表示する

アプリケーションのデプロイが完了したら、関連情報を確認できます。たとえば、次のような情報を表示できます。

  • 最終更新時刻、リビジョン日、リージョンなどの詳細。
  • サービス URI などの出力。
  • デプロイ ステータス、エラー情報、ログへのリンク。

アプリケーションの詳細を表示する手順は次のとおりです。

デザイン キャンバス

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

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

  2. 表からアプリケーション名 をクリックします。[アプリケーションの詳細] パネルに次の情報が表示されます。

    • [**App Hub でアプリを表示**]: App Hub でアプリケーションを調査します。デプロイされたリソースを表示し、テレメトリー データを調べて、問題を診断してパフォーマンスを分析できます。詳細については、App Hub アプリケーションをモニタリングするをご覧ください。

    • [**アプリの詳細**]: 最終更新日、ソース テンプレート、リージョン、サービス アカウントなどの情報を表示します。

    • [出力]: アプリケーションのフロントエンドまたはバックエンドとのやり取りに使用できるサービス URI を特定します。

    • [**デプロイ**]: デプロイ ステータス、デプロイ エラー、 ログへのリンクを確認して、エラーのトラブルシューティングを行います。

gcloud CLI 

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

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

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

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

デプロイしたアプリケーションを変更する

デプロイしたアプリケーションを変更する場合は、アプリケーションを再デプロイしたときに変更が保持されるように、次のいずれかを行います。

テンプレート リビジョンを適用する

アプリケーションが App Design Center を使用して以前にデプロイされ、管理者がテンプレート リビジョンを共有している場合は、テンプレートの変更をアプリケーションに適用できます。アプリケーションを更新すると、アプリケーション リビジョンが作成されます。修正されたテンプレートに追加または変更されたコンポーネントを構成できます。

Cloud Hub を使用して、アプリケーションで使用可能なテンプレート リビジョンを表示できます。詳細については、デプロイを表示するをご覧ください。

テンプレート リビジョンをアプリケーションに適用する手順は次のとおりです。

デザイン キャンバス

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

    [テンプレート] に移動

  2. 適用するリビジョンを含むテンプレート ID をクリックします。

  3. [アプリを構成] リストから、更新するアプリケーションを選択します。

  4. アプリケーションの詳細を編集し、[保存] をクリックします。

  5. デザイン キャンバスで各コンポーネントをクリックし、コンポーネント構成を変更します。

  6. [デプロイ] をクリックします。デプロイの手順については、アプリケーションをデプロイするをご覧ください。

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 update APPLICATION \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE \
 --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION

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

    • APPLICATION: アプリケーション ID。
    • PROJECT: 管理プロジェクト ID。
    • LOCATION: アプリケーション リージョン。
    • SPACE: スペース ID。
    • SOURCE_APPLICATION_TEMPLATE_REVISION: アプリケーション テンプレート URI。例: projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISION

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

  4. アプリケーションで新しいコンポーネントまたは更新されたコンポーネントを構成するには、コンポーネントと接続を構成するをご覧ください。

  5. アプリケーションをデプロイするときは、--replace フラグを使用します。デプロイの手順については、アプリケーションをデプロイするをご覧ください。

次のステップ