ehealthafrica/concourse-fly Docker 镜像 - 轩辕镜像

Concourse fly CLI 镜像文档

1. 镜像概述

Concourse fly CLI镜像包含Concourse CI/CD平台的官方命令行工具(fly)，提供与Concourse部署实例的命令行交互能力。该镜像可替代本地安装fly CLI，尤其适用于容器化环境，通过Docker容器直接运行fly命令，避免本地环境依赖冲突，简化CI/CD流程的命令行操作。

2. 核心功能与特性

• 管道全生命周期管理：支持通过命令行创建、更新、删除、暂停、解锁Concourse管道，支持管道配置文件(YAML)的验证与应用。
• 任务执行与监控：可运行、取消、监控Concourse任务，查看任务日志、状态及执行结果，支持任务本地测试与远程执行。
• 资源与配置管理：管理Concourse资源类型、资源实例及资源版本，支持资源检查、获取与输出操作。
• 目标与认证管理：配置并管理多个Concourse部署目标（Targets），支持用户名/密码、令牌(Token)、SSH密钥等多种认证方式。
• 跨平台兼容性：基于Docker容器运行，兼容Linux、macOS、Windows等主流操作系统的Docker环境。

3. 使用场景

• CI/CD自动化脚本：在Shell/Python等自动化脚本中集成fly命令，实现管道自动部署、任务批量执行等流程。
• 多环境Concourse管理：通过容器化fly CLI快速切换不同Concourse实例（开发/测试/生产环境），避免本地配置冲突。
• Docker化开发环境：在无本地fly CLI安装的环境（如临时容器、CI runner）中，直接通过镜像运行fly命令。
• 管道配置验证：在提交管道配置前，通过镜像快速验证YAML配置文件的语法与合法性。

4. 使用方法与配置说明

4.1 基本使用（docker run命令示例）

通过docker run直接执行fly命令，基础格式：

bash
docker run --rm concourse/fly [fly命令及参数]

示例1：查看fly版本

bash
docker run --rm concourse/fly -v
# 输出示例：fly version 7.9.1

示例2：登录Concourse实例
需指定Concourse API地址、目标名称及认证信息：

bash
docker run --rm \
  -e CONCOURSE_API=[***] \
  -e CONCOURSE_USERNAME=admin \
  -e CONCOURSE_PASSWORD=secret \
  concourse/fly login --target my-target --insecure-skip-verify

说明：--insecure-skip-verify用于跳过SSL证书验证（仅测试环境使用），生产环境建议挂载证书。

示例3：创建/更新管道
需挂载本地管道配置文件（如pipeline.yml）到容器内，并指定目标：

bash
docker run --rm \
  -v $(pwd)/pipeline.yml:/pipeline.yml \
  concourse/fly set-pipeline --target my-target --pipeline my-pipeline --config /pipeline.yml

4.2 持久化配置（挂载.flyrc文件）

fly会将目标配置、认证信息保存在~/.flyrc文件中。为避免每次运行重新配置，可将本地.flyrc挂载到容器内：

bash
# 首次登录时挂载空文件，生成配置
docker run --rm \
  -v $(pwd)/.flyrc:/root/.flyrc \
  concourse/fly login --target my-target --api [***] --username admin --password secret

# 后续使用时直接挂载已生成的.flyrc，无需重复登录
docker run --rm \
  -v $(pwd)/.flyrc:/root/.flyrc \
  concourse/fly pipelines --target my-target

4.3 环境变量配置

通过环境变量简化命令参数，常用变量：

5. 常用命令示例

5.1 管理管道

• 查看所有管道：

  bash
  docker run --rm -v $(pwd)/.flyrc:/root/.flyrc concourse/fly pipelines --target my-target
  

• 更新管道配置：

  bash
  docker run --rm \
    -v $(pwd)/.flyrc:/root/.flyrc \
    -v $(pwd)/new-pipeline.yml:/new-pipeline.yml \
    concourse/fly set-pipeline --target my-target --pipeline my-pipeline --config /new-pipeline.yml
  

• 删除管道：

  bash
  docker run --rm -v $(pwd)/.flyrc:/root/.flyrc concourse/fly destroy-pipeline --target my-target --pipeline my-pipeline
  

5.2 执行与监控任务

• 运行单个任务（本地测试）：
  需挂载任务配置文件及输入资源目录：

  bash
  docker run --rm \
    -v $(pwd)/task.yml:/task.yml \
    -v $(pwd)/inputs:/inputs \
    concourse/fly execute --config /task.yml --input my-input=/inputs
  

• 查看任务日志：

  bash
  docker run --rm -v $(pwd)/.flyrc:/root/.flyrc \
    concourse/fly watch --job my-pipeline/my-job --build 1
  

6. 注意事项

• 权限管理：挂载本地文件（如.flyrc、管道配置）时，确保容器内用户（默认root）对挂载文件有读写权限。
• SSL证书：生产环境中，建议通过-v /path/to/certs:/etc/ssl/certs挂载CA证书，替代--insecure-skip-verify。
• 版本兼容性：镜像版本需与Concourse服务端版本匹配（如fly 7.x兼容Concourse 7.x），避免API不兼容问题。