packer

构建不可变机器镜像

补充说明

packer 从基础镜像启动临时实例，执行 provisioner 安装软件，再产出云镜像或容器镜像。它适合构建不可变基础设施，不负责运行时编排。

常用示例

packer init .
packer validate .
packer fmt .
packer build .
packer build -var 'version=1.2.3' .
packer build -only='amazon-ebs.ubuntu' .
packer inspect .
packer hcl2_upgrade template.json

HCL 模板：

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

source "amazon-ebs" "ubuntu" {
  ami_name      = "app-{{timestamp}}"
  instance_type = "t3.micro"
  region        = "ap-southeast-1"
  source_ami    = "ami-0123456789"
  ssh_username  = "ubuntu"
}

build {
  sources = ["source.amazon-ebs.ubuntu"]
  provisioner "shell" {
    script = "scripts/setup.sh"
  }
}

易错点与排错

• 先 packer init 安装插件；缺少插件时 validate/build 都会失败。
• HCL 和旧 JSON 模板不兼容；迁移用 hcl2_upgrade 后再人工检查。
• builder 名称和 source 引用要一致；-only 的值写错会静默不构建。
• provisioner 按顺序执行；前一步失败后默认停止，调试时看日志定位。
• SSH/WinRM 连接失败常和网络、用户、密钥有关；先确认临时实例可达。
• 变量没有默认值时会交互询问；CI 中用 -var-file 或环境变量提供。
• 镜像构建会启动临时实例并计费；失败后确认没有残留资源。
• 插件和基础镜像版本要固定；否则同一模板产出的镜像会漂移。

相关命令

• terraform — 使用构建好的镜像
• vagrant — 本地虚拟机环境
• docker — 容器镜像构建