GSP156

概要

このラボでは、Terraform と Gemini Code Assist（Google Cloud の AI を活用したコラボレーター）を使用して、仮想マシン（VM）インスタンスをプロビジョニングします。

Terraform を使用すると、クラウド インフラストラクチャを安全かつ想定どおりに作成、変更、改善できます。Terraform は、API を宣言的な構成ファイルにコード化するオープンソースのツールです。ファイルは、同僚間で共有したり、コードとして扱ったりできます。また、編集、レビュー、バージョン管理を行うこともできます。

目標

このラボでは、次のタスクの実行方法について学びます。

• Google Cloud で Terraform の使用を始める。
• Terraform をインストール バイナリからインストールする。
• Gemini Code Assist を使用して、VM インスタンスの Terraform 構成を作成する。

設定と要件

[ラボを開始] ボタンをクリックする前に

こちらの説明をお読みください。ラボには時間制限があり、一時停止することはできません。タイマーは、Google Cloud のリソースを利用できる時間を示しており、[ラボを開始] をクリックするとスタートします。

このハンズオンラボでは、シミュレーションやデモ環境ではなく実際のクラウド環境を使って、ラボのアクティビティを行います。そのため、ラボの受講中に Google Cloud にログインおよびアクセスするための、新しい一時的な認証情報が提供されます。

このラボを完了するためには、下記が必要です。

• 標準的なインターネット ブラウザ（Chrome を推奨）

注: このラボの実行には、シークレット モード（推奨）またはシークレット ブラウジング ウィンドウを使用してください。これにより、個人アカウントと受講者アカウント間の競合を防ぎ、個人アカウントに追加料金が発生しないようにすることができます。

• ラボを完了するための時間（開始後は一時停止できません）

注: このラボでは、受講者アカウントのみを使用してください。別の Google Cloud アカウントを使用すると、そのアカウントに料金が発生する可能性があります。

ラボを開始して Google Cloud コンソールにログインする方法

1. [ラボを開始] ボタンをクリックします。ラボの料金をお支払いいただく必要がある場合は、表示されるダイアログでお支払い方法を選択してください。 左側の [ラボの詳細] ペインには、以下が表示されます。

   • [Google Cloud コンソールを開く] ボタン
   • 残り時間
   • このラボで使用する必要がある一時的な認証情報
   • このラボを行うために必要なその他の情報（ある場合）

2. [Google Cloud コンソールを開く] をクリックします（Chrome ブラウザを使用している場合は、右クリックして [シークレット ウィンドウで開く] を選択します）。

   ラボでリソースがスピンアップし、別のタブで [ログイン] ページが表示されます。

   ヒント: タブをそれぞれ別のウィンドウで開き、並べて表示しておきましょう。

   注: [アカウントの選択] ダイアログが表示されたら、[別のアカウントを使用] をクリックします。

3. 必要に応じて、下のユーザー名をコピーして、[ログイン] ダイアログに貼り付けます。

   {{{user_0.username | "Username"}}}

   [ラボの詳細] ペインでもユーザー名を確認できます。

4. [次へ] をクリックします。

5. 以下のパスワードをコピーして、[ようこそ] ダイアログに貼り付けます。

   {{{user_0.password | "Password"}}}

   [ラボの詳細] ペインでもパスワードを確認できます。

6. [次へ] をクリックします。

   重要: ラボで提供された認証情報を使用する必要があります。Google Cloud アカウントの認証情報は使用しないでください。 注: このラボでご自身の Google Cloud アカウントを使用すると、追加料金が発生する場合があります。

7. その後次のように進みます。

   • 利用規約に同意してください。
   • 一時的なアカウントなので、復元オプションや 2 要素認証プロセスは設定しないでください。
   • 無料トライアルには登録しないでください。

その後、このタブで Google Cloud コンソールが開きます。

注: Google Cloud のプロダクトやサービスにアクセスするには、ナビゲーション メニューをクリックするか、[検索] フィールドにサービス名またはプロダクト名を入力します。

Cloud Shell をアクティブにする

Cloud Shell は、開発ツールと一緒に読み込まれる仮想マシンです。5 GB の永続ホーム ディレクトリが用意されており、Google Cloud で稼働します。Cloud Shell を使用すると、コマンドラインで Google Cloud リソースにアクセスできます。

1. Google Cloud コンソールの上部にある「Cloud Shell をアクティブにする」アイコン をクリックします。

2. ウィンドウで次の操作を行います。

   • Cloud Shell 情報ウィンドウで操作を進めます。
   • Cloud Shell が認証情報を使用して Google Cloud API を呼び出すことを承認します。

接続した時点で認証が完了しており、プロジェクトに各自の Project_ID、 が設定されます。出力には、このセッションの PROJECT_ID を宣言する次の行が含まれています。

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud は Google Cloud のコマンドライン ツールです。このツールは、Cloud Shell にプリインストールされており、タブ補完がサポートされています。

3. （省略可）次のコマンドを使用すると、有効なアカウント名を一覧表示できます。

gcloud auth list

4. [承認] をクリックします。

出力:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. （省略可）次のコマンドを使用すると、プロジェクト ID を一覧表示できます。

gcloud config list project

出力:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} 注: Google Cloud における gcloud ドキュメントの全文については、gcloud CLI の概要ガイドをご覧ください。

Terraform とは

Terraform とは、インフラストラクチャを安全かつ効率的に構築、変更、バージョン管理するためのツールです。既存の一般的なサービス プロバイダと自社のカスタム ソリューションを管理できます。

構成ファイルを使用して、Terraform が 1 つのアプリケーションまたはデータセンター全体を実行するために必要なコンポーネントを記述します。Terraform は、インフラストラクチャを希望の状態にするまでの操作を記載した実行プランを生成し、そのプランを実行して、構成ファイルに記述されたインフラストラクチャを構築します。構成に変更があった場合は変更内容を特定し、増分実行プランを作成して適用することができます。

Terraform で管理できるインフラストラクチャには、コンピューティング インスタンス、ストレージ、ネットワークなどの低レベルのコンポーネントと、DNS エントリ、SaaS 機能などの高レベルのコンポーネントの両方が含まれます。

主な機能

Infrastructure as code

インフラストラクチャの記述には高レベルの構成構文を使用します。これにより、データセンターのブループリントをバージョン管理したり、他のコードと同じように扱ったりできます。インフラストラクチャを共有したり再利用したりすることも可能です。

実行計画

Terraform は、計画手順に沿って実行プランを作成します。実行プランは、apply コマンドの実行時に Terraform が行う動作を示します。インフラストラクチャ構築時に、予想外の操作が実行されるのを回避できます。

リソースグラフ

Terraform では、すべてのリソースのグラフが作成され、依存しないリソースの作成と変更が同時に実行されます。こうしてインフラストラクチャは効率的に構築され、インフラストラクチャ内の依存関係も把握できます。

変更の自動化

インフラストラクチャには、最小限の手作業で、複雑な変更を適用できます。上述の実行プランとリソースグラフを使うと、何がどのような順番で変更されるかがわかるため、多くの人的ミスを回避できます。

タスク 1. Terraform のインストールを確認する

Terraform は、Cloud Shell にプリインストールされています。

• 新しい Cloud Shell タブを開き、次のコマンドを実行して Terraform が利用できることを確認します。

terraform

結果のヘルプ出力は次のようになります。

Usage: terraform [global options] [args] 実行可能なコマンドは以下のとおりです。 最初にプライマリ ワークフロー コマンドが示され、その後にあまり一般的でないコマンドや高度なコマンドが示されます。主なコマンド: init 他のコマンドの作業ディレクトリを準備します validate 構成が有効かどうかを確認します plan 現在の構成に必要な変更を表示します apply インフラストラクチャを作成または更新します destroy 以前に作成したインフラストラクチャを破棄します その他すべてのコマンド: console インタラクティブ コマンド プロンプトで Terraform 式を試します fmt 構成を標準スタイルで再フォーマットします force-unlock 現在のワークスペースでスタックしたロックを解除します get リモート Terraform モジュールをインストールまたはアップグレードします graph オペレーションのステップの Graphviz グラフを生成します import 既存のインフラストラクチャを Terraform リソースに関連付けます login リモートホストの認証情報を取得して保存します logout リモートホストのローカルに保存された認証情報を削除します metadata メタデータ関連のコマンド output ルート モジュールの出力値を表示します providers この構成に必要なプロバイダを表示します refresh リモート システムと一致するように状態を更新します show 現在の状態または保存されたプランを表示します state 高度な状態管理 taint リソース インスタンスを完全に機能していないものとしてマークします test モジュール統合テストの試験運用版のサポート untaint リソース インスタンスから「tainted」状態を削除します version 現在の Terraform バージョンを表示します workspace ワークスペース管理 グローバル オプション（サブコマンドがある場合は、サブコマンドの前に使用）: -chdir=DIR 指定されたサブコマンドを実行する前に、別の作業ディレクトリに切り替えます。 -help このヘルプ出力、または指定されたサブコマンドのヘルプを表示します。 -version 「version」サブコマンドのエイリアス。

タスク 2. インフラストラクチャを構築する

Terraform がインストールされたら、インフラストラクチャの作成をすぐに開始できます。まず、Terraform コードの作成を支援する Gemini Code Assist を有効にしましょう。

Cloud Shell IDE で Gemini Code Assist を有効にする

Cloud Shell などの統合開発環境（IDE）で Gemini Code Assist を使用して、コードに関するガイダンスを受けたり、コードの問題を解決したりできます。使用を開始する前に、Gemini Code Assist を有効にする必要があります。

1. Cloud Shell で、次のコマンドを使用して Gemini for Google Cloud API を有効にします。

gcloud services enable cloudaicompanion.googleapis.com

2. Cloud Shell ツールバーの [エディタを開く] をクリックします。

注: Cloud Shell エディタを開くには、Cloud Shell ツールバーの [エディタを開く] をクリックします。必要に応じて、[エディタを開く] または [ターミナルを開く] をクリックして、Cloud Shell とコードエディタを切り替えることができます。

3. 左側のペインで [設定] アイコンをクリックし、[設定] ビューで「Gemini Code Assist」を検索します。

4. [Geminicodeassist: Enable] のチェックボックスがオンになっていることを確認し、[設定] を閉じます。

5. 画面下部のステータスバーで [Cloud Code - No Project] をクリックします。

6. 指示に従ってプラグインを承認します。プロジェクトが自動的に選択されない場合は、[Google Cloud プロジェクトを選択する] をクリックして を選択します。

7. ステータスバーの Cloud Code ステータス メッセージに Google Cloud プロジェクト（）が表示されていることを確認します。

構成

インフラストラクチャを説明するために Terraform で使用される一連のファイルは、Terraform 構成と呼ばれています。このセクションでは、1 つの VM インスタンスを起動する最初の構成を記述します。構成ファイルの形式については Terraform 言語のドキュメントをご覧ください。構成ファイルの作成には JSON を使用することをおすすめします。

1. Cloud Shell で、次のコマンドを使って instance.tf という名前の空の構成ファイルを作成します。

touch instance.tf

2. Cloud Shell ツールバーの [エディタを開く] をクリックします。
   Cloud Shell とコードエディタを切り替えるには、必要に応じて [エディタを開く] または [ターミナルを開く] をクリックするか、[新しいウィンドウで開く] をクリックして別のタブでエディタを開いたままにします。

3. ファイル エクスプローラで instance.tf をダブルクリックして、instance.tf ファイルを開きます。この操作により、エディタの右上隅に アイコンが表示され、Gemini Code Assist が有効になります。

4. 新しいコードを生成するには、Gemini Code Assist: Smart Actions アイコンをクリックして [/generate] を選択します。

   または、Ctrl+I（Windows および Linux の場合）または Cmd+I（macOS の場合）を押して Gemini Code Assist ウィンドウを開き、[/generate] を選択して新しいコードを生成します。

Gemini Code Assist を使用して Terraform リソースを生成する

このセクションでは、Gemini Code Assist を使用して Terraform リソース（この例では VM）を生成する方法を説明します。

1. 提供された次のプロンプトを Gemini Code Assist のインライン テキストボックスに貼り付けます。

次の仕様に基づいて、Google Compute Engine 仮想マシンの Terraform 構成を生成し、instance.tf に保存してください。 * プロジェクト ID: {{{project_0.project_id | Project ID}}} * VM 名: terraform * マシンタイプ: e2-medium * デプロイ ゾーン: {{{ project_0.default_zone|zone}}} * ブートディスク: Debian 12 * ネットワーク: デフォルト ネットワーク

インライン テキストボックスのコードは、次のコードブロックのようになります。

/generate 次の仕様に基づいて、Google Compute Engine 仮想マシンの Terraform 構成を生成し、instance.tf に保存してください。 * プロジェクト ID: {{{project_0.project_id | Project ID}}} * VM 名: terraform * マシンタイプ: e2-medium * デプロイ ゾーン: {{{ project_0.default_zone|zone}}} * ブートディスク: Debian 12 * ネットワーク: デフォルト ネットワーク

2. Enter キーを押して、Terraform を使用して VM インスタンスを起動するためのコードを生成します。[Gemini Diff] ビューでプロンプトが表示されたら、[Accept] をクリックします。

3. instance.tf ファイルで、生成されたコードを確認します。

これは完全な構成なので、このまま Terraform で適用できます。全体的な構造は直感的で単純です。

Gemini Code Assist の推奨事項を受け入れると、instance.tf ファイルは次のようになります。

生成されたファイルの内容:

resource "google_compute_instance" "default" { project = "{{{project_0.project_id | Project ID}}}" zone = "{{{ project_0.default_zone|zone}}}" name = "terraform" machine_type = "e2-medium" boot_disk { initialize_params { image = "debian-cloud/debian-12" } } network_interface { network = "default" } }

instance.tf ファイルの「resource」ブロックは、インフラストラクチャ内に存在するリソースを定義します。リソースは、VM インスタンスなどの物理コンポーネントの場合もあります。

resource ブロックの前に、resource type（リソースタイプ）と resource name（リソース名）の 2 つの文字列があります。このラボでは、リソースタイプは google_compute_instance で、リソース名は terraform です。タイプの接頭辞はプロバイダに対応しているため、google_compute_instance と入力すると、Google プロバイダが管理するリソースであることを Terraform が自動的に認識します。

resource ブロック自体は、リソースに必要な構成になっています。

4. Cloud Shell ターミナルで、次のコードを実行して、新しいファイルが追加されたことと、ディレクトリにほかの *.tf ファイルが含まれていないことを確認します。Terraform はすべての .tf ファイルを読み込むからです。

ls

初期化

新しい構成に対して（または既存の構成をバージョン管理からチェックアウトした後に）最初に実行するコマンドは、terraform init です。このコマンドを実行すると、それ以降のコマンドで使用されるさまざまなローカル設定やローカルデータが初期化されます。

Terraform ではプラグイン ベースのアーキテクチャを使用して、さまざまなインフラストラクチャやサービス プロバイダをサポートしています。それぞれの「プロバイダ」は、Terraform 自体とは別に配布される、独自にカプセル化されたバイナリです。terraform init コマンドを実行すると、プロバイダ（この場合は Google プロバイダのみ）のすべてのプロバイダ バイナリが自動的にダウンロード、インストールされ、構成で使用できるようになります。

1. プロバイダ バイナリをダウンロードしてインストールします。

terraform init

Google プロバイダのプラグインが、他のさまざまな簿記関連のファイルとともにダウンロードされて、現在の作業ディレクトリのサブディレクトリにインストールされます。「Initializing provider plugins」というメッセージが表示されます。Google プロジェクトから実行していることが認識されて、Google リソースが取得されます。

Installing hashicorp/google v4.77.0... 注: バージョン番号はこれより大きい場合があります。

インストールされるプラグインのバージョンが出力に示されます。また、次回も同じバージョンの構成ファイルを指定すると、terraform init に互換性のあるバージョンがインストールされることが示されます。

2. 実行プランを作成します。

terraform plan

このコマンドを実行すると、明示的に無効にしない限り、実行プランが更新されます。その後、構成ファイルで指定した、インフラストラクチャを希望の状態にするのに必要な操作が確定します。このコマンドは、一連の変更を加えた実行プランで予想どおりの状態を実現できるかを、実際のリソースや状態に変更を加えずに確認するのに便利です。たとえば、変更をバージョン管理に保存する前にこのコマンドを実行して、意図したとおりに動作することを確認できます。

注: オプションの -out 引数を使用すると、生成されたプランをファイルに保存できます。保存したファイルは、後で terraform apply で実行できます。

変更を適用

1. 作成した instance.tf ファイルと同じディレクトリで、次のコマンドを実行します。

terraform apply

出力に実行プランが表示されます。実行プランには、実際のインフラストラクチャをこの構成に合わせて変更するために実行される操作が記述されています。出力の形式は、Git などのツールで生成される差分形式に似ています。

google_compute_instance.terraform の横に + があります。これは、Terraform でこのリソースが作成されることを意味しています。それに続いて、設定される属性が表示されています。値が <computed> になっている場合、その属性の値はリソースが作成されるまでわかりません。

出力例:

An execution plan has been generated and is shown below. Resource actions are indicated with the following symbols: + create Terraform will perform the following actions: # google_compute_instance.default will be created + resource "google_compute_instance" "default" { + can_ip_forward = false + cpu_platform = (known after apply) + deletion_protection = false + guest_accelerator = (known after apply) + id = (known after apply) + instance_id = (known after apply) + label_fingerprint = (known after apply) + machine_type = "e2-medium" + metadata_fingerprint = (known after apply) + name = "terraform" + project = "qwiklabs-gcp-42390cc9da8a4c4b" + self_link = (known after apply) + tags_fingerprint = (known after apply) + zone = "us-west1-c" + boot_disk { + auto_delete = true + device_name = (known after apply) + disk_encryption_key_sha256 = (known after apply) + kms_key_self_link = (known after apply) + source = (known after apply) + initialize_params { + image = "debian-cloud/debian-12" + labels = (known after apply) + size = (known after apply) + type = (known after apply) } } + network_interface { + address = (known after apply) + name = (known after apply) + network = "default" + network_ip = (known after apply) + subnetwork = (known after apply) + subnetwork_project = (known after apply) + access_config { + assigned_nat_ip = (known after apply) + nat_ip = (known after apply) + network_tier = (known after apply) } } + scheduling { + automatic_restart = (known after apply) + on_host_maintenance = (known after apply) + preemptible = (known after apply) + node_affinities { + key = (known after apply) + operator = (known after apply) + values = (known after apply) } } } Plan: 1 to add, 0 to change, 0 to destroy. Do you want to perform these actions? Terraform will perform the actions described above. Only 'yes' will be accepted to approve. Enter a value:

プランが正常に作成された場合、Terraform はここで一時停止して、続行する前に承認を求めます。本番環境では、実行プランに正しくない内容や危険な内容が含まれていると思われる場合は、安全のためにここでキャンセルしてください。インフラストラクチャはまだ変更されていません。

2. この例ではプランに問題がないようなので、確認プロンプトで「yes」と入力して続行し、Enter キーを押します。
   プランの実行には数分かかります。VM インスタンスが利用可能になるまで Terraform が待機するためです。

以上で Terraform の作業は終了です。

完了したタスクをテスト

[進行状況を確認] をクリックして、実行したタスクを確認します。タスクが正常に完了すると、評価スコアが提供されます。

Terraform を使用して ゾーンに VM インスタンスを作成する

3. Google Cloud コンソールのナビゲーション メニューで、[Compute Engine] > [VM インスタンス] をクリックします。[VM インスタンス] ページが開き、作成した VM インスタンスが [VM インスタンス] リストに表示されます。

Terraform は、terraform.tfstate ファイルにデータを書き込みます。この状態ファイルは非常に重要です。作成されたリソースの ID がトラッキングされるため、Terraform で管理しているリソースを把握できるからです。

4. Cloud Shell で次のコマンドを実行して現在の状態を確認します。

terraform show

出力例:

# google_compute_instance.default: resource "google_compute_instance" "default" { can_ip_forward = false cpu_platform = "Intel Haswell" deletion_protection = false guest_accelerator = [] id = "terraform" instance_id = "3408292216444307052" label_fingerprint = "42WmSpB8rSM=" machine_type = "e2-medium" metadata_fingerprint = "s6I5s2tjfKw=" name = "terraform" project = "qwiklabs-gcp-42390cc9da8a4c4b" self_link = "https://www.googleapis.com/compute/v1/projects/qwiklabs-gcp-42390cc9da8a4c4b/zones/{{{project_0.default_zone}}}/instances/terraform" tags_fingerprint = "42WmSpB8rSM=" zone = "{{{project_0.default_zone}}}" boot_disk { auto_delete = true device_name = "persistent-disk-0" source = "https://www.googleapis.com/compute/v1/projects/qwiklabs-gcp-42390cc9da8a4c4b/zones/{{{project_0.default_zone}}}/disks/terraform" ....

このリソースを作成すると、多くの関連情報が収集されたことがわかります。これらの値を参照すると、追加のリソースや出力を構成できます。

これで完了です。ここでは、Terraform を使用して最初のインフラストラクチャを構築しました。さらに、構成構文、基本的な実行プランの例、状態ファイルを確認しました。

タスク 3. 理解度チェック

今回のラボで学習した内容の理解を深めていただくために、以下の多肢選択式の問題を用意しました。正解を目指して頑張ってください。

お疲れさまでした

これでこのラボは完了です。ここでは、Gemini Code Assist を使用して Terraform で Google Cloud のインフラストラクチャを作成、管理する方法を学びました。

次のステップと詳細情報

• Google Cloud Marketplace の Hashicorp
• Terraform コミュニティ
• Terraform の Google の例

Google Cloud トレーニングと認定資格

Google Cloud トレーニングと認定資格を通して、Google Cloud 技術を最大限に活用できるようになります。必要な技術スキルとベスト プラクティスについて取り扱うクラスでは、学習を継続的に進めることができます。トレーニングは基礎レベルから上級レベルまであり、オンデマンド、ライブ、バーチャル参加など、多忙なスケジュールにも対応できるオプションが用意されています。認定資格を取得することで、Google Cloud テクノロジーに関するスキルと知識を証明できます。

マニュアルの最終更新日: 2025 年 10 月 13 日

ラボの最終テスト日: 2025 年 10 月 13 日

Copyright 2025 Google LLC. All rights reserved. Google および Google のロゴは Google LLC の商標です。その他すべての企業名および商品名はそれぞれ各社の商標または登録商標です。