Google CloudアカウントをTerraformに連携する方法を解説！

この記事は、以下の2部構成で「Terraformで書いたコードをCheckovでセキュリティチェックする方法」を徹底解説します。
【前編】Google Cloudの自分のアカウントをTerraformに連携する方法を解説！
【後編】Terraformにコードを書いて、Checkovでセキュリティチェックする手順を解説

今回は、Googleアカウントとローカル環境のTerraformを連携させるために、Google Cloudアカウントの作成からTerraformのインストール、そして「terraform init」コマンドを使ってワークスペースを初期化する流れを解説します。

次回の後編では、Terraformで記述したインフラコードに対して、Checkovを使ってセキュリティチェックを実施する方法の紹介です。Checkovによるセキュリティチェックを組み込むことで、開発の早い段階でセキュリティのリスクを検出し、信頼性の高いインフラを構築できるようになります。

本シリーズを通じて、Google CloudとTerraformの連携からCheckovを使ったセキュリティ管理まで、実用的な知識を習得できる内容となっていますので、ぜひ最後までご覧ください。

TerraformやCheckovの基礎となる概要や利用するメリットについて知りたい方は、別の記事で解説していますので合わせてご確認ください。

TerraformコードのセキュリティチェックができるCheckovとは

事前準備（今回の解説で使用するツール）

事前準備として、Google Cloud上にリソースを作成するため、Google Cloudのアカウントが必要となります。そして、今回の解説を進めるにあたり、以下の3つのツールが必要になります。

gcloud CLI
gcloud CLIのインストール手順はこちら
VSCode（Visual Studio Code）
VSCodeのインストールはこちらから
Terraform

これらのツールがまだインストールされていない場合は、まずそれぞれの公式サイトやリソースからインストールを完了させてください。特にTerraformのインストール手順については、詳しく解説した記事がございますので、こちらを参考にスムーズに導入いただけます。

【Windows編】terraformとCheckovをインストールする方法を解説

【Mac編】terraformとCheckovインストール手順を解説

VSCodeでターミナルを開き、Terraformとgcloudのバージョンを確認する

3つのツールのインストールができたら、VSCodeでターミナルを開き、Terraformとgcloudのバージョンを確認しましょう。

正しくインストールされていれば、上記画像のように、バージョン情報が出力されます。

バージョンが出力されたら、次のステップに進み、Google Cloudアカウントとの連携作業に取りかかりましょう。

Terraformを利用してGoogle Cloudのリソースを構築する際の流れ

まずは、全体の流れを把握しましょう。Terraformを使ってGoogle Cloudリソースを構築する際の基本的な流れは、以下の6つのステップで進行します。

terraform用のGoogle Cloudユーザーを作成
ローカルPCとGoogle Cloudアカウントの紐づけ
backendファイル作成（Terraformで一番重要なファイル）
Terraform init でワークスペースの初期化
VScodeでコード執筆
Google Cloud上にリソースデプロイ

terraform用のGoogle Cloudユーザーを作成

まず最初のステップはGoogle Cloudのコンソール画面上でのIAMユーザー作成です。今回はオーナー権限を持ったユーザーを作成して解説します。

ユーザーは既存のユーザーでも問題ありませんが、Terraformに特化したユーザーを作成することで、権限管理やセキュリティリスクを最小限に抑えられます。

ローカルPCとGoogle Cloudアカウントの紐づけ

次に、ローカル環境でgcloud CLIを使用して、Google Cloudアカウントと接続します。
コマンドプロンプト（ターミナル）に、下記コマンドを入力することでGoogle Cloudのアカウントとの連携が可能です。

gcloud auth login

gcloud auth login コマンドを実行すると、以下の手順で認証プロセスが進みます。

ブラウザが自動的に開く
コマンドを実行すると、Google の認証ページがブラウザに表示されます。

Google アカウントでログインまたは選択
使用したい Google アカウントを選択するか、アカウント情報を入力してログインしてください。

アクセス許可を確認
Google Cloud SDK がアカウントにアクセスするための権限が求められます。「許可」ボタンをクリックして認証を完了します。

※ブラウザが開かない場合：ターミナルに認証用の URL が表示されます。その場合は、URL をコピーしてブラウザに貼り付け、手動でアクセスしてください。

以下のような画面が表示されていれば、ブラウザ上の認証は完了です。続いて、ターミナルでの設定確認に進みます。

Google Cloud内のプロジェクトの指定方法

使用するユーザーに対して、複数のプロジェクトを作成している場合のプロジェクト指定方法を解説します。

プロジェクトIDの確認
まずは、下記コマンドを実行してプロジェクトIDを確認しましょう。プロジェクトIDはgoogle cloudコンソール上でも確認可能です。

gcloud projects list

プロジェクトIDの登録
使用したいプロジェクトIDをコピーして、次のコードを実行してください。

gcloud config set project [PROJECT_ID]

backendファイル作成

次のステップが、backendファイルの作成です。backendファイルで、AWSやAzureといったプロバイダー情報やリージョン、JSONコードが記述されたファイルの保管場所などの情報を定義します。

backendファイルの作成手順は以下のとおりです。

backendファイルを格納するフォルダの作成
backend.tfファイルを作成
VSCodeでファイルにコードを記述

今回は、Terraformがデプロイしたインフラの「現在の状態」が保存されたtfstateファイルをCloud Storageのバケット内に配置します。

tfstateファイルを格納するためのバケットをGoogle CloudコンソールのCloud Storageのページにある「バケットを作成」から作成してください。

パケットを作成したら、VSCodeのターミナルに戻り、下記コマンドを実行してbackendファイルを作成します。

mkdir OpsToday-terraform

mkdir ”任意の名前” でフォルダを作成。

cd OpsToday-terraform

cd コマンドで作成したフォルダに移動。

touch backend.tf

このコマンドを入力しbackend.tf ファイルを作成します。そして、フォルダ内に、backend.tfファイルが作成されていることを確認し、backend.tfファイルをVSCodeで開きます。

先程作成したbackend.tfファイルをVSCodeで開き、ファイル内に下記のコマンドを記述します。

# tfstate管理バケット
terraform {
required_version = “= 1.9.6” #使用しているterraformのバージョンを入力
backend “gcs” {
bucket = “opstoday-tfstate” #googleコンソール上のバケット名を入力
prefix = “opstoday-terraform-tfstate” # オブジェクト名を指定。フォルダのように整理可能
}
}

# プロバイダー指定
provider “google” {
project = “vocal-cyclist-437310-q7”
region = “asia-northeast1”
zone = “asia-northeast1-c”
}

このコードを記述する際は、3つの注意するべき点があります。

実行環境にインストールされているTerraformバージョンが異なる場合、適切なバージョンに変更してください。
バケット名は全世界で「一意」である必要があります。
バケット内のオブジェクト名は一意である必要があります。

コードの記述が終われば、backendファイル作成が完了です。

※バケット名やオブジェクト名に使える文字や命名規則についてはgoogle公式ドキュメントでご確認ください。

Terraform init でワークスペースの初期化

次は、terraform init でワークスペースの初期化の手順です。コマンドプロンプト上で、test-terraformフォルダに移動し、下記コマンドを入力します。

terraform init

init は「initialize（イニシャライズ）」の略で「初期化」を意味します。ここまでの手順で正しく設定が行われていれば、下記画像のようにSuccessfullyと出力されます。

VScodeでコード執筆

ここまでの手順でローカル環境とTerraformの連携は終了ですが、デモとしてvpcを作成手順を解説します。

まずは、test-terraformフォルダ内に「network.tfファイル」を作成し、作成したファイルをVSCodeで開きます。作成したnetwork.tfファイル内に下記のコードを入力しましょう。

resource “google_compute_network” “opstoday-vpc_network” {
name = “opstoday-vpc” #Google上に作成するリソースの名前を指定
}

resource “google_compute_subnetwork” “opstoday-subnet” {
name = “opstoday-subnet” #Google上に作成するリソースの名前を指定
ip_cidr_range = “10.0.0.0/24”
network = google_compute_network.opstoday-vpc_network.id

コードが書けたらターミナルで下記コマンドを入力します。

terraform plan

このコマンドを実行することで、どのリソースが追加・変更・削除されるかを確認できます。