trecnoc/concourse-rsync

Concourse镜像（集成Rsync）

镜像概述

本镜像基于starkandwayne/concourse构建，是Concourse CI/CD平台的运行环境，并额外集成了Rsync工具。Concourse是一个开源的CI/CD系统，专注于自动化构建、测试和部署流程；Rsync则是一款高效的文件同步工具，支持增量传输和跨系统文件复制。该镜像结合两者优势，适用于需要在CI/CD流程中进行文件同步的场景。

核心功能与特性

基础功能

• 完整包含Concourse CI/CD平台的核心组件，支持流水线定义、资源管理、任务执行等标准CI/CD功能
• 兼容Concourse官方的配置方式和扩展机制

扩展特性

• 集成Rsync工具，支持以下功能：
  • 本地与远程服务器间的文件同步
  • 增量文件传输，减少带宽占用
  • 支持文件权限保留、符号链接处理等高级同步选项
  • 通过rsync命令直接在CI/CD任务中调用

使用场景与适用范围

典型使用场景

• CI/CD流水线中构建产物的跨服务器同步
• 配置文件或依赖包的批量分发
• 测试环境与生产环境间的文件同步
• 需要高效增量传输的文件备份流程

适用人群

• DevOps工程师
• CI/CD流程维护人员
• 需要在自动化流程中集成文件同步的开发团队

使用方法与配置说明

基本部署

Docker Run命令

bash
docker run -d \
  -p 8080:8080 \
  -p 2222:2222 \
  --name concourse-rsync \
  --env CONCOURSE_EXTERNAL_URL=http://localhost:8080 \
  --env CONCOURSE_BASIC_AUTH_USERNAME=admin \
  --env CONCOURSE_BASIC_AUTH_PASSWORD=password \
  starkandwayne/concourse-rsync

Docker Compose配置示例

yaml
version: '3'
services:
  concourse:
    image: starkandwayne/concourse-rsync
    ports:
      - "8080:8080"  # Web UI端口
      - "2222:2222"  # Worker SSH端口
    environment:
      - CONCOURSE_EXTERNAL_URL=http://localhost:8080
      - CONCOURSE_BASIC_AUTH_USERNAME=admin
      - CONCOURSE_BASIC_AUTH_PASSWORD=password
    volumes:
      - ./concourse-data:/concourse/data
    restart: always

在Concourse任务中使用Rsync

在Concourse流水线任务中，可直接调用rsync命令进行文件同步。以下是一个任务示例：

yaml
jobs:
  - name: sync-files
    plan:
      - get: source-code
      - task: build-and-sync
        config:
          platform: linux
          image_resource:
            type: docker-image
            source: {repository: starkandwayne/concourse-rsync}
          inputs:
            - name: source-code
          run:
            path: sh
            args:
              - -c
              - |
                # 构建项目
                cd source-code
                make build
                
                # 使用Rsync同步构建产物到目标服务器
                rsync -avz ./dist/ user@target-server:/var/www/app/

环境变量配置

该镜像继承了starkandwayne/concourse的所有环境变量配置，主要包括：

注意事项

• 使用Rsync进行远程同步时，需确保目标服务器已配置SSH访问权限（可通过密钥或密码认证）
• 生产环境中建议使用持久化存储卷（如示例中的./concourse-data）保存Concourse数据
• 调整rsync命令参数时，可参考Rsync官方文档（man rsync）获取更多选项说明