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），僅供參考