avvo/docker-image-resource

Docker Image Resource

镜像概述

本镜像为Avvo提供的Concourse CI资源类型，用于在CI/CD流程中自动化管理Docker镜像的生命周期，包括跟踪镜像版本变化、拉取镜像文件、构建Dockerfile并推送镜像到指定registry。

核心功能

1. Check：检测指定仓库和标签的镜像是否有新版本（通过镜像digest判断）
2. In：从registry拉取镜像，输出镜像文件、rootfs.tar、镜像ID等关键信息
3. Out：构建Dockerfile并推送镜像，或推送已有的镜像文件到目标registry

使用场景

• CI/CD流水线中自动构建应用镜像并推送到私有/公有registry
• 跟踪镜像版本变化，触发后续部署或测试流程
• 拉取镜像文件用于离线环境部署或镜像内容分析

配置说明

Source Configuration

Behavior

Check

获取指定tag的镜像digest，检测是否有版本更新。

In

拉取镜像并输出以下文件到目标目录：

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

参数：save、rootfs、skip_download、dockerhost

Out

推送镜像到registry，支持以下操作：

• 构建指定目录的Dockerfile并推送
• 加载已有镜像文件并推送
• 导入文件为镜像并推送

参数：build、dockerfile、cache、load_base、load_file、import_file、pull_repository、tag、tag_prefix、tag_as_latest、dockerhost

示例配置

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}

该示例展示了如何使用本资源构建git-resource镜像，并将镜像的rootfs.tar文件推送到S3存储。 ===FULL_DESC===