xetamus/redis-resource

Redis Resource镜像说明

镜像概述

该镜像作为Concourse CI的资源类型，提供Redis数据存储的访问能力。通过它，用户可在流水线中实现状态跟踪、跨任务数据传递等功能，无需在任务镜像中集成Redis客户端，避免污染目标测试镜像。

核心功能

1. 状态跟踪：记录流水线运行间的临时状态，支持统一仪表盘展示所有流水线状态；
2. 跨任务数据传递：在不同作业间传递数据（如通过Git提交哈希关联的数据）；
3. 版本管理：存储版本字符串，无需依赖外部存储（如S3、GitHub），支持多分支并行版本跟踪；
4. 简化连接：通过source配置处理Redis连接细节（主机、端口、密码等），用户无需手动操作Redis。

使用场景

• 统一监控：收集所有流水线状态数据，展示在统一仪表盘；
• 测试结果控制：记录测试通过/失败状态，用于控制代码合并（如Atlassian Stash插件）；
• 跨作业数据共享：在不同作业间传递数据，突破单计划内任务输入输出的限制；
• 多分支版本跟踪：结合git-multibranch-resource，为每个分支存储独立版本字符串。

配置说明

源配置（Source Configuration）

示例配置

资源类型定义

yaml
resource_types:
  - name: redis
    type: docker-image
    source:
      repository: xetamus/redis-resource

资源定义

yaml
resources:
- name: redis-values
  type: redis
  source:
    host: redis.myorg.com
    password: my-hard-to-guess-password
    db_number: 3
    keys:
      - this-key
      - that-key
      - "a:prefix:*"

流水线步骤示例

从Redis获取值：

yaml
- get: redis-values

向Redis推送值：

yaml
- put: redis-values
  params: {from: results}

行为说明

check：检查键内容变化或新增匹配键

拉取键值生成文件（文件名=键，内容=值），若文件内容的SHA1哈希变化，则报告新版本。

in：将匹配键的内容存储到文件系统

拉取键值并写入文件系统，文件名对应键名，内容对应键值。

out：向Redis推送数据

将from参数指定目录下的文件（文件名匹配键）内容推送到Redis。注意：若推送的键是子集，后续get会生成不同的引用ID。

推送参数

• from：必填，包含待推送文件（文件名对应键）的目录路径。 ===FULL_DESC===