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 コンソールからアプリケーションをデプロイするをご覧ください。

始める前に

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

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

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

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

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

  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_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

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

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

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

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

次のステップ