TerraformとCloudFormationを比較する設計判断｜HCLとYAML・状態管理・マルチクラウド対応とロールバックの選択基準

この記事のポイント

・TerraformはtfstateをS3等に保管し自分で管理するが、CloudFormationはAWSがStack状態を管理する
・HCL（Terraform）はYAML/JSON（CloudFormation）より変数・ループ・モジュール化が読みやすく書きやすい
・マルチクラウド（AWS＋Azure＋GCP）を扱う場合はTerraform一択、AWSのみならCloudFormationも有力な選択肢
・Terraformのapply失敗は手動ロールバックが必要だが、CloudFormationはStack単位の自動ロールバックが標準機能

# Terraform: S3バックエンドでstateを共有する例
terraform {
  backend "s3" {
    bucket         = "mycompany-tfstate"
    key            = "production/main/terraform.tfstate"
    region         = "ap-northeast-1"
    encrypt        = true
    dynamodb_table = "terraform-lock"  # stateロック用
  }
}

# Terraform (HCL): for_eachで複数サブネットを一括定義
variable "subnet_cidrs" {
  type    = map(string)
  default = {
    public_a  = "10.0.0.0/24"
    public_c  = "10.0.1.0/24"
    private_a = "10.0.2.0/24"
  }
}

resource "aws_subnet" "this" {
  for_each          = var.subnet_cidrs
  vpc_id            = aws_vpc.main.id
  cidr_block        = each.value
  availability_zone = lookup(local.az_map, each.key, "ap-northeast-1a")
}

# CloudFormation (YAML): サブネットを個別に定義（繰り返し構文がない）
Resources:
  SubnetPublicA:
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: "10.0.0.0/24"
  SubnetPublicC:
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: "10.0.1.0/24"
  # 3つ目以降も同様に繰り返す...

# Terraform: AWSとAzureを1つのコードで管理する例
terraform {
  required_providers {
    aws   = { source = "hashicorp/aws",   version = "~> 5.0" }
    azurerm = { source = "hashicorp/azurerm", version = "~> 3.0" }
  }
}

# AWS側のリソース
resource "aws_s3_bucket" "logs" {
  bucket = "mycompany-logs-aws"
}

# Azure側のリソース（同じtfstateで管理）
resource "azurerm_storage_account" "logs" {
  name                = "mycompanylogsazure"
  resource_group_name = azurerm_resource_group.main.name
  location            = "japaneast"
  account_tier        = "Standard"
  account_replication_type = "LRS"
}

# CloudFormation: Stack更新失敗時のログ例（自動ロールバックあり）
Status: UPDATE_ROLLBACK_COMPLETE
Status reason: The following resource(s) failed to update: [WebServer].
  Rollback requested by user.

# Stackの状態は自動的に更新前に戻る
aws cloudformation describe-stacks --stack-name my-stack   --query 'Stacks[0].StackStatus'
# "UPDATE_ROLLBACK_COMPLETE"

# Terraform: apply失敗後の状態確認
$ terraform apply

aws_instance.web: Creating...
Error: InvalidParameterValue: Invalid availability zone: ap-northeast-1x

# 成功したリソースはtfstateに記録済み
$ terraform state list
aws_vpc.main
aws_subnet.public_a
# aws_instance.web は作成されていない（途中停止）

# 対処: エラーを修正してterraform applyを再実行
# または作成済みリソースを一部破棄してからapply
$ terraform destroy -target aws_subnet.public_a