mediadepot/flatcar-developer

Flatcar Container Linux 开发容器

镜像概述和主要用途

Flatcar Container Linux 开发容器是基于 Flatcar Container Linux 开发镜像构建的 Docker 容器，源代码仓库为 https://github.com/mediadepot/docker-flatcar-developer%E3%80%82%E8%AF%A5%E5%AE%B9%E5%99%A8%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E4%B8%80%E4%B8%AA%E5%AE%8C%E6%95%B4%E7%9A%84 Linux 开发环境，包含全套编译器工具链，支持开发者修改、扩展或构建 Flatcar Linux 生产镜像中未包含的自定义二进制文件、驱动程序或库文件。通过 Docker 容器化封装，可利用熟悉的 Docker 工作流（如多阶段构建），在避免构建链冗余的同时，实现高效开发。

核心功能和特性

完整的开发环境

• 包含完整的 Linux 系统及编译器工具链，满足 Flatcar Linux 自定义组件的开发、编译需求。

内核源码支持

• 提供 "sources" 版本镜像，在基础开发环境上扩展内核源码（存储于 /usr/src/linux 目录），确保开发者可基于与 Flatcar 内核版本匹配的源码构建内核模块和驱动程序。

自动化构建机制

• 通过 GitHub Actions 每日 Cron 任务触发构建，支持 alpha、beta、stable 三个 Flatcar 发布渠道的镜像版本。
• 构建流程先拉取各渠道当前版本，检查 Docker Hub 上是否已存在对应镜像，仅在不存在时执行重建，避免重复构建和冗余 CI 任务。
• 遵循 Flatcar 版本渠道晋升机制，通常仅新增 alpha 版本，从 Flatcar 版本发布到 Docker 镜像可用的延迟较低。

使用场景和适用范围

适用人群

• 需要为 Flatcar Linux 开发自定义二进制文件、驱动程序、库文件的开发者。
• 需构建与 Flatcar 内核版本匹配的内核模块的开发者。

典型场景

• 作为独立开发环境，用于调试和编译 Flatcar 相关组件。
• 结合 Docker 多阶段构建，在该镜像中完成编译后，将产物复制到精简的生产镜像，减少最终镜像体积。

使用方法和配置说明

Docker 镜像获取

该镜像托管于 Docker Hub，地址为 https://hub.docker.com/r/mediadepot/flatcar-developer/%E3%80%82

拉取镜像

可通过标签指定具体版本或发布渠道，示例如下：

bash
# 拉取指定版本（如 1576.5.0）
docker pull docker.xuanyuan.run/mediadepot/flatcar-developer:1576.5.0

# 拉取 alpha 渠道最新版本（标签格式为 `<渠道>-latest`）
docker pull docker.xuanyuan.run/mediadepot/flatcar-developer:alpha-latest

# 拉取 stable 渠道最新版本
docker pull docker.xuanyuan.run/mediadepot/flatcar-developer:stable-latest

容器运行示例

交互式运行容器

通过以下命令启动交互式容器，验证开发环境及内核源码：

bash
# 运行基础开发环境容器
docker run -it --rm docker.xuanyuan.run/mediadepot/flatcar-developer:stable-latest /bin/bash

# 运行包含内核源码的 "sources" 版本容器（需确认标签是否包含 "sources" 标识）
# 示例：若 sources 版本标签为 "stable-sources-latest"
docker run -it --rm docker.xuanyuan.run/mediadepot/flatcar-developer:stable-sources-latest /bin/bash

# 在容器内查看内核源码
cd /usr/src/linux && ls -l

多阶段构建示例

以下为使用该镜像构建 Flatcar 内核模块的多阶段构建 Dockerfile 示例：

dockerfile
# 阶段 1：使用 sources 版本镜像编译内核模块
FROM docker.xuanyuan.run/mediadepot/flatcar-developer:stable-sources-latest AS builder

WORKDIR /module
COPY ./module-src /module  # 复制内核模块源码

# 编译模块（假设源码包含 Makefile，指定内核源码路径）
RUN make -C /usr/src/linux M=$(pwd) modules

# 阶段 2：构建生产镜像（使用 Flatcar 生产镜像）
FROM docker.xuanyuan.run/flatcar-linux:stable

# 从构建阶段复制编译好的内核模块
COPY --from=builder /module/*.ko /lib/modules/$(uname -r)/kernel/drivers/

# 加载模块（按需调整）
RUN depmod -a

参考资料

• 源仓库：https://github.com/mediadepot/docker-flatcar-developer
• Docker Hub 镜像：https://hub.docker.com/r/mediadepot/flatcar-developer/
• 相关项目参考：https://github.com/BugRoger/coreos-developer-docker