watawuwu/docker-image-resource

Docker镜像资源

这是Concourse CI/CD平台的自定义资源类型，用于跟踪Docker镜像版本变化、构建Docker镜像（从Dockerfile）及与镜像仓库交互（拉取/推送镜像），支持私有仓库认证、AWS ECR凭证等多种配置。

核心功能

1. 版本跟踪：检查指定仓库和标签的镜像是否有更新（通过镜像摘要digest）。
2. 镜像拉取：从仓库拉取镜像，生成包含镜像ID、摘要、根文件系统（rootfs.tar）等信息的文件。
3. 镜像构建与推送：从Dockerfile构建镜像或加载本地镜像后推送至仓库，支持缓存、自定义构建参数等功能。

使用场景

• Concourse流水线中自动化构建并推送Docker镜像至仓库。
• 监控第三方镜像更新，触发后续部署/测试任务。
• 从私有仓库拉取镜像用于流水线容器化任务。

源配置（Source Configuration）

• repository（必填）：镜像仓库名称（如concourse/docker-image-resource），私有仓库需包含端口（如:443）。
• tag（可选）：跟踪的镜像标签，默认latest。
• username/password（可选）：仓库认证凭据。
• aws_access_key_id/aws_secret_access_key（可选）：AWS ECR凭证。
• insecure_registries（可选）：不安全仓库白名单（CIDR或host:port）。
• ca_certs（可选）：自定义CA证书数组，用于验证私有仓库证书。
• client_certs（可选）：客户端证书数组，用于仓库身份认证。

行为（Behavior）

check：检查新镜像

获取指定仓库和标签的镜像摘要，判断是否有更新。

in：拉取镜像

拉取镜像后生成以下文件：

• /image（若save=true）：docker save后的镜像文件。
• /repository：仓库名称。
• /image-id：镜像ID。
• /rootfs.tar（若rootfs=true）：镜像根文件系统压缩包。

参数

• save：是否保存镜像文件。
• rootfs：是否保存根文件系统。
• skip_download：是否跳过拉取操作。

out：推送或构建镜像

推送镜像至仓库，支持从Dockerfile构建或加载本地镜像。

参数

• build：包含Dockerfile的目录路径。
• load：使用同一资源拉取的镜像目录（需save=true）。
• cache：构建时是否使用缓存（默认false）。
• tag：包含标签名称的文件路径。
• build_args：Docker构建参数键值对。

示例

yaml
resources:
- name: git-resource
  type: git
  source: # Git资源配置

- name: git-resource-image
  type: docker-image
  source:
    repository: concourse/git-resource
    username: your-username
    password: your-password

jobs:
- name: build-rootfs
  plan:
  - get: git-resource
  - put: git-resource-image
    params: {build: git-resource}
    get_params: {rootfs: true}

开发指南

前提条件

• Golang 1.9.x+
• Docker 17.06.x+

运行测试

sh
docker build -t docker-image-resource .

贡献

提交PR至master分支，确保本地测试通过。