cwlf/concourse-fly-resource

Concourse Fly资源镜像

镜像概述

本镜像为Concourse CI/CD工具的fly资源，用于在Concourse流水线中操作fly客户端，实现与Concourse实例的交互（如触发作业、同步版本等）。支持基础认证，兼容Concourse 3.x及以上版本（具体版本对应关系见下文）。

核心功能

1. 执行fly命令：支持通过参数或文件传递命令选项，执行触发作业、管理流水线等操作。
2. 自动同步版本：若本地fly客户端与Concourse实例版本不匹配，自动执行fly sync更新。
3. 基础认证支持：通过用户名/密码登录Concourse实例，支持自定义目标实例、团队等配置。
4. 调试与安全控制：可开启调试模式打印命令细节，或控制输出安全性。

使用场景

• 在Concourse流水线中自动化触发指定作业。
• 批量管理Concourse流水线或资源。
• 同步fly客户端版本以匹配Concourse实例。

配置说明

资源类型配置

在Concourse流水线中定义该资源类型：

yaml
resource_types:
- name: fly
  type: docker-image
  source:
    repository: troykinsella/concourse-fly-resource
    tag: latest  # 根据Concourse版本选择对应标签（如3.x用1.x）

源配置

配置Concourse实例连接信息：

示例：

yaml
resources:
- name: fly-resource
  type: fly
  source:
    url: {{concourse_url}}
    username: ((concourse_username))
    password: ((concourse_password))
    team: my-team

行为说明

• check：无操作（No-Op）。
• in：无操作（No-Op）。
• out：执行fly命令，自动下载/同步fly客户端，支持多行命令（每行单独执行）。

out参数：

• options：传递给fly的命令选项（如trigger-job -j pipeline/job）。
• options_file：包含命令选项的文件路径。

示例（触发作业）：

yaml
- name: trigger-job
  plan:
  - put: fly-resource
    params:
      options: trigger-job -j my-pipeline/my-job

版本兼容性

许可证

MIT © Troy Kinsella