chingor13/docker-image-resource

Docker镜像资源

用于跟踪和构建https://docker.io%E9%95%9C%E5%83%8F%E3%80%82%E6%B3%A8%E6%84%8F%EF%BC%9ADocker%E6%B3%A8%E5%86%8C%E8%A1%A8%E5%BF%85%E9%A1%BB%E6%98%AFv2%E7%89%88%E6%9C%AC%E3%80%82

镜像概述

该资源是Concourse CI的核心组件，用于管理Docker镜像的全生命周期，包括版本跟踪、镜像拉取、Dockerfile构建及镜像推送。支持私有注册表认证、自定义CA证书、不安全注册表白名单等扩展功能。

核心功能

1. 镜像更新检查：获取指定仓库和标签的镜像摘要，检测版本更新。
2. 镜像拉取：从注册表拉取镜像，并生成镜像ID、摘要、根文件系统tar包等元数据文件。
3. 镜像构建与推送：从Dockerfile构建镜像，支持缓存构建、基础镜像加载，并推送至目标仓库。

使用场景

• Concourse CI流水线中自动化构建Docker镜像。
• 监控第三方Docker镜像更新，触发后续部署或测试任务。
• 推送自定义镜像至私有/公共Docker注册表。

配置说明

源配置（Source Configuration）

• repository: 必填。仓库名称（如concourse/docker-image-resource）。私有注册表需包含端口（如:443）。
• tag: 可选。跟踪的标签，默认latest。
• username/password: 可选。注册表认证凭据。
• insecure_registries: 可选。不安全注册表白名单（CIDR或host:port格式）。
• registry_mirror: 可选。Docker镜像加速服务URL。
• ca_certs: 可选。自定义CA证书数组，用于验证私有注册表证书。示例：

  yaml
  ca_certs:
  - domain: example.com:443
    cert: |
      -----BEGIN CERTIFICATE-----
      ...
      -----END CERTIFICATE-----
  

行为（Behavior）

check：检查新镜像

获取指定仓库和标签的当前镜像摘要。

in：拉取镜像

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

• /image: docker save导出的镜像（需save=true）。
• /repository//tag: 仓库名称和标签。
• /image-id//digest: 镜像ID和摘要。
• /rootfs.tar: 镜像根文件系统（需rootfs=true）。

参数：save/rootfs/skip_download/dockerhost。

out：推送镜像

构建并推送镜像至目标仓库。支持build（Dockerfile路径）、cache（缓存构建）、tag_as_latest（标记为latest）等参数。

示例

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

- name: git-resource-rootfs
  type: s3
  source: # S3资源配置

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}