thesofproject/zephyr-lite

zephyr-build-lite Docker镜像文档

1. 镜像概述

zephyr-build-lite是官方zephyr-build镜像的精简版本，专为Zephyr RTOS嵌入式开发设计。该镜像通过优化依赖组件和工具链，在保留核心构建能力的同时显著减小体积，为资源受限环境提供高效、轻量的项目构建支持，适用于嵌入式开发、CI/CD流水线及低配置开发环境。

2. 核心功能与特性

2.1 核心功能

• 集成Zephyr RTOS构建所需的核心工具链（交叉编译器、CMake、Ninja、west等）
• 支持主流Zephyr目标平台的固件编译与生成
• 提供基础开发工具链，满足标准Zephyr项目构建流程需求

2.2 主要特性

• 精简体积：相比标准版镜像减少30%+存储空间占用，降低部署和传输成本
• 轻量级依赖：去除非必要工具和文档，仅保留核心构建组件，减少运行时资源消耗
• 快速启动：优化容器启动流程，缩短环境准备时间，提升开发效率
• 版本兼容：与官方zephyr-build镜像保持核心功能兼容性，确保构建流程一致性
• 跨平台支持：适配x86_64和ARM架构的Docker环境，满足不同开发场景需求

3. 使用场景与适用范围

• 嵌入式开发环境：Zephyr RTOS应用程序的轻量级本地开发与调试
• CI/CD流水线：资源受限的持续集成场景，降低构建节点资源占用
• 边缘设备开发：适用于边缘计算设备或低配置服务器的嵌入式项目构建
• 教学与原型验证：轻量级Zephyr入门学习、课程实验及项目原型快速验证
• 容器化构建：标准化开发环境，避免"本地环境不一致"导致的构建问题

4. 使用方法与配置说明

4.1 基础使用流程

4.1.1 拉取镜像

bash
docker pull [镜像仓库地址]/zephyr-build-lite:[版本标签]
# 示例（假设官方仓库）：docker pull zephyrproject/zephyr-build-lite:latest

4.1.2 运行构建容器

bash
docker run -it --rm \
  -v /本地/zephyr项目路径:/workspace \
  -w /workspace \
  [镜像仓库地址]/zephyr-build-lite:[版本标签] \
  west build -b [目标板型号] app

参数说明：

• -it：交互式终端模式，支持实时命令输入与输出
• --rm：容器退出后自动清理，避免残留临时文件
• -v /本地/zephyr项目路径:/workspace：将本地Zephyr项目目录挂载至容器工作区
• -w /workspace：设置容器工作目录为项目挂载路径
• west build -b [目标板型号] app：Zephyr项目构建命令（需替换[目标板型号]为实际硬件平台，如nrf52840dk_nrf52840）

4.2 高级配置

4.2.1 环境变量配置

4.2.2 自定义构建示例（指定Release类型）

bash
docker run -it --rm \
  -v /home/user/zephyr-project:/workspace \
  -w /workspace \
  -e CMAKE_BUILD_TYPE=Release \
  -e CMAKE_EXPORT_COMPILE_COMMANDS=ON \
  zephyrproject/zephyr-build-lite:latest \
  west build -b nrf52840dk_nrf52840 app

4.3 Docker Compose配置示例

yaml
version: '3.8'
services:
  zephyr-build:
    image: zephyrproject/zephyr-build-lite:latest
    volumes:
      - ./zephyr-project:/workspace
    working_dir: /workspace
    environment:
      - ZEPHYR_BASE=/workspace/zephyr
      - CMAKE_BUILD_TYPE=Debug
      - ZEPHYR_TOOLCHAIN_VARIANT=gnuarmemb
    command: >
      sh -c "west update && west build -b stm32l475vg_disco app"

5. 注意事项

• 确保本地项目路径包含完整的Zephyr项目结构（需包含app目录及zephyr源码依赖）
• 首次使用时建议执行west update同步项目依赖（可在容器内或本地执行）
• 不同版本标签对应不同Zephyr SDK版本，需根据项目需求选择匹配版本（如2.7.0对应Zephyr SDK 2.7.0）
• 资源受限环境下建议设置容器内存限制（如--memory=2g），避免资源耗尽
• 构建大型项目时可能需要增加容器CPU配额（如--cpus=2）以提升编译速度