potyarkin/cirrus-run Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

cirrus-run Docker镜像

镜像概述

cirrus-run是一个命令行工具，用于在Cirrus CI中执行构建作业。它通过本地YAML配置文件定义构建流程，但需要关联GitHub仓库和分支以确定构建的所有权。该工具支持与其他源码托管平台（如GitLab）集成，可在GitLab CI等环境中触发Cirrus CI构建。

项目状态：Beta版软件，已被多个第三方用于构建CI流水线。新版本可能包含破坏性变更，建议生产环境使用时固定特定版本。

核心功能和特性

• 支持通过本地YAML文件或Jinja2模板（.j2或.jinja2后缀）定义构建配置
• 允许指定GitHub仓库和分支作为构建的所有权关联（与实际构建内容无关）
• 提供详细的命令行参数控制构建行为，如超时设置、日志输出策略等
• 支持通过环境变量传递配置参数，增强安全性和灵活性
• 可集成到非GitHub的CI/CD平台（如GitLab CI）

使用场景

• 在GitLab CI中触发Cirrus CI构建作业
• 本地测试Cirrus CI配置文件的有效性
• 为非GitHub托管的项目提供Cirrus CI构建能力
• 自动化跨平台CI流程，结合不同源码托管平台的优势

安装与使用

Docker镜像获取

bash
docker pull potyarkin/cirrus-run

基本使用示例

通过环境变量配置

bash
docker run -e CIRRUS_API_TOKEN=<your_token> \
           -e CIRRUS_GITHUB_REPO=owner/repo \
           -v $(pwd):/workspace \
           potyarkin/cirrus-run /workspace/.cirrus.yml

直接指定参数

bash
docker run -v $(pwd):/workspace \
           potyarkin/cirrus-run \
           --token <your_token> \
           --github owner/repo \
           --branch main \
           /workspace/.cirrus.yml.j2

配置文件说明

默认配置文件路径优先级：$CIRRUS_CONFIG > .cirrus.yml > .cirrus.yml.j2。Jinja2模板文件中可使用环境变量。

配置参数说明

位置参数

可选参数

支持与贡献

• 问题反馈：通过GitHub Issues报告bug或提出功能请求
• 代码贡献：提交Pull Request参与开发
• 讨论交流：可通过issue tracker或邮件进行沟通（邮件地址见GitHub个人资料）

许可证信息

版权所有 2020-2021 Vitaly Potyarkin

本软件基于Apache License 2.0许可协议发布。详情请参见Apache License 2.0。