dzonder/semaphore

Semaphore (semaphoreui/semaphore:latest) 镜像文档

镜像概述

Semaphore 是一款轻量级开源CI/CD（持续集成/持续部署）平台，旨在简化软件开发流程中的自动化构建、测试和部署环节。本镜像基于官方最新版本 semaphoreui/semaphore:latest 构建，额外集成了 rsync 工具，增强了文件同步与跨节点传输能力，适用于需要在CI/CD流程中高效处理文件传输的场景。

核心功能与特性

1. 完整CI/CD流程支持

• 继承官方 semaphoreui/semaphore:latest 的全部核心功能，包括流水线配置、多阶段任务管理、并行执行、测试报告集成等。
• 提供直观的Web界面，支持通过YAML配置文件或UI操作定义CI/CD流程。

2. rsync工具集成

• 在官方镜像基础上预装 rsync 命令行工具，支持：
  • 增量文件同步（仅传输变更内容，减少带宽占用）
  • 远程服务器文件传输（通过SSH协议或rsync守护进程）
  • 文件压缩传输、权限保留、校验和验证等高级同步特性。

3. 兼容性与易用性

• 基于官方最新稳定版本构建，兼容Semaphore的所有原生配置与插件生态。
• 支持多架构运行（如amd64、arm64，具体取决于官方基础镜像支持）。

使用场景

• 代码与资源同步：在CI/CD流水线中同步代码仓库、依赖文件或构建产物至测试/生产环境。
• 跨服务器部署：通过rsync将构建后的应用文件高效传输至目标服务器，适用于小型部署场景。
• 本地开发测试：快速搭建包含文件同步能力的CI/CD测试环境，验证流水线中文件传输逻辑。

使用方法

1. 拉取镜像

bash
docker pull semaphoreui/semaphore:latest

2. 基本运行示例

以下命令启动Semaphore容器，映射Web端口（默认8080）并持久化数据：

bash
docker run -d \
  --name semaphore \
  -p 8080:8080 \
  -v /path/on/host/semaphore/data:/var/lib/semaphore \
  semaphoreui/semaphore:latest

说明：/path/on/host/semaphore/data 为宿主机目录，用于持久化Semaphore的配置、任务记录等数据。

3. 在CI/CD流水线中使用rsync

在Semaphore的任务配置（如 .semaphore/semaphore.yml）中，可直接调用 rsync 命令进行文件同步。示例场景：将构建产物同步至远程服务器：

yaml
version: v1.0
name: Sync build artifacts
agent:
  machine:
    type: e1-standard-2
blocks:
  - name: Sync with remote server
    task:
      jobs:
        - name: rsync transfer
          commands:
            - checkout
            - ./build.sh  # 构建应用，生成产物到 ./dist 目录
            - rsync -avz ./dist/ user@remote-server:/opt/app/  # 使用rsync同步

注意：需确保容器内已配置远程服务器的SSH密钥（可通过挂载宿主机密钥文件或环境变量注入实现）。

4. 核心配置参数

环境变量

Semaphore运行依赖部分环境变量（详细列表见官方文档），常用配置包括：

数据持久化

建议通过 -v 参数挂载以下目录（根据实际需求调整）：

• /var/lib/semaphore：核心数据目录（配置、任务记录等）
• /root/.ssh：SSH密钥目录（用于rsync远程认证）

注意事项

• 网络权限：若需通过rsync访问外部服务器，需确保容器网络可连接目标服务器的SSH端口（默认22）或rsync端口（默认873）。
• 镜像更新：本镜像基于官方 latest 标签构建，建议定期拉取更新以同步官方功能修复与安全补丁。
• 初始化配置：首次启动后，访问 http://<容器IP>:8080 完成管理员账户设置及基础配置（参考官方初始化指南）。

参考链接

• Semaphore官方文档
• rsync官方手册