dockfool/cake-docker Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Cake Docker镜像

镜像概述

Cake Docker镜像是一个预配置的Cake构建环境，旨在提供便捷、一致的Cake（C# Make）构建工具运行环境。Cake是一个跨平台的构建自动化系统，支持使用C#、F#等脚本语言编写构建脚本。该镜像消除了本地安装Cake的需求，可直接用于执行各类Cake构建任务，确保构建环境的一致性。

核心功能与特性

• 预配置Cake环境：内置最新稳定版Cake工具及依赖组件，开箱即可使用
• 跨平台兼容性：基于多架构基础镜像构建，支持Linux、Windows等主流操作系统
• 轻量级设计：采用精简基础镜像，减少镜像体积，提升运行效率
• 灵活构建支持：兼容Cake脚本的多种语法特性，支持自定义构建目标、参数及扩展
• 环境隔离：通过容器化方式提供独立构建环境，避免与本地系统环境冲突

使用场景

• CI/CD流程集成：适用于Jenkins、GitHub Actions、GitLab CI等CI/CD平台，实现自动化构建流程
• 开发环境快速验证：开发人员无需本地配置Cake，通过容器快速测试构建脚本
• 团队协作环境统一：确保团队成员使用相同的构建工具版本和环境配置，避免"环境差异"问题
• 多版本构建测试：通过不同标签的镜像版本，测试构建脚本在不同Cake版本下的兼容性

使用方法与配置说明

基本使用方式

通过以下命令启动容器并运行Cake构建（需将当前项目目录挂载至容器内）：

bash
docker run -v $(pwd):/app -w /app gitfool/cake-docker cake build.cake

参数说明：

• -v $(pwd):/app：将当前目录（项目根目录）挂载至容器内的/app目录
• -w /app：设置容器工作目录为/app（项目根目录）
• cake build.cake：执行Cake命令，运行项目根目录下的build.cake脚本

自定义构建参数

可通过命令行参数指定构建目标、配置等自定义选项：

bash
# 执行指定目标并设置构建配置
docker run -v $(pwd):/app -w /app gitfool/cake-docker cake build.cake --target=Publish --configuration=Release

# 传递自定义构建参数
docker run -v $(pwd):/app -w /app gitfool/cake-docker cake build.cake --MyCustomParam=value

Docker Compose配置示例

在docker-compose.yml中集成Cake构建服务：

yaml
version: '3.8'
services:
  cake-build:
    image: gitfool/cake-docker
    volumes:
      - ./:/app  # 挂载项目目录
      - ~/.nuget/packages:/root/.nuget/packages  # 可选：挂载NuGet缓存，加速依赖下载
    working_dir: /app
    command: cake build.cake --target=Build  # 指定构建命令及目标
    environment:
      - NUGET_SOURCE=https://api.nuget.org/v3/index.json  # 自定义NuGet源（可选）

启动构建：

bash
docker-compose run cake-build

环境变量配置

镜像支持通过环境变量自定义构建行为，常用环境变量如下：

示例：通过环境变量指定默认脚本和参数

bash
docker run -v $(pwd):/app -w /app \
  -e CAKE_SCRIPT=custom-build.cake \
  -e CAKE_ARGUMENTS="--configuration=Debug" \
  gitfool/cake-docker cake

注意事项

• 挂载目录权限：确保本地项目目录对容器有读写权限，避免因权限不足导致构建失败
• 镜像版本控制：建议通过镜像标签指定Cake版本（如gitfool/cake-docker:1.3.0），确保构建稳定性
• 依赖缓存：对于频繁构建场景，可挂载NuGet缓存目录（如~/.nuget/packages）加速依赖下载
• 复杂构建需求：如需使用额外工具（如.NET SDK、特定编译器），可基于此镜像扩展构建自定义镜像

详细Dockerfile配置及更新说明，请参考官方代码仓库。