Terraform をダウンロードしてデプロイする

Application Design Center を使用すると、テンプレートとアプリケーションの Terraform コードを生成して、ローカルマシンまたは GitHub リポジトリにエクスポートできます。

Terraform コードをエクスポートすると、独自の CI / CD ツールを使用してアプリケーションを維持、デプロイできます。エクスポートされた Terraform ファイルは、App Hub にアプリケーションを自動的に登録し、Security Command Center でランタイム モニタリングを有効にします。外部にデプロイされたアプリケーションは、管理対象外のアプリケーションとして扱われます。設計時のセキュリティ評価やセキュリティ検出結果のソースへのトレースなどのマネージド アプリケーション中心の Google Cloud 機能を使用するには、App Design Center を使用してアプリケーションをデプロイします。

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

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

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

始める前に

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

タスク 必要なロール
生成された Terraform コードをローカルまたはソース管理リポジトリにエクスポートする アプリケーション管理者(roles/designcenter.applicationAdmin)、または
アプリケーション編集者(roles/designcenter.applicationEditor)

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

Terraform コードをエクスポートする

Google Cloudの外部でテンプレートとアプリケーションを管理する場合は、Terraform を生成してローカルマシンまたはコード リポジトリにエクスポートできます。

ローカルにエクスポートする

テンプレートまたはアプリケーションから生成された Terraform コードをエクスポートできます。

テンプレート

  1. Google Cloud コンソールで、[テンプレート] ページに移動します。

    [テンプレート] に移動

  2. エクスポートするテンプレート ID をクリックします。

  3. [Get Code] をクリックします。

    ZIP ファイルがローカルのパソコンにダウンロードされます。独自のデプロイツールとワークフローを使用してアプリケーションをデプロイできます。

アプリケーション

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

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

  2. エクスポートするアプリケーション名をクリックします。

  3. [Get Code] をクリックします。

    ZIP ファイルがローカルのパソコンにダウンロードされます。独自のデプロイツールとワークフローを使用してアプリケーションをデプロイできます。

リポジトリにエクスポートする

ソースコード管理リポジトリでテンプレートを管理するには、テンプレートとアプリケーションを GitHub にエクスポートします。その後、既存のバージョン管理ワークフローを使用し、独自の CI / CD パイプラインを使用してビルド、テスト、デプロイをトリガーできます。

リポジトリに接続する

GitHub リポジトリと管理プロジェクトの間に Developer Connect 接続を作成するには、次の操作を行います。

  1. 組織のポリシーを変更して、次のサービスを許可リストに追加します。

    1. developerconnect.googleapis.com。
    2. secretmanager.googleapis.com。

    組織のポリシーを変更する手順については、リソース サービスの使用を制限する制約の使用をご覧ください。

  2. GitHub リポジトリへの Developer Connect 接続を作成します。これには次のものが含まれます。

    1. [データ所在地を有効にする] を選択します。
    2. アプリケーションをエクスポートするリポジトリをリンクします。

    接続を作成してリポジトリをリンクする手順については、GitHub を接続するをご覧ください。

  3. リポジトリ URI をコピーする手順は次のとおりです。

    1. [Developer Connect Git リポジトリ] ページを開きます。
    2. [リポジトリ] テーブルで、[その他のオプション] をクリックし、[リソースパスをコピー] を選択します。

生成してエクスポート

Terraform コードを生成して GitHub リポジトリにエクスポートする手順は次のとおりです。

テンプレート

  1. スペース ID を特定します。

    gcloud design-center spaces list \
        --project=PROJECT \
        --location=LOCATION
    

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

  2. エクスポートするテンプレートのテンプレート ID を特定します。

    gcloud design-center spaces application-templates list \
        --space=SPACE \
        --project=PROJECT \
        --location=LOCATION
    

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

  3. テンプレートの Terraform コードを生成し、GitHub にエクスポートします。

    gcloud design-center spaces application-templates generate APPLICATION_TEMPLATE \
        --space=SPACE \
        --project=PROJECT \
        --location=LOCATION \
        --developer-connect-export-config-repo-uri=DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI \
        --developer-connect-export-config-dir=DEVELOPER_CONNECT_EXPORT_CONFIG_DIR \
        --developer-connect-export-config-branch=DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH
    

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

    • APPLICATION_TEMPLATE: エクスポートするテンプレートのテンプレート ID。
    • SPACE: スペース ID。
    • PROJECT: 実際の管理プロジェクト ID。
    • LOCATION: 地域 ID。
    • DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI: リポジトリに接続するでコピーした Developer Connect リポジトリのリソースパス(projects/my-project/locations/us-central1/connections/my-connection/gitRepositoryLinks/my-repo など)。リポジトリ リンクは、スペースと同じロケーション(LOCATION)に存在する必要があります。
    • DEVELOPER_CONNECT_EXPORT_CONFIG_DIR: GitHub リポジトリのルートからの相対ディレクトリ パス(terraform/my-template など、ルート ディレクトリの場合は /)。
    • DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH: GitHub リポジトリのブランチ。

    詳細については、gcloud design-center spaces application-templates generate コマンドをご覧ください。

  4. リポジトリを表示して、テンプレートが正常にエクスポートされたことを確認します。

アプリケーション

  1. スペース ID を特定します。

    gcloud design-center spaces list \
        --project=PROJECT \
        --location=LOCATION
    

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

  2. エクスポートするアプリケーションのアプリケーション ID を特定します。

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

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

  3. アプリケーションの Terraform コードを生成し、GitHub にエクスポートします。

    gcloud design-center spaces applications generate APPLICATION \
        --space=SPACE \
        --project=PROJECT \
        --location=LOCATION \
        --developer-connect-export-config-repo-uri=DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI \
        --developer-connect-export-config-dir=DEVELOPER_CONNECT_EXPORT_CONFIG_DIR \
        --developer-connect-export-config-branch=DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH
    

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

    • APPLICATION: エクスポートするアプリケーションのアプリケーション ID。
    • SPACE: スペース ID。
    • PROJECT: 実際の管理プロジェクト ID。
    • LOCATION: 地域 ID。
    • DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI: リポジトリに接続するでコピーした Developer Connect リポジトリのリソースパス(projects/my-project/locations/us-central1/connections/my-connection/gitRepositoryLinks/my-repo など)。リポジトリ リンクは、スペースと同じロケーション(LOCATION)に存在する必要があります。
    • DEVELOPER_CONNECT_EXPORT_CONFIG_DIR: GitHub リポジトリのルートからの相対ディレクトリ パス(terraform/my-app など、ルート ディレクトリの場合は /)。
    • DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH: GitHub リポジトリのブランチ。

    詳細については、gcloud design-center spaces applications generate コマンドをご覧ください。

  4. リポジトリを表示して、アプリケーションが正常にエクスポートされたことを確認します。

次のステップ