snapkitchen/concourse-packer-resource

Concourse Packer资源镜像

镜像概述

这是一个用于Concourse CI的资源镜像，旨在通过Packer工具自动化构建镜像（如AWS AMI等），适配Concourse CI的流水线工作流，支持灵活的参数配置以满足不同构建需求。

核心功能

• 支持指定Packer模板文件进行镜像构建
• 提供环境变量配置方式（直接设置或从文件读取）
• 支持外部JSON变量文件及显式变量键值对配置
• 可选强制构建（force）和调试模式（debug）
• 输出镜像artifact的ID作为版本标识，详细信息存入元数据

使用场景

• 在Concourse CI流水线中自动化构建云镜像（如AWS AMI、GCP镜像等）
• 结合版本控制和凭证管理，实现镜像构建的端到端自动化

配置说明

以下是out操作（构建镜像）的参数说明：

• template：必填，Packer模板文件的路径
• env_vars：可选，环境变量键值对字典
• env_vars_from_files：可选，从文件读取环境变量的键值对（键为变量名，值为文件路径）
• var_files：可选，外部JSON变量文件路径列表
• vars：可选，Packer变量的显式键值对字典
• vars_from_files：可选，从文件读取Packer变量的键值对（键为变量名，值为文件路径）
• force：可选，是否启用Packer的force选项，默认false
• debug：可选，是否启用调试模式（可能泄露凭证），默认false

注意：为防止凭证泄露到日志，失败时不会打印完整Packer命令行，但仍需将敏感变量标记为Packer模板中的敏感变量，避免Packer在日志中输出。

示例

yaml
resource_types:
- name: packer
  type: docker-image
  source:
    repository: snapkitchen/concourse-packer-resource
    tag: 1.4.3

resources:
- name: build-ami
  type: packer

jobs:
- name: my-ami
  plan:
  - get: my-ami-template
  - get: role-credentials
  - put: build-ami
    params:
      template: my-ami-template/template.json
      var_files:
      - my-ami-template/my-vars.json
      env_vars:
        AWS_DEFAULT_REGION: ((aws_region))
      env_vars_from_files:
        AWS_ACCESS_KEY_ID: role-credentials/access-key-id
        AWS_SECRET_ACCESS_KEY: role-credentials/secret-access-key
        AWS_SESSION_TOKEN: role-credentials/session-token
      vars:
        environment: dev
        package_version: 1.2.3
      vars_from_files:
        commit_ref: my-ami-template/.git/short_ref

许可协议

详情请查看LICENSE文件。