swisleiden/fluo-dev-php

Fluo项目开发/CI环境镜像

概述

本Docker镜像专为Fluo项目设计，提供一站式的开发与CI（持续集成）环境。通过预配置Fluo项目所需的依赖组件、开发工具及CI流程支持，简化开发环境搭建流程，确保开发、测试与集成环境的一致性，提升团队协作效率。

核心功能与特性

环境预配置

• 集成Fluo框架及相关依赖库，无需手动安装
• 预装Java开发环境（JDK）、构建工具（如Maven/Gradle）及版本控制工具（Git）
• 包含CI流程常用工具（如测试框架、代码质量检查工具）

开发与CI支持

• 支持本地开发环境快速启动，可直接挂载项目代码进行调试
• 兼容主流CI/CD平台（如Jenkins、GitHub Actions、GitLab CI）
• 提供环境变量自定义接口，支持版本控制与配置个性化

环境一致性保障

• 标准化环境配置，避免"开发环境正常，生产环境异常"问题
• 容器化隔离，确保不同项目/版本间无依赖冲突
• 轻量级设计，启动快速且资源占用低

使用场景

本地开发环境搭建

• 快速初始化Fluo项目开发环境，无需手动配置依赖
• 多版本Fluo项目并行开发时，通过容器隔离实现环境切换

CI/CD流程集成

• 作为CI流水线的执行环境，自动化运行测试、构建与部署流程
• 与代码托管平台（GitHub/GitLab）集成，触发提交后自动构建验证

团队协作支持

• 统一团队开发环境，降低"环境配置不一致"导致的协作成本
• 新人入职时，通过镜像快速获取标准化开发环境，缩短上手周期

使用方法

基本使用（本地开发）

通过docker run命令启动交互式开发环境，挂载本地项目目录至容器内：

bash
# 启动容器并进入交互式终端
docker run -it --rm \
  -v $(pwd):/workspace \  # 挂载本地项目目录到容器内/workspace
  -w /workspace \         # 设置工作目录为项目目录
  fluo/dev-ci:latest \    # 镜像名称（请替换为实际镜像标签）
  bash                    # 启动bash终端

进入容器后，可直接执行Fluo项目开发命令（如编译、测试）：

bash
# 示例：编译项目
mvn clean package

# 示例：运行Fluo任务
fluo exec my-task

CI流程集成示例（GitHub Actions）

在项目的.github/workflows/ci.yml中配置使用本镜像：

yaml
name: Fluo CI

on: [push, pull_request]

jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Run CI with Fluo dev/ci environment
        uses: docker://fluo/dev-ci:latest
        with:
          entrypoint: /bin/bash
          args: |
            cd /github/workspace
            mvn clean test  # 执行测试
            mvn package     # 构建产物

环境变量配置

通过-e参数自定义环境变量，支持以下常用配置：

示例：指定Fluo 2.0版本启动容器

bash
docker run -it --rm \
  -e FLUO_VERSION=2.0 \
  -v $(pwd):/workspace \
  fluo/dev-ci:latest \
  bash

注意事项

• 权限管理：挂载本地目录时，若出现权限问题，可通过-u $(id -u):$(id -g)参数指定当前用户ID，避免容器内权限冲突：

  bash
  docker run -it --rm \
    -u $(id -u):$(id -g) \
    -v $(pwd):/workspace \
    fluo/dev-ci:latest \
    bash
  

• 持久化数据：如需保存容器内的配置或构建缓存，可使用Docker卷（Volume）替代目录挂载：

  bash
  # 创建持久化卷
  docker volume create fluo-cache
  # 使用卷挂载缓存目录
  docker run -it --rm \
    -v fluo-cache:/root/.m2 \  # 持久化Maven缓存
    -v $(pwd):/workspace \
    fluo/dev-ci:latest \
    bash
  

• 镜像更新：定期拉取最新镜像以获取依赖更新：

  bash
  docker pull fluo/dev-ci:latest