このクイックスタート ガイドでは、ストレージ バケットをプロビジョニングし、sample_file.txt オブジェクトをバケットにアップロードする Terraform 構成ファイルを作成します。このクイックスタートを完了するには、Cloud Shell エディタ、Cloud Shell ターミナル、Terraform CLI（Cloud Shell にプリインストールされています）を使用します。
始める前に
- Google Cloud アカウントにログインします。Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
-
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
-
Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
-
Cloud Storage API を有効にします。
-
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
-
Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
-
Cloud Storage API を有効にします。
フォルダ構造と Terraform 構成ファイルを作成する
-
Google Cloud コンソールで、「Cloud Shell をアクティブにする」をクリックします。
Google Cloud コンソールの下部で Cloud Shell セッションが開始し、コマンドライン プロンプトが表示されます。Cloud Shell はシェル環境です。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています。セッションが初期化されるまで数秒かかることがあります。
- Cloud Shell ターミナルで次のコマンドを実行して、ホーム ディレクトリを Active Directory として設定します。
cd - 次のコマンドを実行して、
terraformという名前の新しいフォルダを作成します。mkdir terraform - Cloud Shell エディタを起動するには、Cloud Shell ウィンドウのツールバー上にある [エディタを開く] をクリックします。
- [Explorer] ペインで、
terraformフォルダを右クリックし、[New File] をクリックします。 - ファイル名として「
main.tf」と入力し、[OK] をクリックします。 - [Explorer] ペインで、
terraformフォルダを右クリックし、[New File] をクリックします。 - ファイル名として「
sample_file.txt」と入力し、[OK] をクリックします。
Terraform 構成ファイルでインフラストラクチャを定義する
main.tfファイルを Cloud Shell コードエディタで開きます。次の Terraform 構成サンプルの PROJECT_ID、BUCKET_NAME、OBJECT_NAME、OBJECT_PATH のプレースホルダを置き換え、サンプルを
main.tfファイルにコピーします。# Create new storage bucket in the US multi-region # with standard storage resource "google_storage_bucket" "static" { project = "PROJECT_ID" 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 }PROJECT_ID: Google Cloud プロジェクトの ID を入力します。例:
my-project。BUCKET_NAME: 作成するバケットの名前を入力します。例:
my-bucket。OBJECT_NAME: アップロードするオブジェクトの名前を入力します。このクイックスタートでは「
sample_file.txt」と入力します。OBJECT_PATH: アップロードするオブジェクトへのパスを入力します。このクイックスタートでは、パス
~/terraform/sample_file.txtを入力します。
main.tfファイルを保存します。
Terraform 構成ファイルを含む作業ディレクトリを初期化する
Cloud Shell ターミナルを開くには、Cloud Shell エディタのツールバーで [ターミナルを開く] をクリックします。
Cloud Shell ターミナルで次のコマンドを実行して、
terraformフォルダを現在の作業ディレクトリとして設定します。cd ~/terraform次のコマンドを実行して Terraform を初期化します。
terraform initCloud Shell を承認するよう求められたら、[承認] をクリックします。
作業ディレクトリが初期化されます。作業ディレクトリが正常に初期化されると、次のような出力が表示されます。
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.
提案された変更を実行プランに適用する
次のコマンドを実行して、実行プランから 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 キーを押します。問題なければ、次のような出力が表示されます。
Apply complete! Resources: 2 added, 0 changed, 0 destroyed.
ストレージ バケットとアップロードされたオブジェクトを表示する
Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。sample_file.txt オブジェクトを含む新しいバケットが表示されます。terraform apply を実行した後、リソースのプロビジョニングに数分かかることがあります。
プロジェクトをクリーンアップする
次の手順を完了して、このチュートリアルで作成した Google Cloud リソースをクリーンアップし、リソースで予期しない料金が発生しないようにします。
Cloud Shell ターミナルで次のコマンドを実行して、
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.Cloud Shell エディタで、[Explorer] ペインの
terraformフォルダを右クリックして、[Delete] をクリックします。確認画面が表示されたら、[OK] をクリックします。
バケットとオブジェクトが削除されたことを確認するため、Google Cloud コンソールの [バケット] ページに移動します。