AWS AMI Builder

Packer の amazon-ebs builder を使用して Amazon Machine Images (AMI) をビルドします。

参照: Amazon EBS Builder

注: AMI のビルドには AWS コストが発生します (EC2 インスタンス、EBS ストレージ、データ転送)。ビルドは通常、プロビジョニングの複雑さに応じて 10～30 分かかります。

基本的な AMI テンプレート

packer {
  required_plugins {
    amazon = {
      source  = "github.com/hashicorp/amazon"
      version = "~> 1.3"
    }
  }
}

variable "region" {
  type    = string
  default = "us-west-2"
}

locals {
  timestamp = regex_replace(timestamp(), "[- TZ:]", "")
}

source "amazon-ebs" "ubuntu" {
  region        = var.region
  instance_type = "t3.micro"

  source_ami_filter {
    filters = {
      name                = "ubuntu/images/*ubuntu-jammy-22.04-amd64-server-*"
      root-device-type    = "ebs"
      virtualization-type = "hvm"
    }
    most_recent = true
    owners      = ["099720109477"] # Canonical
  }

  ssh_username = "ubuntu"
  ami_name     = "my-app-${local.timestamp}"

  tags = {
    Name      = "my-app"
    BuildDate = local.timestamp
  }
}

build {
  sources = ["source.amazon-ebs.ubuntu"]

  provisioner "shell" {
    inline = [
      "sudo apt-get update",
      "sudo apt-get upgrade -y",
    ]
  }
}

一般的なソース AMI フィルター

Ubuntu 22.04 LTS

source_ami_filter {
  filters = {
    name                = "ubuntu/images/*ubuntu-jammy-22.04-amd64-server-*"
    root-device-type    = "ebs"
    virtualization-type = "hvm"
  }
  most_recent = true
  owners      = ["099720109477"] # Canonical
}

Amazon Linux 2023

source_ami_filter {
  filters = {
    name                = "al2023-ami-*-x86_64"
    root-device-type    = "ebs"
    virtualization-type = "hvm"
  }
  most_recent = true
  owners      = ["amazon"]
}

マルチリージョン AMI

source "amazon-ebs" "ubuntu" {
  region        = "us-west-2"
  instance_type = "t3.micro"

  source_ami_filter {
    filters = {
      name = "ubuntu/images/*ubuntu-jammy-22.04-amd64-server-*"
    }
    most_recent = true
    owners      = ["099720109477"]
  }

  ssh_username = "ubuntu"
  ami_name     = "my-app-${local.timestamp}"

  # 追加リージョンにコピー
  ami_regions = ["us-east-1", "us-east-2", "eu-west-1"]
}

認証

Packer は AWS 認証情報解決を使用します：

1. 環境変数: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY
2. AWS 認証情報ファイル: ~/.aws/credentials
3. IAM インスタンスプロファイル (EC2 で実行している場合)

export AWS_ACCESS_KEY_ID="your-access-key"
export AWS_SECRET_ACCESS_KEY="your-secret-key"
export AWS_REGION="us-west-2"

packer build .

ビルドコマンド

# プラグインを初期化
packer init .

# テンプレートを検証
packer validate .

# AMI をビルド
packer build .

# 変数を指定してビルド
packer build -var "region=us-east-1" .

よくある問題

SSH タイムアウト

• セキュリティグループが SSH (ポート 22) を許可していることを確認
• サブネットがインターネットアクセスを持っていることを確認

AMI が既に存在する

• AMI 名は一意である必要があります
• 名前にタイムスタンプを使用: my-app-${local.timestamp}

ボリュームサイズが小さすぎる

• ソース AMI のボリュームサイズを確認
• 必要に応じて launch_block_device_mappings.volume_size を設定

参照

• Amazon EBS Builder
• AWS AMI ドキュメント