Registry Image Resource 测试镜像文档

镜像概述和主要用途

本镜像为测试专用镜像，旨在验证 Concourse Registry Image Resource（以下简称“Registry Image Resource”）的功能正确性。Registry Image Resource 是 Concourse CI/CD 系统中用于与容器镜像仓库交互的核心资源类型，本测试镜像提供标准化的测试环境，支持对该资源的各类功能进行验证。

核心功能和特性

• 基础功能验证：支持测试 Registry Image Resource 的镜像拉取、推送、标签管理等核心操作。
• 兼容性测试：可用于验证 Registry Image Resource 与不同版本 Concourse 平台及容器镜像仓库（如 Docker Hub、Harbor 等）的兼容性。
• 资源交互测试：模拟实际使用场景中的镜像资源输入/输出，验证资源在 Concourse 管道中的数据传递和状态同步能力。

使用场景和适用范围

目标用户

• Concourse CI/CD 平台开发者或维护者。
• Registry Image Resource 插件的开发者（用于功能开发或回归测试）。

典型场景

• 在 Registry Image Resource 新版本发布前，通过本镜像验证功能是否符合预期。
• 开发 Registry Image Resource 新特性时，作为测试环境验证功能正确性。
• 排查 Concourse 管道中镜像资源相关故障时，作为标准测试用例复现问题。

使用方法和配置说明

镜像拉取

通过以下命令拉取本测试镜像：

docker pull <镜像仓库地址>/registry-image-resource-test:latest

（注：实际使用时需替换 <镜像仓库地址> 为该测试镜像的具体仓库路径，如 Docker Hub 或私有仓库地址。）

基本使用（Docker 命令行）

本镜像为测试用途，无复杂运行逻辑，可通过以下命令快速验证镜像可用性：

docker run --rm <镜像仓库地址>/registry-image-resource-test:latest

运行后，镜像将执行预设的基础测试命令（如打印版本信息、模拟镜像元数据输出），用于确认镜像本身可正常工作。

在 Concourse 管道中配置

在 Concourse 管道中，可通过以下配置使用本测试镜像验证 Registry Image Resource 的功能。示例 pipeline.yml 片段如下：

resources:
- name: test-image
  type: registry-image
  source:
    repository: <镜像仓库地址>/registry-image-resource-test  # 测试镜像仓库地址
    tag: latest

- name: registry-image-resource  # 待测试的 Registry Image Resource
  type: registry-image
  source:
    repository: concourse/registry-image-resource  # Registry Image Resource 官方镜像
    tag: latest

jobs:
- name: test-registry-image-resource
  plan:
  - get: test-image  # 获取测试镜像
  - get: registry-image-resource  # 获取待测试的资源插件
  - task: run-tests
    config:
      platform: linux
      image_resource:
        type: registry-image
        source: {repository: alpine, tag: latest}
      inputs:
      - name: test-image
      - name: registry-image-resource
      run:
        path: sh
        args:
        - -c
        - |
          # 执行测试命令，验证 Registry Image Resource 能否正确处理 test-image
          ./registry-image-resource/bin/check test-image/.metadata.json  # 示例：检查镜像元数据

环境变量与配置参数

本镜像为测试专用，无需额外配置环境变量或参数。运行时仅需确保镜像可正常拉取，且测试环境（如 Concourse worker）已配置正确的镜像仓库访问权限。

部署方案示例

Docker 单机部署

通过以下命令快速运行测试镜像，验证本地环境是否可正常访问：

# 拉取并运行测试镜像
docker pull <镜像仓库地址>/registry-image-resource-test:latest
docker run --rm <镜像仓库地址>/registry-image-resource-test:latest

Concourse 管道集成部署

完整的 Concourse 管道配置示例（pipeline.yml）：

---
resources:
- name: test-image
  type: registry-image
  source:
    repository: <镜像仓库地址>/registry-image-resource-test
    tag: latest

- name: registry-image-resource
  type: registry-image
  source:
    repository: concourse/registry-image-resource
    tag: latest

jobs:
- name: validate-resource-functionality
  plan:
  - get: test-image
  - get: registry-image-resource
  - task: test-pull-operation
    config:
      platform: linux
      image_resource:
        type: registry-image
        source: {repository: alpine, tag: latest}
      inputs:
      - name: test-image
      - name: registry-image-resource
      run:
        path: sh
        args:
        - -c
        - |
          echo "Testing Registry Image Resource pull functionality..."
          # 模拟资源拉取操作验证
          ./registry-image-resource/bin/in test-image/ test-image/.metadata.json
          
  - task: test-push-operation
    config:
      platform: linux
      image_resource:
        type: registry-image
        source: {repository: alpine, tag: latest}
      inputs:
      - name: test-image
      - name: registry-image-resource
      run:
        path: sh
        args:
        - -c
        - |
          echo "Testing Registry Image Resource push functionality..."
          # 模拟资源推送操作验证（需配置仓库推送权限）
          ./registry-image-resource/bin/out test-image/ --params '{"tag": "test-push"}'

通过 fly set-pipeline -p test-registry-resource -c pipeline.yml 部署管道后，即可触发任务验证 Registry Image Resource 的拉取/推送等功能。