WEBKT

嵌入式 CI 实战：Docker + Makefile 实现驱动交叉编译的“环境无关化”

3 0 0 0

在嵌入式开发领域，最令开发者头疼的往往不是代码逻辑本身，而是交叉编译环境的维护。

“我的电脑能编过，你的为什么不行？”
“为了编这个驱动，我得装 Ubuntu 16.04，但我主力机是 22.04……”
“换了个新同事，配置交叉工具链又花了一整天。”

这些场景在传统的嵌入式开发中屡见不鲜。随着 DevOps 理念在底层开发的渗透，利用 Docker 容器化编译环境，结合 Makefile 屏蔽构建细节，并集成到 CI（持续集成） 流水线中，已成为现代嵌入式团队的标配。本文将分享如何从零构建这一套自动化的驱动编译方案。

一、 核心思路：环境即代码

我们的目标是将复杂的交叉工具链（Linaro, GCC-ARM, etc.）、依赖库、内核头文件全部封装进一个标准的 Docker 镜像中。

  • Docker：负责提供一致的运行时环境，确保流水线上的每一台 Runner 以及开发者的本地机器，使用的都是同一个版本的编译器。
  • Makefile：作为构建接口，负责协调编译器路径、内核源码目录（KDIR）以及编译目标。
  • CI Pipeline：触发构建动作，并将生成的 .ko 驱动文件作为 Artifacts 输出。

二、 实战步骤

1. 编写 Dockerfile：构建“编译器工单”

不要使用过于臃肿的官方镜像，建议基于 debian:slim 或 ubuntu:20.04 构建。

# Dockerfile.build
FROM ubuntu:20.04

# 避免交互式弹窗
ENV DEBIAN_FRONTEND=noninteractive

# 安装基础构建工具及交叉编译器
RUN apt-get update && apt-get install -y \
    build-essential \
    crossbuild-essential-armhf \
    bc \
    bison \
    flex \
    libssl-dev \
    make \
    vim \
    && rm -rf /var/lib/apt/lists/*

# 设置工作目录
WORKDIR /build

# 默认进入 bash
CMD ["/bin/bash"]

2. 优化 Makefile：支持外部参数传递

为了让驱动既能在本地编译，也能在 Docker 容器内编译，我们需要对 Makefile 进行参数化处理。

# 驱动模块名
MODULE_NAME := hello_driver
obj-m := $(MODULE_NAME).o

# 外部传入的变量，设置默认值
ARCH ?= arm
CROSS_COMPILE ?= arm-linux-gnueabihf-
KDIR ?= /lib/modules/$(shell uname -r)/build
PWD := $(shell pwd)

all:
    $(MAKE) -C $(KDIR) M=$(PWD) ARCH=$(ARCH) CROSS_COMPILE=$(CROSS_COMPILE) modules

clean:
    $(MAKE) -C $(KDIR) M=$(PWD) clean

3. 编写 CI 脚本（以 GitLab CI 为例）

这是实现自动化的关键。我们需要在 CI 流程中挂载当前源码到容器内，并执行编译。

stages:
  - build

driver_build:
  stage: build
  image: registry.example.com/embedded-build-env:v1.0
  variables:
    # 指向容器内预先下载好的内核源码目录
    KDIR: "/opt/kernel-headers-4.19"
  script:
    - make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- KDIR=$KDIR
  artifacts:
    paths:
      - "*.ko"
    expire_in: 1 week

三、 避坑指南与进阶技巧

1. 内核头文件的处理

驱动编译依赖特定的内核头文件。在 CI 镜像中，你可以预先下载好对应开发板的内核源码或 linux-headers。如果支持多个硬件平台，可以通过 Docker 环境变量来切换不同的 KDIR。

2. UID/GID 权限问题

在 Docker 内编译生成的 .ko 文件，默认属主可能是 root。这会导致本地开发者在宿主机上无法删除这些文件。建议在执行 make 时传入宿主机的 UID，或者在 CI 脚本末尾执行 chown 操作。

3. 使用 ccache 加速

对于频繁构建的流水线，可以在 Docker 中挂载一个持久化目录作为 ccache 缓存空间。即使是交叉编译，ccache 也能显著缩短多次构建之间的时间消耗。

四、 总结

通过 Docker + Makefile 的组合，我们实现了：

  1. 环境隔离：不再需要在物理机上安装乱七八糟的工具链。
  2. 极速复现：新成员加入，只需 docker pull 即可开始开发。
  3. 高度自动化：代码推送到 Git 仓库，自动触发编译，开发者只需下载生成的驱动包进行上板测试。

这套方案不仅适用于内核驱动，对于 U-Boot、嵌入式应用（C/C++）甚至是一些复杂的交叉编译固件，都有着极高的普适性。在“软件定义硬件”的今天，底层开发者同样需要享受基础设施自动化带来的红利。

嵌入式老兵 嵌入式开发DockerCICD

评论点评