lmnas/turbo-braccoli Docker 镜像 - 轩辕镜像

Turbo Repo for Stunning Broccoli 镜像文档

镜像概述

Turbo Repo for Stunning Broccoli 是基于 Turbo Repo 构建的 Docker 镜像，专为 Stunning Broccoli 项目优化，提供一站式的多包项目管理解决方案。该镜像集成了 Turbo Repo 的核心功能，旨在简化多包项目（如 monorepo）的依赖管理、任务调度、构建流程和部署流程，提升开发效率和项目可维护性。

核心功能与特性

核心功能

• 多包项目管理：支持 monorepo 架构，统一管理多个关联包，简化跨包依赖关系维护
• 高效任务调度：内置任务并行执行引擎，自动优化任务执行顺序，减少构建时间
• 智能缓存机制：基于文件内容和依赖关系的增量构建缓存，避免重复构建
• 跨平台兼容性：支持 Linux/Windows/macOS 环境下的一致构建行为
• 与 Stunning Broccoli 深度集成：针对 Stunning Broccoli 项目的特定构建流程和依赖配置优化

主要特性

• 预配置的 Turbo Repo 环境，无需手动安装依赖
• 内置 Node.js 和 npm/yarn/pnpm 包管理器，支持多种包管理工具
• 支持自定义任务配置和环境变量注入
• 轻量级镜像设计，基于 Alpine Linux，减小镜像体积

使用场景与适用范围

适用场景

• 大型前端项目（如 React/Vue/Angular 应用）的 monorepo 管理
• 多包库开发（如组件库、工具库）的统一构建与发布
• 需要跨团队协作的复杂项目依赖管理
• Stunning Broccoli 项目的标准化开发与部署流程

适用人群

• 前端开发工程师
• 全栈开发团队
• DevOps 工程师（负责项目构建与部署流程）

使用方法与配置说明

前提条件

• 已安装 Docker Engine (20.10.0+)/Docker Desktop
• 熟悉 Docker 基本操作（如 docker run、docker volume）
• Stunning Broccoli 项目代码（本地或远程仓库）

基本使用方法

1. 拉取镜像

bash
docker pull turborepo/stunning-broccoli:latest

2. 运行容器（基础用法）

bash
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  turborepo/stunning-broccoli:latest \
  turbo run build

• -v $(pwd):/app：将本地项目目录挂载到容器内 /app 目录
• -w /app：设置工作目录为 /app
• turbo run build：执行 Turbo Repo 的 build 任务

3. 执行自定义任务

bash
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  turborepo/stunning-broccoli:latest \
  turbo run lint test build

高级配置

环境变量

示例：使用远程缓存

bash
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  -e TURBO_TOKEN=your_turbo_token \
  -e TURBO_TEAM=your_team_name \
  turborepo/stunning-broccoli:latest \
  turbo run build --remote-cache=team

Docker Compose 配置示例

创建 docker-compose.yml：

yaml
version: '3.8'
services:
  turbo:
    image: turborepo/stunning-broccoli:latest
    volumes:
      - ./:/app
    working_dir: /app
    environment:
      - TURBO_TOKEN=your_turbo_token
      - TURBO_TEAM=your_team_name
      - NODE_ENV=production
      - PACKAGE_MANAGER=pnpm
    command: turbo run build test deploy

启动服务：

bash
docker-compose up

持久化缓存

为避免每次运行容器时重新构建缓存，可挂载缓存目录：

bash
docker run -it --rm \
  -v $(pwd):/app \
  -v turbo-cache:/root/.turbo \
  -w /app \
  turborepo/stunning-broccoli:latest \
  turbo run build

其中 turbo-cache 为 Docker 卷，用于持久化 Turbo 缓存数据。

注意事项

• 确保本地项目目录包含有效的 turbo.json 配置文件（Turbo Repo 配置）
• 首次运行时可能需要安装项目依赖（可通过 docker run ... npm install 执行）
• 远程缓存功能需要 Turbo 账户（可通过 Turbo 官网 注册）
• 对于大型项目，建议增加容器内存限制（如 --memory=4g）以避免构建过程中内存不足