Terraform を使用して Compute Engine リソースをプロビジョニングする

Hashicorp Terraform は、クラウド インフラストラクチャのプロビジョニングと管理に使用できる Infrastructure as Code（IaC）ツールです。Terraform には、クラウド プロバイダや他の API とやり取りできるプロバイダというプラグインが用意されています。Terraform provider for Google Cloud を使用して、Compute Engine などの Google Cloud リソースをプロビジョニングして管理できます。

このページでは、Compute Engine で Terraform を使用する方法について説明します。Terraform の仕組みの概要と、Google Cloud で Terraform の使用を開始するためのリソースも紹介します。また、Compute Engine の Terraform リファレンス ドキュメント、コードサンプル、Terraform を使用して Compute Engine リソースをプロビジョニングするガイドへのリンクも用意されています。

Google Cloud 向け Terraform の使用方法については、Terraform のインストールと構成または Google Cloud 向け Terraform のクイックスタートをご覧ください。

Terraform の仕組み

Terraform には宣言型で構成指向の構文があり、これを使用して、Google Cloud プロジェクトにプロビジョニングするインフラストラクチャを記述できます。1 つまたは複数の Terraform 構成ファイルで構成を作成し、Terraform CLI を使用して、この構成を Compute Engine リソースに適用できます。

以降のステップでは、Terraform の仕組みについて説明します。

1. プロビジョニングするインフラストラクチャを Terraform 構成ファイルに記述します。インフラストラクチャのプロビジョニング方法を記述するコードは必要ありません。Terraform がインフラストラクチャをプロビジョニングします。
2. terraform plan コマンドを実行します。これにより、構成が評価され、実行プランが生成されます。プランを確認し、必要に応じて変更します。

3. 次に、terraform apply コマンドを実行します。これにより、次のアクションが実行されます。

   1. バックグラウンドで、対応する Compute Engine API を呼び出し、実行プランに基づいてインフラストラクチャをプロビジョニングします。
   2. Terraform 状態ファイルを作成します。これは、構成ファイル内のリソースと実際のインフラストラクチャ内のリソースをマッピングする JSON ファイルです。Terraform は、このファイルを使用してインフラストラクチャの最新状態を記録し、リソースを作成、更新、破棄するタイミングを決定します。

   3. terraform apply を実行すると、Terraform は状態ファイルのマッピングを使用して、既存のインフラストラクチャとコードと比較し、必要に応じて更新を行います。

      • 構成ファイルで定義されたリソース オブジェクトが状態ファイルに存在しない場合は、Terraform によってリソース オブジェクトが作成されます。
      • リソース オブジェクトが状態ファイルに存在し、構成ファイルと構成が異なる場合、Terraform は構成ファイルと一致するようにリソースを更新します。
      • 状態ファイル内のリソース オブジェクトが構成ファイルと一致する場合、Terraform はリソースを変更しません。

Compute Engine の Terraform リソース

リソースは、Terraform 言語の基本要素です。各リソース ブロックは、仮想ネットワークやコンピューティング インスタンスなど、1 つ以上のインフラストラクチャ オブジェクトを記述します。

次の表に、Compute Engine で使用可能な Terraform リソースを示します。

Terraform リソース

データソース

google_compute_address google_compute_attached_disk google_compute_autoscaler google_compute_backend_bucket google_compute_backend_bucket_iam google_compute_backend_bucket_signed_url_key google_compute_backend_service google_compute_backend_service_iam google_compute_backend_service_signed_url_key google_compute_disk google_compute_disk_async_replication google_compute_disk_iam google_compute_disk_resource_policy_attachment google_compute_external_vpn_gateway google_compute_firewall google_compute_firewall_policy google_compute_firewall_policy_association google_compute_firewall_policy_rule google_compute_forwarding_rule google_compute_global_address google_compute_global_forwarding_rule google_compute_global_network_endpoint google_compute_global_network_endpoint_group google_compute_ha_vpn_gateway google_compute_health_check google_compute_http_health_check google_compute_https_health_check google_compute_image google_compute_image_iam google_compute_instance google_compute_instance_from_machine_image google_compute_instance_from_template google_compute_instance_group google_compute_instance_group_manager google_compute_instance_group_membership google_compute_instance_group_named_port google_compute_instance_iam google_compute_instance_settings google_compute_instance_template google_compute_interconnect google_compute_interconnect_attachment google_compute_machine_image google_compute_machine_image_iam google_compute_managed_ssl_certificate google_compute_network google_compute_network_attachment google_compute_network_edge_security_service google_compute_network_endpoint google_compute_network_endpoint_group google_compute_network_endpoints google_compute_network_firewall_policy google_compute_network_firewall_policy_association google_compute_network_firewall_policy_rule google_compute_network_peering google_compute_network_peering_routes_config google_compute_node_group google_compute_node_template google_compute_organization_security_policy google_compute_organization_security_policy_association google_compute_organization_security_policy_rule google_compute_packet_mirroring google_compute_per_instance_config google_compute_project_cloud_armor_tier google_compute_project_default_network_tier google_compute_project_metadata google_compute_project_metadata_item google_compute_public_advertised_prefix google_compute_public_delegated_prefix google_compute_region_autoscaler google_compute_region_backend_service google_compute_region_backend_service_iam google_compute_region_commitment google_compute_region_disk google_compute_region_disk_iam google_compute_region_disk_resource_policy_attachment google_compute_region_health_check google_compute_region_instance_group_manager google_compute_region_instance_template google_compute_region_network_endpoint google_compute_region_network_endpoint_group google_compute_region_network_firewall_policy google_compute_region_network_firewall_policy_association google_compute_region_network_firewall_policy_rule google_compute_region_per_instance_config google_compute_region_security_policy google_compute_region_security_policy_rule google_compute_region_ssl_certificate google_compute_region_ssl_policy google_compute_region_target_http_proxy google_compute_region_target_https_proxy google_compute_region_target_tcp_proxy google_compute_region_url_map google_compute_reservation google_compute_resource_policy google_compute_route google_compute_router google_compute_router_interface google_compute_router_nat google_compute_router_peer google_compute_security_policy google_compute_security_policy_rule google_compute_service_attachment google_compute_shared_vpc_host_project google_compute_shared_vpc_service_project google_compute_snapshot google_compute_snapshot_iam google_compute_ssl_certificate google_compute_ssl_policy google_compute_subnetwork google_compute_subnetwork_iam google_compute_target_grpc_proxy google_compute_target_http_proxy google_compute_target_https_proxy google_compute_target_instance google_compute_target_pool google_compute_target_ssl_proxy google_compute_target_tcp_proxy google_compute_url_map google_compute_vpn_gateway google_compute_vpn_tunnel google_usage_export_bucket

google_compute_address google_compute_addresses google_compute_backend_bucket google_compute_backend_bucket_iam_policy google_compute_backend_service google_compute_backend_service_iam_policy google_compute_default_service_account google_compute_disk google_compute_disk_iam_policy google_compute_forwarding_rule google_compute_forwarding_rules google_compute_global_address google_compute_global_forwarding_rule google_compute_ha_vpn_gateway google_compute_health_check google_compute_image google_compute_image_iam_policy google_compute_instance google_compute_instance_group google_compute_instance_group_manager google_compute_instance_iam_policy google_compute_instance_serial_port google_compute_instance_template google_compute_lb_ip_ranges google_compute_machine_image_iam_policy google_compute_machine_types google_compute_network google_compute_network_endpoint_group google_compute_network_peering google_compute_networks google_compute_node_types google_compute_region_backend_service_iam_policy google_compute_region_disk google_compute_region_disk_iam_policy google_compute_region_instance_group google_compute_region_instance_template google_compute_region_network_endpoint_group google_compute_region_ssl_certificate google_compute_regions google_compute_reservation google_compute_resource_policy google_compute_router google_compute_router_nat google_compute_router_status google_compute_security_policy google_compute_snapshot google_compute_snapshot_iam_policy google_compute_ssl_certificate google_compute_ssl_policy google_compute_subnetwork google_compute_subnetwork_iam_policy google_compute_subnetworks google_compute_vpn_gateway google_compute_zones

Compute Engine の Terraform ベースのガイド

次の表に、Compute Engine の Terraform ベースのハウツー ガイドとチュートリアルを示します。

ガイド	詳細
Compute Engine インスタンスを作成して起動する	仮想マシン（VM）インスタンスを作成する方法について説明します。
ローカル SSD ディスクを接続した VM を作成する	ローカル SSD ディスク ストレージを使用して VM を作成する方法について説明します。
ディスク スナップショットを作成する	標準スナップショットを作成して、ディスクからデータを定期的にバックアップする方法について説明します。
クローンを使用してディスクを複製する	既存のディスクのゾーンディスク クローンを作成する方法について説明します。
リージョン ディスクを作成して管理する	リージョン ディスクの作成方法と管理方法について説明します。
Spot VM を作成して使用する	Spot VM の作成方法と管理方法について説明します。Spot VM は、Compute Engine の余剰キャパシティを利用する VM インスタンスです。Spot VM は、標準 VM のオンデマンド料金と比べてはるかに低価格で利用できます。
VM に SSH 認証鍵を追加する	OS Login を使用する VM インスタンスとメタデータ ベースの SSH 認証鍵を使用する VM に SSH 認証鍵を追加する方法について説明します。
シャットダウン スクリプトの実行	VM インスタンスが停止または再起動する直前にコマンドを実行するシャットダウン スクリプトを作成して実行する方法について説明します。
単一プロジェクトの予約を作成する	単一プロジェクトの予約を作成する方法について説明します。予約は、同じプロジェクト内の VM インスタンスでのみ使用できます。
インスタンス テンプレートを作成する	インスタンス テンプレートの作成方法と管理方法について説明します。
スケジュールに基づくスケーリング	既存の MIG のスケーリング スケジュールの作成方法について説明します。スケジュールに基づく自動スケーリングでは、予想される負荷に対する容量を事前にスケジューリングすることで、ワークロードの可用性を向上させることができます。
Persistent Disk ストレージを VM に追加する	ブート以外の空のゾーン Persistent Disk ボリュームを作成し、VM にアタッチする方法について説明します。
OS Login を設定する	OS Login を設定する方法について説明します。
VM に非ブートディスクをアタッチする	非ブート ゾーンディスクを VM にアタッチする方法について説明します。
ユーザー管理のサービス アカウントを使用する VM を作成する	ユーザー管理のサービス アカウントを使用するように構成された VM インスタンスの作成方法について説明します。サービス アカウントは特別なアカウントであり、通常はアプリケーションやコンピューティング ワークロードが承認された API 呼び出しを行うときに使用されます。
永続ディスクのサイズを増やす	永続ディスクのサイズを増やす方法について説明します。
VM で仮想ディスプレイを有効にする	VM インスタンスで仮想ディスプレイを有効にする方法について説明します。
単一のゾーンに MIG を作成する	単一ゾーンにマネージド インスタンス グループ（MIG）を作成する方法について説明します。MIG のすべての VM を 1 つのゾーンに配置すると、レイテンシを最小限に抑えることができます。これは、特定のワークロード（バッチ ワークロードなど）に役立ちます。
カスタムホスト名の VM インスタンスを作成する	カスタムホスト名の VM インスタンスを作成する方法について説明します。
アプリケーション ベースのヘルスチェックと自動修復を設定する	MIG 内の VM を自動修復するようにアプリケーション ベースのヘルスチェックを設定する方法について説明します。
プリエンプティブル VM を使用する MIG を作成する	プリエンプティブル VM インスタンスを使用する MIG の作成方法について説明します。プリエンプティブル VM は、ワークロードの中断を許容でき、プリエンプティブル VM による費用削減のメリットを活用する必要がある場合に便利です。
MIG に対して VM の追加または削除を行う	MIG に VM の追加または削除を行う方法について説明します。
自動スケーリングが有効な MIG を作成する	グループ全体の平均 CPU 使用率に基づいて VM を自動的に追加または削除する自動スケーリング MIG の作成方法について説明します。
ステートフル ディスクを使用して MIG を作成する	プリエンプティブル VM インスタンスを使用する MIG の作成方法について説明します。プリエンプティブル VM は、ワークロードの中断を許容でき、プリエンプティブル VM による費用削減のメリットを活用する必要がある場合に便利です。
SQL Server VM インスタンスの作成	Microsoft SQL Server VM インスタンスの作成方法について説明します。SQL Server は、Windows Server といくつかの Linux ディストリビューションで動作するデータベース システムです。Compute Engine では、SQL Server をアプリケーションのバックエンドの一部として、あるいは柔軟な開発、テスト環境として使用できるほか、バックアップや障害復旧のためにオンプレミス環境に追加することもできます。
OS ポリシーの割り当てを作成する	OS ポリシーの割り当てを作成する方法について説明します。OS ポリシーを使用すると、Linux と Windows の VM インスタンス全体で一貫したソフトウェア構成を維持できます。
MIG でのステートフル メタデータの構成	MIG でステートフル メタデータを構成する方法について説明します。インスタンス メタデータは、メタデータ サーバーを介してアプリケーションのプロパティを設定し、通信する場合に役立ちます。
MIG でのステートフル永続ディスクの構成	MIG でステートフル永続ディスクを構成する方法について説明します。永続ディスクをステートフルに構成すると、ディスクの状態を維持しながら、VM インスタンスの自動修復と自動更新を利用できます。
MIG 内のステートフル IP アドレスの構成	MIG にステートフル IP アドレスを構成する方法について説明します。MIG でステートフル IP アドレスを構成すると、グループ内の VM インスタンスが自動修復、更新、再作成されるときに、IP アドレスが確実に保持されます。
リージョン MIG 内の VM のターゲット分配形態を設定する	VM のターゲット分配形態を設定する方法について説明します。
リージョン内にある複数のゾーンに VM を含む MIG を作成する	VM がリージョン内の複数のゾーンに分散する MIG を作成する方法について説明します。アプリケーションの負荷を複数のゾーンに分散することで、ワークロードをゾーン障害から保護できます。 注: メキシコ、モントリオール、大阪の各リージョンには、1 つまたは 2 つの物理データセンター内に 3 つのゾーンがあります。これらのリージョンは、少なくとも 3 つの物理データセンターに拡張されています。詳細については、クラウドのロケーションと Google Cloud Platform SLA をご覧ください。ワークロードの信頼性を向上させるには、マルチリージョン デプロイを検討してください。
リージョン MIG でプロアクティブな VM 再配布を無効または有効にする	リージョン MIG でプロアクティブな VM 再配布を無効または有効にする方法について説明します。リージョン MIG で、リージョン内の特定のゾーンに均等な数の VM インスタンスを維持するには、プロアクティブなインスタンスの再配布を使用します。この構成オプションにより、ゾーンレベルで障害が発生した場合のアプリケーションの可用性が最大化されます。

Compute Engine の Terraform モジュールとブループリント

モジュールとブループリントを使用すると、Google Cloud リソースの大規模なプロビジョニングと管理を自動化できます。モジュールとは、Terraform リソースを論理的に抽象化する、再利用可能な一連の Terraform 構成ファイルのことです。ブループリントは、特定のソリューションを実装および文書化した、モジュールとポリシーのパッケージです。このパッケージはデプロイして再利用できます。

次の表に、Compute Engine に関連するモジュールとブループリントを示します。

モジュールまたはブループリント	詳細
terraform-google-vm	Google Cloud で VM をプロビジョニングするための構成要素として使用できる独自のサブモジュールの集合。
terraform-google-startup-scripts	VM に埋め込む有用な起動スクリプトのライブラリを提供します。
terraform-google-container-vm	Compute Engine インスタンスにコンテナをデプロイする

次のステップ

• Compute Engine の Terraform コードサンプル
• Google Cloud の Terraform 関連ドキュメント
• HashiCorp の Google Cloud プロバイダのドキュメント
• Google Cloud の Infrastructure as Code