swce/keyval-resource

Concourse CI键值资源镜像

镜像概述

该镜像实现Concourse CI中的键值资源，用于在任务之间传递键值对，无需依赖Git、S3等外部资源，简化工作流中的轻量级数据共享流程。

核心功能

1. check：生成单个虚拟键（无版本资源，行为为无操作）
2. in：获取键值对并存储到keyval.properties文件（格式为<key>=<value>）
3. out：读取指定的properties文件，将键值对传递给下一个任务

使用场景

• CI/CD工作流中，前序任务（如构建）将构建产物ID、版本号等信息传递给后续任务（如测试、部署）
• 无需外部存储即可实现任务间的快速数据传递

配置说明

资源类型配置

yaml
resource_types:
  - name: keyval
    type: docker-image
    source:
      repository: swce/keyval-resource

资源配置

yaml
resources:
  - name: keyval
    type: keyval

部署示例

以下是Concourse CI中使用该镜像的完整工作流示例：

yaml
resource_types:
  - name: keyval
    type: docker-image
    source:
      repository: swce/keyval-resource

resources:
  - name: keyval
    type: keyval

jobs:
  - name: build
    plan:
      - task: build
        file: tools/tasks/build/task.yml
      - put: keyval
        params:
          file: keyvalout/keyval.properties

  - name: test-deploy
    plan:
      - aggregate:
        - get: keyval
          passed: [build]
      - task: test-deploy
        file: tools/tasks/task.yml

实用脚本

自动导出键值对

在任务开始时添加以下脚本，自动导出传递的键值对（需source执行）：

bash
#!/bin/bash
props="${ROOT_FOLDER}/keyval/keyval.properties"
if [ -f "$props" ]; then
  echo "读取传递的键值对"
  while IFS= read -r var; do
    if [ ! -z "$var" ]; then
      echo "添加：$var"
      export "$var"
    fi
  done < "$props"
fi

自动传递键值对

在任务结束时添加以下脚本，自动传递以PASSED_开头的环境变量：

bash
#!/bin/bash
propsDir="${ROOT_FOLDER}/keyvalout"
propsFile="${propsDir}/keyval.properties"
if [ -d "$propsDir" ]; then
  touch "$propsFile"
  echo "在${propsFile}中设置传递给下一个任务的键值对"
  while IFS='=' read -r name value; do
    if [[ $name == 'PASSED_'* ]]; then
      echo "添加：${name}=${value}"
      echo "${name}=${value}" >> "$propsFile"
    fi
  done < <(env)
fi