Terraform を使用して VPC をデプロイする
Virtual Private Cloud(VPC)ネットワークをデプロイするには、Infrastructure Manager とGoogle Cloud コンソールを使用します。このクイックスタートは、 Google Cloud インフラストラクチャをコードとして管理するクラウド管理者、プラットフォーム エンジニア、デベロッパーを対象としています。VPC ネットワークは、仮想マシン(VM)インスタンス、データベース、アプリなどのリソースに分離されたネットワーキングを提供します。
Infra Manager では、ネットワークを手動で作成するのではなく、Terraform 構成で定義します。Infra Manager は Terraform を実行し、Terraform の状態を保存します。その結果、インフラストラクチャを整合性を保ちながら再現、更新、削除できます。詳細については、 Google Cloudでの Terraform の概要をご覧ください。
このクイックスタートでは、公開 GitHub リポジトリの Terraform 構成からデプロイをプレビューして作成します。
始める前に
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Infrastructure Manager and Compute Engine APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.
必要なロール
このクイックスタートを完了するために必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。
- Cloud Infrastructure Manager 管理者(
roles/config.admin) - サービス アカウント管理者(
roles/iam.serviceAccountAdmin) - サービス アカウント ユーザー(
roles/iam.serviceAccountUser) - プロジェクト IAM 管理者(
roles/resourcemanager.projectIamAdmin) - Compute ネットワーク閲覧者(
roles/compute.networkViewer) - Cloud Build 閲覧者(
roles/cloudbuild.builds.viewer) - ストレージ オブジェクト閲覧者(
roles/storage.objectViewer)
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
デプロイをプレビューして作成する
デプロイを作成すると、Infra Manager は Terraform 構成で定義されているリソースをプロビジョニングします。デプロイを作成する前に、プレビューを作成して、Infra Manager がプロビジョニングを計画しているリソースを確認します。
VPC ネットワークをプロビジョニングするデプロイをプレビューして作成するには、次の操作を行います。
Google Cloud コンソールで、[Infrastructure Manager] ページに移動します。
[新しいデプロイを作成] をクリックします。
[新しい Terraform デプロイを作成する] ページの [デプロイの詳細] セクションで、次の値を入力します。
- デプロイ ID:
quickstart-preview - リージョン:
us-central1 - Terraform のバージョン:
1.5.7 サービス アカウント:
im-quickstart-saという名前の新しいサービス アカウントを作成します。サービス アカウントを作成して必要なロールを付与する手順は次のとおりです。- [サービス アカウント] リストで、[新しいサービス アカウント] をクリックします。[サービス アカウントの作成] ページが新しいタブで開きます。
- [サービス アカウント名] フィールドに「
im-quickstart-sa」と入力し、[作成して続行] をクリックします。 [このサービス アカウントにプロジェクトへのアクセスを許可する] セクションで、[ロールを選択] リストを使用して次のロールを付与します。2 つ目のロールを追加するには、 [別のロールを追加] をクリックします。
- Cloud Infrastructure Manager エージェント(
roles/config.agent): Infra Manager が Terraform を実行し、デプロイの状態とログを保存できるようにします。 - Compute ネットワーク管理者(
roles/compute.networkAdmin): Infra Manager が VPC ネットワークを作成して管理できるようにします。
Infra Manager のロールの詳細については、IAM を使用したアクセス制御をご覧ください。
- Cloud Infrastructure Manager エージェント(
[続行] をクリックして [完了] をクリックします。
タブを閉じて、[新しい Terraform デプロイの作成] ページに戻ります。
[サービス アカウント] リストで、 [リストを更新] をクリックし、[
im-quickstart-sa] を選択します。
Terraform 構成のソース: Git
Git リポジトリ:
https://github.com/terraform-google-modules/terraform-google-networkGit ディレクトリ:
modules/vpc
- デプロイ ID:
[続行] をクリックします。
[Terraform の詳細] セクションの [入力値] で、事前入力されたモジュール変数に次の値を入力します。
project_idキーの行の [値] フィールドに「<var>PROJECT_ID</var>」と入力します。引用符は含めないでください。network_nameキーの行の [値] フィールドに「quickstart-vpc」と入力します。引用符は含めないでください。
PROJECT_ID は、実際の Google Cloud プロジェクト ID に置き換えます。
[Create preview] をクリックします。
quickstart-preview-<var>UUID</var>プレビューの詳細ページで、[状態] 行の値が [成功] であることを確認します。プレビューの値を使用するデプロイを作成するには、[デプロイを作成] をクリックします。
[デプロイ ID] フィールドに「
quickstart-deployment」と入力します。[デプロイメントの作成] をクリックします。
Infra Manager が VPC ネットワークをプロビジョニングします。デプロイが完了すると、 Google Cloud コンソールに通知が届きます。
Infra Manager を使用してデプロイを作成しました。以降のセクションでは、デプロイを確認し、プロビジョニングされたネットワークを表示して、Terraform を実行した Cloud Build ジョブを確認します。
デプロイのステータスを表示する
Infra Manager がデプロイを作成すると、状態、最新のリビジョン、Terraform 構成のソースなどの詳細を表示できます。
デプロイの詳細を表示する手順は次のとおりです。
Google Cloud コンソールで、[Infrastructure Manager] ページに移動します。
[ID] 列で、[
quickstart-deployment] をクリックします。[デプロイの詳細] ページで、[状態] 行の値が [アクティブ] であることを確認します。
プロビジョニングされた VPC ネットワークを表示する
Infra Manager が Terraform 構成で定義されたネットワークをプロビジョニングしたことを確認するには、 Google Cloud コンソールでネットワークを表示します。
Google Cloud コンソールで、[VPC ネットワーク] ページに移動します。
ネットワークのリストには、Infra Manager がプロビジョニングしたネットワークである
quickstart-vpcが含まれています。このリストには、サブネット作成モード、最大伝送単位(MTU)、動的ルーティング モードなど、ネットワークの詳細が表示されます。サブネット、ファイアウォール ルール、ルートなど、ネットワークの詳細を表示するには、
quickstart-vpcをクリックします。
Cloud Build でビルド結果を表示する
Infra Manager は、Cloud Build を使用して、デプロイ リビジョンごとに Terraform を実行します。デプロイを作成した Terraform コマンドを検査する場合や、失敗したデプロイのトラブルシューティングを行う場合は、Cloud Build のビルドログを表示します。
Google Cloud コンソールで、[ビルド履歴] ページに移動します。
ビルドテーブルで、リージョン
us-central1の最新のビルドを見つけます。このリストには、quickstart-preview-<var>UUID</var>プレビューとquickstart-deploymentデプロイの両方のビルドが表示されます。ビルド ID をクリックして、[ビルドの詳細] ページを開きます。
[ビルドの詳細] ページには、各ビルドステップのステータスと、Terraform コマンドの出力を含むビルドログが表示されます。デプロイが失敗した場合は、ビルドログを使用して原因を特定します。詳細については、デプロイエラーのトラブルシューティングをご覧ください。
Infra Manager のデプロイの詳細ページで [Cloud Build ログ] リンクをクリックして、デプロイのビルドを開くこともできます。
クリーンアップ
このクイックスタートで使用したリソースに対して Google Cloud アカウントに課金されないようにするには、不要になったデプロイを削除します。デプロイ プレビューでは、 Google Cloud アカウントに課金されません。プレビューを削除する場合は、プレビューを削除するをご覧ください。
デプロイを削除する
デプロイとプロビジョニングされた VPC ネットワークを削除します。
デプロイを削除するには、次の手順を行います。
Google Cloud コンソールで、[Infrastructure Manager] ページに移動します。
[ID] 列で、[
quickstart-deployment] をクリックします。デプロイの詳細ページで、 [削除] をクリックします。
確認ダイアログで「
quickstart-deployment」と入力し、[確認] をクリックします。
サービス アカウントを削除する
Infra Manager がデプロイを削除したら、im-quickstart-sa サービス アカウントを削除して、プロジェクトでロールが保持されないようにします。
Google Cloud コンソールで、[サービス アカウント] ページに移動します。
im-quickstart-saのチェックボックスをオンにして、[ 削除] をクリックします。ダイアログで [削除] をクリックします。
省略可: プロジェクトを削除する
新しい Google Cloud プロジェクトにデプロイを作成し、そのプロジェクトが不要になった場合は、プロジェクトを削除します。
Google Cloud コンソールで [リソースの管理] ページに移動します。
プロジェクト リストで、削除するプロジェクトを選択し、[削除] をクリックします。
ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックします。
次のステップ
- Infra Manager の仕組みを確認する。
- Terraform と Infra Manager の詳細を確認する。
- デプロイを更新する。
- デプロイを自動化する。
- Google Cloudで使用できる構成とモジュールのセットについては、 Google Cloud の Terraform ドキュメントの Google Cloud用の Terraform ブループリントとモジュールをご覧ください。