Terraformのdata sourceで既存AWSリソースを参照する方法｜aws_ami・aws_vpc・aws_subnetsのfilter設計

この記事のポイント

・data sourceはリソースを作らず既存の属性値をTerraformコードへ動的に取り込む仕組み
・aws_amiでmost_recent=trueとfilterを組み合わせると常に最新AMIを自動参照できる
・aws_vpc・aws_subnetsで既存VPCのサブネットIDを一覧取得しEC2やALBへ渡せる
・「No results」エラーはfilterのName値とAWSのタグ名の不一致が主な原因

# AMI IDとサブネットIDをベタ書き（問題のある書き方）
resource "aws_instance" "web" {
  ami           = "ami-0abcdef1234567890"  # 廃止されてもすぐ気づかない
  instance_type = "t3.micro"
  subnet_id     = "subnet-xxxxxxxx"        # 環境ごとにコードを複製する羽目になる
}

# resource: Terraformが作成・管理する（tfstateに記録される）
resource "aws_vpc" "new_vpc" {
  cidr_block = "10.0.0.0/16"
}

# data: すでにあるリソースを読み取るだけ（作成・変更・削除しない）
data "aws_vpc" "existing" {
  filter {
    name   = "tag:Name"
    values = ["production-vpc"]
  }
}

# data sourceへの参照は data.タイプ.名前.属性名 の形式
output "existing_vpc_cidr" {
  value = data.aws_vpc.existing.cidr_block
}

data "aws_ami" "example" {
  most_recent = true
  owners      = ["amazon"]

  # filterは複数書けばAND条件で絞り込まれる
  filter {
    name   = "name"            # AMIの名前フィールド（ワイルドカード可）
    values = ["al2023-ami-*"]
  }

  filter {
    name   = "architecture"
    values = ["x86_64"]        # valuesの中はOR条件
  }
}

# main.tf
data "aws_ami" "amzn2023" {
  most_recent = true
  owners      = ["amazon"]

  filter {
    name   = "name"
    values = ["al2023-ami-2023*-x86_64"]
  }

  filter {
    name   = "virtualization-type"
    values = ["hvm"]
  }
}

resource "aws_instance" "web" {
  ami           = data.aws_ami.amzn2023.id  # data sourceで動的参照
  instance_type = "t3.micro"

  tags = {
    Name = "web-server"
  }
}

# terraform plan の実行例（ap-northeast-1リージョン）
$ terraform plan
data.aws_ami.amzn2023: Reading...
data.aws_ami.amzn2023: Read complete after 1s [id=ami-0b5c74e235407b044]

Terraform will perform the following actions:

  # aws_instance.web will be created
  + resource "aws_instance" "web" {
      + ami                                  = "ami-0b5c74e235407b044"
      + instance_type                        = "t3.micro"
      + tags                                 = {
          + "Name" = "web-server"
        }
      ...
    }

Plan: 1 to add, 0 to change, 0 to destroy.

data "aws_ami" "ubuntu_2404" {
  most_recent = true
  owners      = ["099720109477"]  # CanonicalのAWSアカウントID（固定値）

  filter {
    name   = "name"
    values = ["ubuntu/images/hvm-ssd-gp3/ubuntu-noble-24.04-amd64-server-*"]
  }

  filter {
    name   = "virtualization-type"
    values = ["hvm"]
  }
}

# Nameタグで既存VPCを参照
data "aws_vpc" "production" {
  filter {
    name   = "tag:Name"
    values = ["production-vpc"]
  }
}

# 取得した属性値の参照例
output "vpc_id"   { value = data.aws_vpc.production.id }
output "vpc_cidr" { value = data.aws_vpc.production.cidr_block }

# VPC内のプライベートサブネットIDをすべて取得
data "aws_subnets" "private" {
  filter {
    name   = "vpc-id"
    values = [data.aws_vpc.production.id]
  }

  filter {
    name   = "tag:Type"
    values = ["private"]
  }
}

# ALBにサブネットIDリストをそのまま渡す
resource "aws_lb" "app" {
  name               = "app-alb"
  internal           = true
  load_balancer_type = "application"
  subnets            = data.aws_subnets.private.ids  # IDリストを直接渡せる
}

# 既存VPCをタグで参照
data "aws_vpc" "main" {
  filter {
    name   = "tag:Name"
    values = ["main-vpc"]
  }
}

# 最新Amazon Linux 2023 AMIを動的取得
data "aws_ami" "amzn2023" {
  most_recent = true
  owners      = ["amazon"]
  filter {
    name   = "name"
    values = ["al2023-ami-2023*-x86_64"]
  }
}

# パブリックサブネットを取得
data "aws_subnets" "public" {
  filter {
    name   = "vpc-id"
    values = [data.aws_vpc.main.id]
  }
  filter {
    name   = "tag:Type"
    values = ["public"]
  }
}

# EC2インスタンス（IDハードコードなし）
resource "aws_instance" "web" {
  ami           = data.aws_ami.amzn2023.id
  instance_type = "t3.micro"
  subnet_id     = data.aws_subnets.public.ids[0]

  tags = {
    Name = "web-server"
  }
}

data "aws_caller_identity" "current" {}

# S3バケットポリシーでアカウントIDをハードコードしない
resource "aws_s3_bucket_policy" "example" {
  bucket = aws_s3_bucket.example.id
  policy = jsonencode({
    Statement = [{
      Effect    = "Allow"
      Principal = {
        AWS = "arn:aws:iam::${data.aws_caller_identity.current.account_id}:root"
      }
      Action   = "s3:GetObject"
      Resource = "${aws_s3_bucket.example.arn}/*"
    }]
  })
}

# 現在のリージョン名を取得（マルチリージョン展開で使う）
data "aws_region" "current" {}

# 利用可能なAZを全取得（stateでフィルタリング可能）
data "aws_availability_zones" "available" {
  state = "available"
}

# 先頭2つのAZにサブネットを作成（AZ名のハードコードなし）
resource "aws_subnet" "public_a" {
  vpc_id            = aws_vpc.main.id
  cidr_block        = "10.0.1.0/24"
  availability_zone = data.aws_availability_zones.available.names[0]
}

resource "aws_subnet" "public_c" {
  vpc_id            = aws_vpc.main.id
  cidr_block        = "10.0.2.0/24"
  availability_zone = data.aws_availability_zones.available.names[1]
}

$ terraform plan
# エラー出力例
Error: Your query returned no results. Please change your search criteria and try again.

  with data.aws_ami.amzn2023,
  on main.tf line 1, in data "aws_ami" "amzn2023":
   1: data "aws_ami" "amzn2023" {

$ terraform plan
# エラー出力例
Error: Your query returned more than one result. Please try a more specific search criteria.

  with data.aws_vpc.main,
  on main.tf line 10, in data "aws_vpc" "main":
  10: data "aws_vpc" "main" {

# stateを最新のAWS状態に同期する（リソースの変更はしない）
$ terraform plan -refresh-only
$ terraform apply -refresh-only