timotto/docker-image-resource

Docker Image Resource（Concourse资源）

镜像概述

该镜像为Concourse CI/CD系统提供docker-image资源类型，用于跟踪Docker镜像版本、执行镜像拉取、构建及推送操作，支持带TLS认证的TCP Docker守护进程参数，适配v2版本的Docker Registry。

核心功能

1. check：检查指定仓库和标签的Docker镜像是否有新版本（获取镜像摘要）。
2. in：从Registry拉取镜像，输出镜像文件、元数据等 artifacts（如image-id、digest、rootfs.tar等）。
3. out：构建Dockerfile生成镜像并推送至Registry，或推送已加载的镜像。

使用场景

• CI/CD流水线中自动化构建和推送自定义Docker镜像。
• 跟踪Docker镜像版本变化，触发后续部署流程。
• 管理私有Registry中的镜像生命周期（需配置认证信息）。

配置说明

源配置（Source Configuration）

• repository（必填）：镜像仓库名称，如concourse/docker-image-resource；私有Registry需包含端口（如:443或:5000）。
• tag（可选）：跟踪的镜像标签，默认latest。
• username（可选）：推送镜像时的认证用户名。
• password（可选）：推送镜像时的认证密码。
• aws_access_key_id（可选）：获取ECR凭证的AWS访问密钥ID。
• aws_secret_access_key（可选）：获取ECR凭证的AWS秘密访问密钥。
• insecure_registries（可选）：允许不安全访问的地址列表（http或未验证https），格式为CIDR或host:port。
• registry_mirror（可选）：Docker Registry镜像服务URL。
• ca_certs（可选）：自定义CA证书列表，用于验证Registry的证书（格式为包含domain和cert的对象数组）。
• client_certs（可选）：客户端证书列表，用于向Registry认证（格式为包含domain、cert和key的对象数组）。

行为参数

in（拉取镜像）

• save（可选）：是否保存docker save后的镜像文件。
• rootfs（可选）：是否输出镜像内容的tar包（rootfs.tar）。
• skip_download（可选）：是否跳过docker pull，此时镜像相关 artifacts不会生成。

out（构建/推送镜像）

• build（可选）：包含Dockerfile的目录路径。
• load（可选）：通过该资源拉取的镜像目录路径（需save: true）。
• dockerfile（可选）：Dockerfile的路径（若不在目录根目录）。
• cache（可选）：构建时是否使用缓存（默认false）。
• cache_tag（可选）：缓存使用的标签（默认tag）。
• tag（可选）：包含标签名称的文件路径。
• tag_prefix（可选）：标签前缀（如添加"v"）。
• tag_as_latest（可选）：是否同时标记为latest（默认false）。
• build_args（可选）：Docker构建参数映射。
• build_args_file（可选）：包含构建参数的JSON文件路径。

部署示例

Concourse流水线配置示例

yaml
resources:
- name: git-resource
  type: git
  source: # Git仓库配置（如url、branch等）

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

- name: git-resource-rootfs
  type: s3
  source: # S3存储配置（如bucket、access_key_id等）

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