Kilo 项目 CI 容器镜像体系解析用预构建镜像加速 GitHub Actions 作业【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode本文以 Kilo 开源仓库GitHub_Trending/ki/kilocode中 packages/containers/README.md 为骨架系统讲解其 CI 容器镜像的设计思路通过把大型、安装缓慢的依赖Node.js、Bun、Java、Gradle、Rust 工具链、Tauri 构建依赖等预先烘焙进镜像显著缩短 GitHub Actions 中 Linux 作业的执行时间。读完本文你将掌握这套镜像的分层结构、每个镜像的职责与构建细节、多架构发布流程以及如何在 workflow 的job.container中直接使用它们。一、为什么需要预构建 CI 镜像在典型的 CI 流水线中npm install、Gradle 依赖解析、Rust 工具链安装、Java 环境配置等步骤动辄消耗数分钟甚至更久且每次作业运行都会重复付出这些成本。Kilo 的解决方案非常直接把大而慢的依赖提前放进镜像CI 作业启动时直接继承省去逐次安装的等待。这一策略的前提在 packages/containers/README.md 中写得很清楚这些镜像是为Linux 作业设计的并且要求 workflow 使用job.container来运行。由于镜像只针对 Linux 平台macOS 与 Windows 的 GitHub Actions 作业无法在其内部运行。二、镜像目录六层递进的镜像家族整个packages/containers目录包含 6 个镜像每个镜像一个子目录各自存放独立的 Dockerfile镜像基础额外内容定位baseubuntu:24.04通用构建工具与实用程序一切的基础层bun-nodebaseBun 与 Node.js 24前端/JS 工具链作业jetbrainsbun-nodeJava 21、JBR 字体库、预缓存的 Gradle 与 Bun 包JetBrains 插件构建与测试rustbun-nodeRuststableminimal profileRust 项目构建tauri-linuxrustTauri Linux 构建依赖Tauri 桌面应用 Linux 打包publishbun-nodeDocker CLI 与 AUR 工具镜像/制品发布作业从层级关系看这是一个典型的洋葱式继承结构base提供最底层能力bun-node在其上叠加 JS 工具链而后三个镜像再从bun-node而非base继续扩展说明仓库内多数 CI 作业都默认依赖 Bun/Node.js 环境。1. baseUbuntu 24.04 通用基础镜像base/Dockerfile 基于ubuntu:24.04设置了DEBIAN_FRONTENDnoninteractive以避免 apt 交互式提示并安装了以下软件包编译工具build-essential、pkg-config网络与安全curl、ca-certificates、openssh-client数据处理jq、python3归档压缩unzip、zip、xz-utils版本控制git安装结束后执行rm -rf /var/lib/apt/lists/*清理 apt 缓存这是压缩镜像体积的常规做法。2. bun-nodeBun Node.js 24 双运行时bun-node/Dockerfile 以base为基础通过REGISTRY参数引用详见下文默认版本参数为NODE_VERSION24.4.0、BUN_VERSION1.3.14并做了两个关键设置BUN_INSTALL/opt/bunPATH中优先查找/opt/bun/bin根据uname -m判断架构aarch64对应 Node.js 的arm64发行包其余为x64从而支持多架构下载Node.js 通过官方 tarball 直接解压到/usr/local--strip-components1随后启用corepack以便使用pnpm、yarn等包管理器。Bun 的安装脚本则加入了最多 5 次的重试循环——考虑到 Bun 安装脚本内部还会二次下载正式发行版网络抖动时重试能显著提高构建成功率每次失败后按attempt * 5秒递增等待。构建末尾输出bun --version、node --version、npm --version三个版本号验证工具链就绪。3. jetbrainsJava 21 预缓存 Gradle 与 Bun 依赖jetbrains/Dockerfile 是 6 个镜像中最厚的一个采用多阶段构建核心目标是让 JetBrains 插件相关的 CI 作业完全跳过依赖下载Java 21 与 JBR 字体栈安装openjdk-21-jdk-headless以及fonts-dejavu-core、libfontconfig1、libfreetype6——后者是 JBRJetBrains Runtime无头测试所必需的字体库。随后通过readlink -f $(which java)解析出真实 Java 主目录并创建/usr/lib/jvm/java-21符号链接兼容 amd64 与 arm64 两个架构JAVA_HOME指向该路径。Gradle 预下载GRADLE_VERSION9.4.1GRADLE_USER_HOME/gradle-home被设置为任何用户包括 GitHub Actions runner 的普通用户都可读的位置。脚本用 Node 计算 Gradle 发行版 URL 的 MD5 并转成 36 进制字符串拼出 Gradle Wrapper 的缓存目录gradle-${GRADLE_VERSION}-bin/hash把发行版 zip 解压进去并写入.ok标记文件。这样作业中 Gradle Wrapper 启动时会直接命中缓存不再发起网络下载。最后执行gradle --version验证缓存可用。Bun 依赖缓存第二个构建阶段bun-cache把仓库根目录的package.json、bun.lock、bunfig.toml、packages与patches复制进镜像执行bun install --frozen-lockfile --ignore-scripts --cache-dir/bun-cache最终阶段将/bun-cache复制到/opt/bun/install/cache/并设置BUN_INSTALL_CACHE_DIR。这意味着 CI 中执行bun install时绝大部分依赖直接命中本地缓存。4. rustRust stable minimal 工具链rust/Dockerfile 基于bun-node通过官方rustup安装脚本安装 RustRUST_TOOLCHAINstable可通过--build-arg覆盖--profile minimal只安装rustc、cargo、rust-std等最小组件避免 rustfmt/clippy 等额外组件占用空间CARGO_HOME/opt/cargo、RUSTUP_HOME/opt/rustup/opt/cargo/bin加入PATH安装后输出rustc --version、cargo --version验证5. tauri-linuxTauri Linux 打包依赖tauri-linux/Dockerfile 基于rust安装 Tauri v2 在 Linux 上构建所需的系统库libwebkit2gtk-4.1-devWebKitGTK 开发头文件Tauri 渲染核心libappindicator3-dev系统托盘支持librsvg2-devSVG 渲染patchelf修改 ELF 可执行文件Tauri 打包流程依赖6. publishDocker CLI AUR 工具publish/Dockerfile 同样基于bun-node仅安装两个包docker.io供 CI 作业在容器内构建并推送镜像如发布本文所述的这套镜像自身pacman-package-managerArch Linux 包管理器用于构建/发布 AURArch User Repository软件包三、构建与发布build.ts 脚本全解析所有镜像的构建由统一脚本 packages/containers/script/build.ts 驱动用 Bun 执行仓库根目录package.json的packageManager字段必须以bun开头脚本会解析出 Bun 版本并作为BUN_VERSION构建参数。其关键行为如下# 本地构建仅当前架构 REGISTRYghcr.io/kilo-org TAG24.04 bun ./packages/containers/script/build.ts # 构建并推送多架构镜像amd64 arm64 REGISTRYghcr.io/kilo-org TAG24.04 bun ./packages/containers/script/build.ts --push参数与环境变量输入默认值作用REGISTRY环境变量ghcr.io/kilo-org镜像仓库前缀TAG环境变量24.04镜像标签对应 Ubuntu 版本号--push参数或PUSH1不推送触发 Buildx 多架构构建并推送packageManager字段必须存在解析 Bun 版本覆盖默认BUN_VERSION构建流程要点Buildx 准备仅--push时脚本先执行docker buildx ls检查是否存在名为kilo的 builder存在则use否则docker buildx create --name kilo --use创建。多架构目标推送模式下固定使用--platform linux/amd64,linux/arm64一次构建同时产出两种 CPU 架构的镜像清单。差异化的构建参数base无额外参数直接docker buildx build --platform ... --pushbun-node额外传入--build-arg REGISTRY${reg} --build-arg BUN_VERSION${bun}其余四个镜像传入--build-arg REGISTRY${reg}它们内部的FROM ${REGISTRY}/build/xxx:24.04依赖该参数引用上游镜像本地构建无--push时降级为普通docker build仅构建当前架构便于本地快速验证。每个 Dockerfile 开头都能看到# kilocode_change start/end标记这是仓库基于上游 opencode 同步代码时保留的本地改动区域例如默认REGISTRY的引入。四、在 GitHub Actions 中使用根据 packages/containers/README.md 的用法示例只需在 workflow 的 job 中声明container即可jobs: build-cli: runs-on: ubuntu-latest container: image: ghcr.io/kilo-org/build/bun-node:24.04关键要点runs-on: ubuntu-latest保持不变container.image指定镜像名称REGISTRY/build/镜像名:TAG的命名规范注意中间固定带build段。作业内可以直接使用镜像预装的node、bun、git、jq等工具bun install命中预缓存后通常只需数秒。构建 Rust 相关作业选择ghcr.io/kilo-org/build/rust:24.04Tauri 打包选择tauri-linuxJetBrains 插件构建选择jetbrains其 Gradle 与 Bun 缓存可直接命中发布作业选择publish。注意事项与限制仅对 Linux 作业有效macOS 与 Windows 的 Actions runner 无法运行 Linux 容器container声明会被忽略。Buildx 的 Docker 访问问题如果作业内部需要调用 Docker Buildx例如用publish镜像推送镜像容器内默认没有 Docker daemon必须让容器访问宿主机的 Docker daemon或采用docker-in-docker 并以 privileged 模式运行。这一点在 packages/containers/README.md 的 Notes 中明确强调。镜像体积权衡预构建意味着镜像较大jetbrains尤为突出换取的是 CI 作业启动后的即时可用性这是构建一次、处处复用的典型取舍。版本跟随仓库Node.js 24.4.0、Bun 1.3.14、Gradle 9.4.1 等版本以 Dockerfile 中ARG默认值或构建脚本解析值为准如需升级需同步更新对应 Dockerfile 与根目录package.json的packageManager字段后重新构建镜像。五、小结Kilo 的 CI 容器方案是一个结构清晰、可复制的工程实践base提供系统级底座bun-node统一 JS 工具链rust/tauri-linux/jetbrains/publish面向不同作业类型做专项叠加配合 build.ts 实现一个命令构建六个镜像、一条命令发布双架构的自动化流程。对于任何饱受 CI 依赖安装耗时困扰的项目这套依赖预烘焙 Buildx 多架构 job.container直接引用的组合都值得直接借鉴——需要构建整套镜像时可参考 packages/containers/README.md 中的命令需要微调某个镜像内容时直接修改对应子目录下的 Dockerfile 并重新执行构建即可。【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Kilo 项目 CI 容器镜像体系解析：用预构建镜像加速 GitHub Actions 作业
Kilo 项目 CI 容器镜像体系解析用预构建镜像加速 GitHub Actions 作业【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode本文以 Kilo 开源仓库GitHub_Trending/ki/kilocode中 packages/containers/README.md 为骨架系统讲解其 CI 容器镜像的设计思路通过把大型、安装缓慢的依赖Node.js、Bun、Java、Gradle、Rust 工具链、Tauri 构建依赖等预先烘焙进镜像显著缩短 GitHub Actions 中 Linux 作业的执行时间。读完本文你将掌握这套镜像的分层结构、每个镜像的职责与构建细节、多架构发布流程以及如何在 workflow 的job.container中直接使用它们。一、为什么需要预构建 CI 镜像在典型的 CI 流水线中npm install、Gradle 依赖解析、Rust 工具链安装、Java 环境配置等步骤动辄消耗数分钟甚至更久且每次作业运行都会重复付出这些成本。Kilo 的解决方案非常直接把大而慢的依赖提前放进镜像CI 作业启动时直接继承省去逐次安装的等待。这一策略的前提在 packages/containers/README.md 中写得很清楚这些镜像是为Linux 作业设计的并且要求 workflow 使用job.container来运行。由于镜像只针对 Linux 平台macOS 与 Windows 的 GitHub Actions 作业无法在其内部运行。二、镜像目录六层递进的镜像家族整个packages/containers目录包含 6 个镜像每个镜像一个子目录各自存放独立的 Dockerfile镜像基础额外内容定位baseubuntu:24.04通用构建工具与实用程序一切的基础层bun-nodebaseBun 与 Node.js 24前端/JS 工具链作业jetbrainsbun-nodeJava 21、JBR 字体库、预缓存的 Gradle 与 Bun 包JetBrains 插件构建与测试rustbun-nodeRuststableminimal profileRust 项目构建tauri-linuxrustTauri Linux 构建依赖Tauri 桌面应用 Linux 打包publishbun-nodeDocker CLI 与 AUR 工具镜像/制品发布作业从层级关系看这是一个典型的洋葱式继承结构base提供最底层能力bun-node在其上叠加 JS 工具链而后三个镜像再从bun-node而非base继续扩展说明仓库内多数 CI 作业都默认依赖 Bun/Node.js 环境。1. baseUbuntu 24.04 通用基础镜像base/Dockerfile 基于ubuntu:24.04设置了DEBIAN_FRONTENDnoninteractive以避免 apt 交互式提示并安装了以下软件包编译工具build-essential、pkg-config网络与安全curl、ca-certificates、openssh-client数据处理jq、python3归档压缩unzip、zip、xz-utils版本控制git安装结束后执行rm -rf /var/lib/apt/lists/*清理 apt 缓存这是压缩镜像体积的常规做法。2. bun-nodeBun Node.js 24 双运行时bun-node/Dockerfile 以base为基础通过REGISTRY参数引用详见下文默认版本参数为NODE_VERSION24.4.0、BUN_VERSION1.3.14并做了两个关键设置BUN_INSTALL/opt/bunPATH中优先查找/opt/bun/bin根据uname -m判断架构aarch64对应 Node.js 的arm64发行包其余为x64从而支持多架构下载Node.js 通过官方 tarball 直接解压到/usr/local--strip-components1随后启用corepack以便使用pnpm、yarn等包管理器。Bun 的安装脚本则加入了最多 5 次的重试循环——考虑到 Bun 安装脚本内部还会二次下载正式发行版网络抖动时重试能显著提高构建成功率每次失败后按attempt * 5秒递增等待。构建末尾输出bun --version、node --version、npm --version三个版本号验证工具链就绪。3. jetbrainsJava 21 预缓存 Gradle 与 Bun 依赖jetbrains/Dockerfile 是 6 个镜像中最厚的一个采用多阶段构建核心目标是让 JetBrains 插件相关的 CI 作业完全跳过依赖下载Java 21 与 JBR 字体栈安装openjdk-21-jdk-headless以及fonts-dejavu-core、libfontconfig1、libfreetype6——后者是 JBRJetBrains Runtime无头测试所必需的字体库。随后通过readlink -f $(which java)解析出真实 Java 主目录并创建/usr/lib/jvm/java-21符号链接兼容 amd64 与 arm64 两个架构JAVA_HOME指向该路径。Gradle 预下载GRADLE_VERSION9.4.1GRADLE_USER_HOME/gradle-home被设置为任何用户包括 GitHub Actions runner 的普通用户都可读的位置。脚本用 Node 计算 Gradle 发行版 URL 的 MD5 并转成 36 进制字符串拼出 Gradle Wrapper 的缓存目录gradle-${GRADLE_VERSION}-bin/hash把发行版 zip 解压进去并写入.ok标记文件。这样作业中 Gradle Wrapper 启动时会直接命中缓存不再发起网络下载。最后执行gradle --version验证缓存可用。Bun 依赖缓存第二个构建阶段bun-cache把仓库根目录的package.json、bun.lock、bunfig.toml、packages与patches复制进镜像执行bun install --frozen-lockfile --ignore-scripts --cache-dir/bun-cache最终阶段将/bun-cache复制到/opt/bun/install/cache/并设置BUN_INSTALL_CACHE_DIR。这意味着 CI 中执行bun install时绝大部分依赖直接命中本地缓存。4. rustRust stable minimal 工具链rust/Dockerfile 基于bun-node通过官方rustup安装脚本安装 RustRUST_TOOLCHAINstable可通过--build-arg覆盖--profile minimal只安装rustc、cargo、rust-std等最小组件避免 rustfmt/clippy 等额外组件占用空间CARGO_HOME/opt/cargo、RUSTUP_HOME/opt/rustup/opt/cargo/bin加入PATH安装后输出rustc --version、cargo --version验证5. tauri-linuxTauri Linux 打包依赖tauri-linux/Dockerfile 基于rust安装 Tauri v2 在 Linux 上构建所需的系统库libwebkit2gtk-4.1-devWebKitGTK 开发头文件Tauri 渲染核心libappindicator3-dev系统托盘支持librsvg2-devSVG 渲染patchelf修改 ELF 可执行文件Tauri 打包流程依赖6. publishDocker CLI AUR 工具publish/Dockerfile 同样基于bun-node仅安装两个包docker.io供 CI 作业在容器内构建并推送镜像如发布本文所述的这套镜像自身pacman-package-managerArch Linux 包管理器用于构建/发布 AURArch User Repository软件包三、构建与发布build.ts 脚本全解析所有镜像的构建由统一脚本 packages/containers/script/build.ts 驱动用 Bun 执行仓库根目录package.json的packageManager字段必须以bun开头脚本会解析出 Bun 版本并作为BUN_VERSION构建参数。其关键行为如下# 本地构建仅当前架构 REGISTRYghcr.io/kilo-org TAG24.04 bun ./packages/containers/script/build.ts # 构建并推送多架构镜像amd64 arm64 REGISTRYghcr.io/kilo-org TAG24.04 bun ./packages/containers/script/build.ts --push参数与环境变量输入默认值作用REGISTRY环境变量ghcr.io/kilo-org镜像仓库前缀TAG环境变量24.04镜像标签对应 Ubuntu 版本号--push参数或PUSH1不推送触发 Buildx 多架构构建并推送packageManager字段必须存在解析 Bun 版本覆盖默认BUN_VERSION构建流程要点Buildx 准备仅--push时脚本先执行docker buildx ls检查是否存在名为kilo的 builder存在则use否则docker buildx create --name kilo --use创建。多架构目标推送模式下固定使用--platform linux/amd64,linux/arm64一次构建同时产出两种 CPU 架构的镜像清单。差异化的构建参数base无额外参数直接docker buildx build --platform ... --pushbun-node额外传入--build-arg REGISTRY${reg} --build-arg BUN_VERSION${bun}其余四个镜像传入--build-arg REGISTRY${reg}它们内部的FROM ${REGISTRY}/build/xxx:24.04依赖该参数引用上游镜像本地构建无--push时降级为普通docker build仅构建当前架构便于本地快速验证。每个 Dockerfile 开头都能看到# kilocode_change start/end标记这是仓库基于上游 opencode 同步代码时保留的本地改动区域例如默认REGISTRY的引入。四、在 GitHub Actions 中使用根据 packages/containers/README.md 的用法示例只需在 workflow 的 job 中声明container即可jobs: build-cli: runs-on: ubuntu-latest container: image: ghcr.io/kilo-org/build/bun-node:24.04关键要点runs-on: ubuntu-latest保持不变container.image指定镜像名称REGISTRY/build/镜像名:TAG的命名规范注意中间固定带build段。作业内可以直接使用镜像预装的node、bun、git、jq等工具bun install命中预缓存后通常只需数秒。构建 Rust 相关作业选择ghcr.io/kilo-org/build/rust:24.04Tauri 打包选择tauri-linuxJetBrains 插件构建选择jetbrains其 Gradle 与 Bun 缓存可直接命中发布作业选择publish。注意事项与限制仅对 Linux 作业有效macOS 与 Windows 的 Actions runner 无法运行 Linux 容器container声明会被忽略。Buildx 的 Docker 访问问题如果作业内部需要调用 Docker Buildx例如用publish镜像推送镜像容器内默认没有 Docker daemon必须让容器访问宿主机的 Docker daemon或采用docker-in-docker 并以 privileged 模式运行。这一点在 packages/containers/README.md 的 Notes 中明确强调。镜像体积权衡预构建意味着镜像较大jetbrains尤为突出换取的是 CI 作业启动后的即时可用性这是构建一次、处处复用的典型取舍。版本跟随仓库Node.js 24.4.0、Bun 1.3.14、Gradle 9.4.1 等版本以 Dockerfile 中ARG默认值或构建脚本解析值为准如需升级需同步更新对应 Dockerfile 与根目录package.json的packageManager字段后重新构建镜像。五、小结Kilo 的 CI 容器方案是一个结构清晰、可复制的工程实践base提供系统级底座bun-node统一 JS 工具链rust/tauri-linux/jetbrains/publish面向不同作业类型做专项叠加配合 build.ts 实现一个命令构建六个镜像、一条命令发布双架构的自动化流程。对于任何饱受 CI 依赖安装耗时困扰的项目这套依赖预烘焙 Buildx 多架构 job.container直接引用的组合都值得直接借鉴——需要构建整套镜像时可参考 packages/containers/README.md 中的命令需要微调某个镜像内容时直接修改对应子目录下的 Dockerfile 并重新执行构建即可。【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考