hashicorppreview/packer

Packer Docker镜像文档

镜像概述和主要用途

Packer 是一款免费开源工具，用于从单一源配置为多个平台创建黄金镜像（基础镜像）。本镜像基于 Packer 工具构建，提供容器化的 Packer 运行环境，方便用户在隔离环境中执行镜像构建操作。

注意：本仓库中的镜像为 开发版（dev），仅适用于开发和测试场景。生产环境中应使用稳定版镜像，可从 https://hub.docker.com/r/hashicorp/packer 获取。

核心功能和特性

• 开源免费：遵循开源许可协议，可自由使用和修改
• 单一源配置：通过一份配置文件定义镜像构建逻辑，简化多平台镜像管理
• 多平台支持：支持为云平台（AWS、Azure、GCP 等）、容器（Docker、LXC）、虚拟机（VMware、VirtualBox 等）构建镜像
• 自动化构建：支持集成到 CI/CD 流程，实现镜像构建的自动化和标准化

使用场景和适用范围

• 开发环境镜像构建：快速生成一致的开发环境基础镜像，确保团队开发环境统一
• CI/CD 流程集成：作为流水线中的构建步骤，自动生成测试或生产环境所需的黄金镜像
• 跨平台镜像管理：通过单一配置文件，同时维护多个目标平台的镜像构建逻辑，减少重复工作
• 镜像版本控制：结合版本控制系统，追踪镜像配置变更，实现镜像构建过程的可追溯

详细的使用方法和配置说明

获取镜像

从 Docker Hub 获取开发版镜像：

bash
docker pull hashicorp/packer-dev  # 示例镜像名，具体以实际仓库为准

说明：生产环境请使用稳定版镜像 hashicorp/packer

基本使用

1. 查看 Packer 版本

验证镜像可用性：

bash
docker run --rm hashicorp/packer-dev packer --version

2. 构建镜像

通过挂载本地配置文件，执行 packer build 命令构建镜像：

bash
# 假设本地配置文件为 ./packer-template.json
docker run --rm -v $(pwd):/workspace -w /workspace hashicorp/packer-dev packer build packer-template.json

• -v $(pwd):/workspace：将当前目录挂载到容器内 /workspace 目录，使容器可访问本地配置文件
• -w /workspace：设置工作目录为 /workspace，确保 Packer 能找到配置文件

配置参数

Packer 的核心配置通过 配置文件（JSON/HCL 格式） 定义，具体语法和参数可参考 Packer 官方文档。容器化使用时，需确保配置文件通过挂载方式传入容器。

环境变量

Packer 支持通过环境变量进行运行时配置，常用变量包括：

• PACKER_LOG：启用日志输出（设为 1 开启）
• PACKER_LOG_PATH：指定日志文件路径（如 /workspace/packer.log）
• 云平台相关变量（如 AWS_ACCESS_KEY_ID、AZURE_CLIENT_ID 等）：用于认证云服务提供商，避免硬编码密钥到配置文件

注意事项

• 开发版镜像限制：本镜像为 dev 版本，可能包含未稳定的功能或 bug，禁止用于生产环境，生产环境请使用 hashicorp/packer 稳定版镜像
• 文件权限：挂载本地目录时，需确保容器内用户（通常为 root）对挂载目录有读写权限，避免因权限问题导致配置文件无法读取
• 网络访问：构建过程中若需访问外部服务（如 Docker Hub、云平台 API），需确保容器网络通畅（默认使用宿主网络模式，或配置自定义网络）

Docker Compose 配置示例（可选）

若需在多步骤构建流程中集成 Packer，可使用 docker-compose.yml 简化配置：

yaml
version: '3'
services:
  packer:
    image: hashicorp/packer-dev
    volumes:
      - ./packer-config:/workspace  # 挂载本地配置目录
      - /var/run/docker.sock:/var/run/docker.sock  # 如需构建 Docker 镜像，挂载 Docker 套接字
    working_dir: /workspace
    environment:
      - PACKER_LOG=1
      - PACKER_LOG_PATH=/workspace/packer.log
    command: packer build template.pkr.hcl

运行命令：docker-compose up

参考链接

• Packer 官方文档
• https://hub.docker.com/r/hashicorp/packer
• https://github.com/hashicorp/packer