Skip to content
Packer AWS AMI Builder

Packer AWS AMI Builder Skill

HashiCorp's official Packer skill for building Amazon Machine Images with the amazon-ebs builder, covering template structure, plugin pinning and the cost and timing caveats.

GitHub Docs

Install

Install with the skills CLI

One command for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and dozens of other agents. Needs Node.js; the skill is fetched straight from hashicorp/agent-skills.

$ npx skills add hashicorp/agent-skills --skill aws-ami-builder

Run it in a terminal. The CLI finds the agents installed on your machine, asks which ones to add the skill to, and whether to install it into the folder you ran it from or for all your projects.

Other ways to install

  1. Open the skill on GitHub and download the folder that holds its SKILL.md.
  2. Put it at ~/.claude/skills/aws-ami-builder/, where Claude Code picks it up in every project.

No scripts or references next to it? Saving the SKILL.md alone as ~/.claude/skills/aws-ami-builder/SKILL.md works too.

Using another agent? Its personal skills folder
Codex
~/.agents/skills/
Cursor
~/.cursor/skills/
GitHub Copilot
~/.copilot/skills/
Gemini CLI
~/.gemini/skills/
Windsurf
~/.codeium/windsurf/skills/
OpenCode
~/.config/opencode/skills/

About

  • Complete amazon-ebs builder template in HCL with required_plugins pinning
  • Parameterised region and source AMI selection
  • Warns that builds incur EC2, EBS and data-transfer costs and take 10-30 minutes
  • Links directly to the canonical Amazon EBS builder documentation
  • Part of HashiCorp's four-skill Packer plugin alongside Azure, Windows and registry-push skills

aws-ami-builder is one of four Packer skills in HashiCorp's official agent-skills repository, which also publishes sixteen Terraform skills. It teaches an agent to write and run Packer templates that produce Amazon Machine Images using the amazon-ebs builder — the standard path for baking golden images for EC2.

The skill leads with a working HCL template rather than prose: a packer block pinning the github.com/hashicorp/amazon plugin to ~> 1.3, a parameterised region variable, source AMI selection, and the build and provisioner structure around it. Pinning the plugin version in required_plugins is the detail that matters most in practice, because an unpinned Packer build is not reproducible across machines or CI runners.

It is also honest about the operational cost, which most tutorials skip: building AMIs incurs real AWS charges — EC2 instance time, EBS storage and data transfer — and a build typically takes 10 to 30 minutes depending on how much provisioning happens inside the image. That is the difference between an agent that offers to "just try a build" and one that tells you what the attempt costs first.

The skill points at HashiCorp's canonical Amazon EBS Builder documentation rather than restating it, so it stays current as the builder evolves. Its sibling Packer skills cover Azure image building, Windows image builds, and pushing finished artifacts to a registry.

Installation. npx skills add hashicorp/agent-skills/plugins/packer/skills/aws-ami-builder for this skill alone, or claude plugin marketplace add hashicorp/agent-skills followed by claude plugin install packer@hashicorp for the whole Packer bundle. Licensed MPL-2.0.

Best for platform teams maintaining golden AMIs and anyone whose CI pipeline bakes images. It assumes AWS credentials and Packer are already installed, and it deliberately does not cover Terraform provisioning of the resulting AMI — that is what the Terraform skills in the same repository are for.

Try it

Once installed, ask your agent something like:

Write me a Packer template that bakes an Ubuntu 24.04 AMI in eu-west-1 with our Datadog agent pre-installed.

SKILL.md

The instructions your agent loads, as published by HashiCorp.

SKILL.md
name
aws-ami-builder
description
Build Amazon Machine Images (AMIs) with Packer using the amazon-ebs builder. Use when creating custom AMIs for EC2 instances.
metadata
lifecycle-status: active

AWS AMI Builder

Build Amazon Machine Images (AMIs) using Packer's amazon-ebs builder.

Reference: Amazon EBS Builder

Note: Building AMIs incurs AWS costs (EC2 instances, EBS storage, data transfer). Builds typically take 10-30 minutes depending on provisioning complexity.
Basic AMI Template
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",
    ]
  }
}
Common Source AMI Filters
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"]
}
Multi-Region 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}"

  # Copy to additional regions
  ami_regions = ["us-east-1", "us-east-2", "eu-west-1"]
}
Authentication

Packer uses AWS credential resolution:

  1. Environment variables: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY
  2. AWS credentials file: ~/.aws/credentials
  3. IAM instance profile (when running on 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 .
Build Commands
# Initialize plugins
packer init .

# Validate template
packer validate .

# Build AMI
packer build .

# Build with variables
packer build -var "region=us-east-1" .
Common Issues

SSH Timeout

  • Ensure security group allows SSH (port 22)
  • Verify subnet has internet access

AMI Already Exists

  • AMI names must be unique
  • Use timestamp in name: my-app-${local.timestamp}

Volume Size Too Small

  • Check source AMI's volume size
  • Set launch_block_device_mappings.volume_size accordingly
References
Install

Covered in the Weekly

Skill: AWS CDK

by Amazon Web Services

Featured

Official AWS skill for authoring, deploying and debugging CDK stacks — construct patterns, bootstrap, drift, resource import and the CloudFormation errors that trap people.

Browse all skills →