このクイックスタート ガイドでは、ストレージ バケットをプロビジョニングし、sample_file.txt オブジェクトをバケットにアップロードする Terraform 構成ファイルを作成します。このクイックスタートでは、ローカルシェルとターミナル、または Cloud Shell エディタと Cloud Shell ターミナルを使用します。また、Cloud Shell にプリインストールされている Terraform CLI も使用します。
始める前に
このクイックスタートのプロジェクトを設定するには、次の手順を完了します。
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Storage API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Storage API.
フォルダ構造と Terraform 構成ファイルを作成する
Terraform 構成ファイルと、Cloud Storage にオブジェクトとしてアップロードするファイルを作成するには、次の手順を完了します。
Cloud Shell
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
- Terraform 構成を適用するデフォルトの Google Cloud プロジェクトを設定します。
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
- Cloud Shell ターミナルで、ホーム ディレクトリをアクティブ ディレクトリとして設定します。
cd terraformという名前の新しいフォルダを作成します。mkdir terraform- Cloud Shell エディタを起動するには、Cloud Shell ウィンドウのツールバー上にある [エディタを開く] をクリックします。
- [Explorer] ペインで、
terraformフォルダを右クリックし、[New File] をクリックします。 - ファイル名として「
main.tf」と入力し、[OK] をクリックします。 - [Explorer] ペインで、
terraformフォルダを右クリックし、[New File] をクリックします。 - ファイル名として「
sample_file.txt」と入力し、[OK] をクリックします。
ローカルシェル
- まだインストールしていない場合は、Terraform をインストールして構成します。Google Cloud CLI をインストールして初期化します。
デフォルトでは、Terraform は Google Cloud CLI によって作成された構成を読み取り、後で指定するリソースをアクティブな Google Cloud CLI プロジェクトにデプロイします。
- ターミナルで、ホーム ディレクトリをアクティブ ディレクトリとして設定します。
cd terraformという名前の新しいフォルダを作成します。mkdir terraform- 任意のテキスト エディタで、
terraformフォルダにmain.tfという名前の新しいファイルを作成します。 - 任意のテキスト エディタで、
terraformフォルダにsample_file.txtという名前の新しいファイルを作成します。
Terraform 構成ファイルでインフラストラクチャを定義する
Terraform 構成ファイルでプロビジョニングするインフラストラクチャを定義するには、次の手順を完了します。
main.tfファイルを開きます。次のサンプルを
main.tfファイルにコピーします。# Create new storage bucket in the US # location with Standard Storage resource "google_storage_bucket" "static" { name = "BUCKET_NAME" location = "US" storage_class = "STANDARD" uniform_bucket_level_access = true } # Upload a text file as an object # to the storage bucket resource "google_storage_bucket_object" "default" { name = "OBJECT_NAME" source = "OBJECT_PATH" content_type = "text/plain" bucket = google_storage_bucket.static.id }
以下のように置き換えます。
BUCKET_NAME は、作成するバケットの名前で置き換えます。例:
my-bucketOBJECT_NAME は、アップロードするオブジェクトの名前で置き換えます。このクイックスタートでは「
sample_file.txt」と入力します。OBJECT_PATH は、アップロードするオブジェクトのパスで置き換えます。このクイックスタートでは、パス
~/terraform/sample_file.txtを入力します。
main.tfファイルを保存します。
Terraform 構成ファイルを含む作業ディレクトリを初期化する
Terraform と Terraform 構成ファイルを含むディレクトリを初期化するには、次の手順を完了します。
ターミナルで、
terraformフォルダを現在の作業ディレクトリとして設定します。cd ~/terraformTerraform を初期化します。
terraform initCloud Shell を使用しているときに Cloud Shell の承認を求められた場合は、[承認] をクリックします。
作業ディレクトリが初期化されます。作業ディレクトリが正常に初期化されると、Terraform から次のような出力が返されます。
Terraform has been successfully initialized! You may now begin working with Terraform. Try running "terraform plan" to see any changes that are required for your infrastructure. All Terraform commands should now work. If you ever set or change modules or backend configuration for Terraform, rerun this command to reinitialize your working directory. If you forget, other commands will detect it and remind you to do so if necessary.
実行プランをプレビューする
Terraform の実行プランは Terraform の構成に基づいており、Cloud Storage のインフラストラクチャとサービスに対して Terraform が行う変更を示します。
Terraform 実行プランを表示します。
terraform plan出力例:
Terraform used the selected providers to generate the following execution plan. Resource actions are indicated with the following symbols:
+ create
Terraform will perform the following actions:
# google_storage_bucket.static will be created
+ resource "google_storage_bucket" "static" {
+ force_destroy = false
+ id = (known after apply)
+ location = "US"
+ name = "my-bucket"
+ project = "my-project"
+ public_access_prevention = (known after apply)
+ self_link = (known after apply)
+ storage_class = "STANDARD"
+ uniform_bucket_level_access = true
+ url = (known after apply)
+ versioning {
+ enabled = (known after apply)
}
+ website {
+ main_page_suffix = (known after apply)
+ not_found_page = (known after apply)
}
}
# google_storage_bucket_object.default will be created
+ resource "google_storage_bucket_object" "default" {
+ bucket = (known after apply)
+ content_type = "text/plain"
+ crc32c = (known after apply)
+ detect_md5hash = "different hash"
+ id = (known after apply)
+ kms_key_name = (known after apply)
+ md5hash = (known after apply)
+ media_link = (known after apply)
+ name = "sample_file.txt"
+ output_name = (known after apply)
+ self_link = (known after apply)
+ source = "sample_file.txt"
+ storage_class = (known after apply)
}
Plan: 2 to add, 0 to change, 0 to destroy.
提案された変更を実行プランに適用する
Terraform 構成ファイルで変更を適用するには、次の手順を完了します。
次のコマンドを使用して、実行プランの変更を Cloud Storage インフラストラクチャに適用します。変更を適用すると、Terraform がストレージ バケットを作成し、そのバケットに
sample_file.txtをアップロードします。terraform apply出力例:
Terraform used the selected providers to generate the following execution plan. Resource actions are indicated with the following symbols: + create Terraform will perform the following actions: # google_storage_bucket.static will be created + resource "google_storage_bucket" "static" { + force_destroy = false + id = (known after apply) + location = "US" + name = "my-bucket" + project = "my-project" + public_access_prevention = (known after apply) + self_link = (known after apply) + storage_class = "STANDARD" + uniform_bucket_level_access = true + url = (known after apply) + versioning { + enabled = (known after apply) } + website { + main_page_suffix = (known after apply) + not_found_page = (known after apply) } } # google_storage_bucket_object.default will be created + resource "google_storage_bucket_object" "default" { + bucket = (known after apply) + content_type = "text/plain" + crc32c = (known after apply) + detect_md5hash = "different hash" + id = (known after apply) + kms_key_name = (known after apply) + md5hash = (known after apply) + media_link = (known after apply) + name = "sample_file.txt" + output_name = (known after apply) + self_link = (known after apply) + source = "sample_file.txt" + storage_class = (known after apply) } Plan: 2 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:「
yes」と入力して Enter キーを押します。成功すると、Terraform から次のような出力が返されます。
Apply complete! Resources: 2 added, 0 changed, 0 destroyed.
ストレージ バケットとアップロードされたオブジェクトを表示する
Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。sample_file.txt オブジェクトを含む新しいバケットが表示されます。terraform apply を実行した後、リソースのプロビジョニングに数分かかることがあります。
プロジェクトをクリーンアップする
このクイックスタートで作成した Google Cloud リソースで予期しない料金が発生しないようにするには、次の手順でリソースをクリーンアップします。
ターミナルで、
terraformフォルダを現在の作業ディレクトリとして設定します。cd ~/terraformTerraform 構成ファイルに基づいて作成した Cloud Storage リソースを削除します。
terraform destroy成功すると、Terraform から次のような出力が返されます。
Terraform used the selected providers to generate the following execution plan. Resource actions are indicated with the following symbols: - destroy Terraform will perform the following actions: # google_storage_bucket.static will be destroyed - resource "google_storage_bucket" "static" { - default_event_based_hold = false -> null - force_destroy = false -> null - id = "my-bucket" -> null - labels = {} -> null - location = "US" -> null - name = "" -> null - project = "example-project" -> null - public_access_prevention = "inherited" -> null - requester_pays = false -> null - self_link = "https://www.googleapis.com/storage/v1/b/cbonnie-bucket-9" -> null - storage_class = "STANDARD" -> null - uniform_bucket_level_access = true -> null - url = "gs://BUCKET_NAME" -> null } # google_storage_bucket_object.default will be destroyed - resource "google_storage_bucket_object" "default" { - bucket = "my-bucket" -> null - content_type = "text/plain" -> null - crc32c = "yZRlqg==" -> null - detect_md5hash = "XrY7u+Ae7tCTyyK7j1rNww==" -> null - event_based_hold = false -> null - id = "my-bucket-sample_file.txt" -> null - md5hash = "XrY7u+Ae7tCTyyK7j1rNww==" -> null - media_link = "https://storage.googleapis.com/download/storage/v1/b/BUCKET_NAME/o/sample_file.txt?generation=1675800386233102&alt=media" -> null - metadata = {} -> null - name = "sample_file.txt" -> null - output_name = "sample_file.txt" -> null - self_link = "https://www.googleapis.com/storage/v1/b/BUCKET_NAME/o/sample_file.txt" -> null - source = "sample_file.txt" -> null - storage_class = "STANDARD" -> null - temporary_hold = false -> null } Plan: 0 to add, 0 to change, 2 to destroy. Do you really want to destroy all resources? Terraform will destroy all your managed infrastructure, as shown above. There is no undo. Only 'yes' will be accepted to confirm. Enter a value:「
yes」と入力して Enter キーを押します。成功すると、Terraform から次のような出力が返されます。Destroy complete! Resources: 2 destroyed.ターミナルで、
terraformフォルダを削除します。rm -rf ~/terraformバケットとオブジェクトが削除されたことを確認するため、Google Cloud コンソールの [バケット] ページに移動します。