【NIC x Ops（にこぷす）通信】（Terraform編）【Terraform × GCP】YAMLドリブンな動的リソース作成！IBM Bobと進めるAI自律デプロイ実践検証

################################################################################
# File:        locals.tf
# Project:     GCE / SQL Infrastructure
# Description: YAML 設定ファイルを読み込み、Terraform の locals として展開する
# Dependency:  config/common.yaml, config/gce.yaml, config/sql.yaml
################################################################################
# このファイルは config/ ディレクトリ配下の YAML ファイルを yamldecode() で読み込み、
# main.tf のモジュール呼び出し時に参照できる local 変数として定義します。
#
# リソースの追加・変更・削除はすべて config/*.yaml の編集のみで完結します。
# このファイル自体を変更する必要はありません。

locals {
  # --------------------------------------------------------------------------
  # 共通設定の読み込み
  # --------------------------------------------------------------------------
  # config/common.yaml を読み込み、VPC・GCE 共通設定を local として展開します。
  # main.tf の google_compute_network および module "gce_cluster" で参照されます。
  common_config = yamldecode(file("${path.module}/config/common.yaml"))

  # --------------------------------------------------------------------------
  # GCE インスタンス設定の読み込み
  # --------------------------------------------------------------------------
  # config/gce.yaml を文字列として読み込み、HCL の map(object) 型に変換します。
  # main.tf の module "gce_cluster" に env_instances として渡されます。
  gce_config = yamldecode(file("${path.module}/config/gce.yaml"))

  # --------------------------------------------------------------------------
  # Cloud SQL インスタンス設定の読み込み
  # --------------------------------------------------------------------------
  # config/sql.yaml を文字列として読み込み、HCL の map(object) 型に変換します。
  # main.tf の module "sql_cluster" に env_sql_instances として渡されます。
  sql_config = yamldecode(file("${path.module}/config/sql.yaml"))
}

# ==============================================================================
# ルートメイン構成ファイル (main.tf)
# ==============================================================================
# このファイルは、プロジェクト全体のネットワーク基盤を定義しつつ、
# 各カプセル化モジュールへと必要なリソース情報を受け渡す役割を担います。

# ------------------------------------------------------------------------------
# 1. 共有カスタムVPCネットワークの定義
# ------------------------------------------------------------------------------
resource "google_compute_network" "custom_vpc" {
  name                    = local.common_config.vpc.name
  auto_create_subnetworks = local.common_config.vpc.auto_create_subnetworks
  project                 = var.gcp_project_id
}

# ------------------------------------------------------------------------------
# 2. GCE（仮想マシン）モジュールの呼び出し
# ------------------------------------------------------------------------------
module "gce_cluster" {
  source                    = "./modules/gce"
  project_id                = var.gcp_project_id
  env_instances             = local.gce_config
  network_name              = google_compute_network.custom_vpc.name
  allow_stopping_for_update = local.common_config.gce.allow_stopping_for_update
}

# ------------------------------------------------------------------------------
# 3. Cloud SQLモジュールの呼び出し
# ------------------------------------------------------------------------------
module "sql_cluster" {
  source            = "./modules/sql"
  project_id        = var.gcp_project_id
  region            = var.gcp_region
  env_sql_instances = local.sql_config
}

################################################################################
# File:        variables.tf
# Project:     GCE Infrastructure
# Description: Global input variables for the environment
# Dependency:  None
# Compliance:  Standard Conventions 2.2 / 4.2
################################################################################
# このファイルでは、HCP Terraform から注入が必要な変数のみを定義します。
# それ以外の設定値は config/*.yaml で管理します。

# ------------------------------------------------------------------------------
# 1. GCP 接続用の基本変数定義（HCP Terraform Variables で管理）
# ------------------------------------------------------------------------------

variable "gcp_project_id" {
  type        = string
  description = "構築対象となる GCP プロジェクトID。HCP TF上の Variables（String形式）で指定します。"
}

variable "gcp_region" {
  type        = string
  default     = "asia-northeast1"
  description = "デフォルトで使用するリージョン。指定がない場合は東京リージョン（asia-northeast1）が自動選択されます。"
}

# ------------------------------------------------------------------------------
# ※ 削除済み変数について
# ------------------------------------------------------------------------------
# 以下の変数は YAML ドリブン化対応により削除しました。
# リソース設定は config/*.yaml を直接編集して管理してください。
#
#   - variable "env_instances"          → config/gce.yaml で管理
#   - variable "env_sql_instances"      → config/sql.yaml で管理
#   - variable "custom_vpc_name"        → config/common.yaml（vpc.name）で管理
#   - variable "auto_create_subnetworks"→ config/common.yaml（vpc.auto_create_subnetworks）で管理
#   - variable "allow_stopping_for_update" → config/common.yaml（gce.allow_stopping_for_update）で管理
#
# HCP Terraform の Variables 画面からも同名の変数を手動削除してください。
# ------------------------------------------------------------------------------

################################################################################  
# File:        versions.tf  
# Project:     GCE Infrastructure  
# Description: Terraform and Google Provider pinning  
# Dependency:  None  
# Compliance:  Standard Conventions 1.1  
################################################################################

terraform {
  # ----------------------------------------------------------------------------
  # 1. Terraform 本体のバージョン制約
  # ----------------------------------------------------------------------------
  # オブジェクト型変数内でデフォルト値を定義できる `optional()` 構文を利用するため、
  # Terraform v1.3.0 以上の実行環境を必須要件として定義しています。
  required_version = ">= 1.3.0"

  # ----------------------------------------------------------------------------
  # 2. 使用するプロバイダー（外部API連携用プラグイン）の定義
  # ----------------------------------------------------------------------------
  # 本プロジェクトで Google Cloud Platform (GCP) のリソースを管理するため、
  # HashiCorp社が提供・管理する公式の「google」プロバイダーを宣言します。
  required_providers {
    google = {
      source  = "hashicorp/google"
      # state を作成した v6.x 系以上を使用するよう制約を更新しています。
      version = ">= 6.0"
    }
  }
}

# ------------------------------------------------------------------------------
# 3. Google Cloud プロバイダーの接続設定
# ------------------------------------------------------------------------------
# 実際に GCP API と通信してリソースを操作するための認証と共通設定を行います。
# ここで使用されている `var.gcp_project_id` や `var.gcp_region` は、
# `variables.tf` で宣言され、HCP Terraform から動的に値が注入されます。
provider "google" {
  project = var.gcp_project_id # 構築対象となるGCPプロジェクトのID
  region  = var.gcp_region # デフォルトのリージョン（例: asia-northeast1）
}

################################################################################
# File:        config/common.yaml
# Project:     GCE / SQL Infrastructure
# Description: インフラ全体の共通設定 YAML 定義ファイル
#              VPC・GCE 共通オプションをここで一元管理します。
#              このファイルを編集するだけで設定変更が可能です。
################################################################################

# ------------------------------------------------------------------------------
# VPC ネットワーク設定
# ------------------------------------------------------------------------------
vpc:
  # カスタムVPCネットワークの名称（google_compute_network の name に対応）
  name: custom-vpc-network
  # サブネットをリージョンごとに自動作成するかどうか（true / false）
  auto_create_subnetworks: true

# ------------------------------------------------------------------------------
# GCE 共通設定
# ------------------------------------------------------------------------------
gce:
  # GCEインスタンスのマシンタイプ変更時に自動停止・再起動を許可するかどうか（true / false）
  # true  = 変更時に自動停止（推奨）
  # false = 手動停止が必要
  allow_stopping_for_update: true

################################################################################
# File:        config/gce.yaml
# Project:     GCE Infrastructure
# Description: GCE インスタンス設定の YAML 定義ファイル
#              このファイルを編集するだけで GCE インスタンスの追加・変更・削除が可能です。
#              キー名がそのままインスタンス名になります。
################################################################################

# ------------------------------------------------------------------------------
# 記述ルール
# ------------------------------------------------------------------------------
# <インスタンス名>:                       ← Terraform リソースのキー（= GCE インスタンス名）
#   machine_type: <マシンタイプ>           ← 必須（例: e2-small, e2-medium, n1-standard-2）
#   zone:         <ゾーン>                ← 必須（例: asia-northeast1-a）
#   disks:                               ← 省略可（省略時は追加ディスクなし）
#     - name:    <ディスク識別名>
#       size_gb: <容量(GB)>
#       type:    <ディスク種別>           ← 省略可（省略時: pd-standard）
# ------------------------------------------------------------------------------

web-server:
  machine_type: e2-small
  zone: asia-northeast1-a
  # disks は省略（追加ディスクなし）

app-server:
  machine_type: e2-medium
  zone: asia-northeast1-b
  # disks は省略（追加ディスクなし）

db-server:
  machine_type: e2-medium
  zone: asia-northeast1-c
  disks:
    - name: data-disk
      size_gb: 100
      type: pd-standard
    - name: backup-disk
      size_gb: 50
      # type は省略（デフォルト: pd-standard が適用されます）

db-server2:
  machine_type: e2-small
  zone: asia-northeast1-a
  disks:
    - name: data-disk
      size_gb: 100
      type: pd-standard
    - name: backup-disk
      size_gb: 50

################################################################################
# File:        config/sql.yaml
# Project:     SQL Infrastructure
# Description: Cloud SQL インスタンス設定の YAML 定義ファイル
#              このファイルを編集するだけで Cloud SQL インスタンスの追加・変更・削除が可能です。
#              キー名がそのままインスタンス名になります。
################################################################################

# ------------------------------------------------------------------------------
# 記述ルール
# ------------------------------------------------------------------------------
# <インスタンス名>:                            ← Terraform リソースのキー（= Cloud SQL インスタンス名）
#   database_version: <エンジン+バージョン>    ← 必須（例: POSTGRES_15, MYSQL_8_0）
#   tier:             <マシンスペック>          ← 必須（例: db-f1-micro, db-custom-2-7680）
#   availability_type: <可用性タイプ>           ← 省略可（省略時: ZONAL）REGIONAL or ZONAL
#   deletion_protection: <bool>               ← 省略可（省略時: true）本番は true 推奨
#   disk_size: <容量(GB)>                     ← 省略可（省略時: 10）
# ------------------------------------------------------------------------------

prod-db-main2:
  database_version: POSTGRES_15
  tier: db-custom-2-7680
  availability_type: REGIONAL
  deletion_protection: true
  disk_size: 50

dev-db:
  database_version: MYSQL_8_0
  tier: db-f1-micro
  availability_type: ZONAL
  deletion_protection: false
  disk_size: 10

# ==============================================================================
# GCE（仮想マシン）モジュールメイン定義ファイル (modules/gce/main.tf)
# ==============================================================================

# ------------------------------------------------------------------------------
# 1. 各VMのメインインスタンス定義
# ------------------------------------------------------------------------------
resource "google_compute_instance" "vm" {
  for_each                  = var.env_instances
  name                      = each.key
  machine_type              = each.value.machine_type
  zone                      = each.value.zone
  allow_stopping_for_update = var.allow_stopping_for_update # 修正：固定値から変数参照へ変更
  project                   = var.project_id

  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }

  network_interface {
    network = var.network_name
    access_config {}
  }

  lifecycle {
    ignore_changes = [boot_disk[0].initialize_params[0].image]
  }
}

# 2. 追加ディスクがある場合の処理（ディスク自体の作成）
locals {
  additional_disks = merge([
    for vm_key, vm_val in var.env_instances : {
      for disk in vm_val.disks :
      "${vm_key}-${disk.name}" => {
        vm_key  = vm_key
        zone    = vm_val.zone
        name    = disk.name
        size_gb = disk.size_gb
        type    = disk.type
      }
    }
  ]...)
}

resource "google_compute_disk" "disk" {
  for_each = local.additional_disks
  name     = each.key
  type     = each.value.type
  zone     = each.value.zone
  size     = each.value.size_gb
  project  = var.project_id
}

# 3. ディスクとVMのバインディング（接続）
resource "google_compute_attached_disk" "attach" {
  for_each    = local.additional_disks
  instance    = google_compute_instance.vm[each.value.vm_key].id
  disk        = google_compute_disk.disk[each.key].id
  device_name = each.value.name
  project     = var.project_id
}

# ==============================================================================
# GCE（仮想マシン）モジュール用 変数定義ファイル (modules/gce/variables.tf)
# ==============================================================================

variable "project_id" {
  type        = string
  description = "リソースをデプロイする対象のGCPプロジェクトID"
}

# ------------------------------------------------------------------------------
# 追加：ネットワーク接続用変数
# ------------------------------------------------------------------------------
# ルートモジュール（直下の main.tf）で定義されたカスタムVPCの名前を
# 子モジュール側で安全に受け取るための入力インターフェース変数です。
variable "network_name" {
  type        = string
  description = "VMインスタンスが接続されるVPCネットワークの名前"
}

# ------------------------------------------------------------------------------
# GCEインスタンス設定マップ
# ------------------------------------------------------------------------------
# 追加：ルートモジュールから引き渡される設定値の受け皿
variable "allow_stopping_for_update" {
  type        = bool
  description = "GCEインスタンス変更時に自動停止・再起動を許可するかどうか"
}

variable "env_instances" {
  type = map(object({
    machine_type = string
    zone         = string
    disks = optional(list(object({
      name    = string
      size_gb = number
      type    = optional(string, "pd-standard")
    })), [])
  }))
}

################################################################################
# File:        modules/sql/main.tf
# Project:     SQL Infrastructure
# Description: Definition of SQL instance with auto-lowercased names and labels
# Dependency:  None
# Compliance:  Standard Conventions 5.2 (CIS v8 Alignment) / 5.3
################################################################################
# このファイルでは、ルートモジュールからバケツリレーされた `env_sql_instances` 変数を使い、
# `for_each` 構文を用いて複数の Cloud SQL インスタンスを動的に作成します。

# ------------------------------------------------------------------------------
# 1. プライベートネットワーク (VPC) の定義
# ------------------------------------------------------------------------------
resource "google_compute_network" "private_network" {
  name                    = "sql-vpc-network"
  auto_create_subnetworks = true
  project                 = var.project_id # 追加：project を明示指定
}

# ------------------------------------------------------------------------------
# 2. Cloud SQL データベースインスタンスの動的作成
# ------------------------------------------------------------------------------
resource "google_sql_database_instance" "db" {
  for_each            = var.env_sql_instances
  name                = each.key
  database_version    = each.value.database_version
  deletion_protection = each.value.deletion_protection
  project             = var.project_id
  region              = var.region

  settings {
    tier              = each.value.tier
    availability_type = each.value.availability_type
    disk_size         = each.value.disk_size

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

################################################################################
# File:        modules/sql/variables.tf
# Project:     SQL Infrastructure
# Description: Module input definitions with strict validation
# Dependency:  None
# Compliance:  Standard Conventions 4.2
################################################################################
# このファイルでは、Cloud SQL インスタンスを動的に複数作成するために
# 必要となる設定情報のマップ（変数の構造型）を定義します。
# ルートモジュールからバケツリレーされてきた設定データを受け取る口になります。

# ------------------------------------------------------------------------------
# 追加：GCP プロジェクト ID
# ------------------------------------------------------------------------------
# ルートモジュールから project_id を受け取り、モジュール内リソースの project に渡します。
variable "project_id" {
  type        = string
  description = "リソースをデプロイする対象の GCP プロジェクト ID"
}

variable "region" {
  type        = string
  description = "リソースをデプロイする対象のリージョン"
}

variable "env_sql_instances" {
  type = map(object({
    # --------------------------------------------------------------------------
    # 必須パラメータ（各インスタンスで必ず指定が必要な項目）
    # --------------------------------------------------------------------------
    database_version = string # データベースエンジン名とバージョン（例: "POSTGRES_15"、"MYSQL_8_0"）
    tier             = string # インスタンスのマシンスペック・サイズ（例: "db-f1-micro"、"db-custom-2-7680"）

    # --------------------------------------------------------------------------
    # オプションパラメータ（省略時は optional の第2引数で定義されたデフォルト値が適用されます）
    # --------------------------------------------------------------------------

    # ① 可用性の配置オプション
    availability_type = optional(string, "ZONAL")

    # ② 削除保護の設定
    deletion_protection = optional(bool, true)

    # ③ 初期ディスク容量（GB単位）
    disk_size = optional(number, 10)
  }))
  description = "動的に作成する Cloud SQL インスタンス群の設定情報。config/sql.yaml から読み込まれます。"
}