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

独自のデプロイ ツールとワークフローがある場合は、テンプレートまたはアプリケーションを Terraform ファイルとしてダウンロードできます。

システムは次の Terraform ファイルを生成します。

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

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

独自のデプロイ ツールとワークフローがない場合は、Google Cloud コンソールからアプリケーションをデプロイするをご覧ください。

始める前に

アプリ対応フォルダまたは管理プロジェクトに対する次のいずれかのロールを付与するよう管理者に依頼します。

  • アプリケーション管理者（roles/designcenter.applicationAdmin）。
  • アプリケーション編集者（roles/designcenter.applicationEditor）。

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

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

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

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

テンプレート

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

    [テンプレート] に移動

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

  3. [コードを取得] をクリックします。

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

アプリケーション

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

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

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

  3. [コードを取得] をクリックします。

    ローカルのパソコンに 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

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

    • PROJECT: 管理プロジェクト ID。
    • LOCATION: ロケーション ID。

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

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

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

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

  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_DIR: GitHub リポジトリからの相対ディレクトリ。
    • 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

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

    • PROJECT: 管理プロジェクト ID。
    • LOCATION: ロケーション ID。

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

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

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

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

  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_DIR: GitHub リポジトリからの相対ディレクトリ。
    • DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH: GitHub リポジトリのブランチ。

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

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

次のステップ

Google Cloudでの Terraform の概要