文档索引

本仓库只做一件事:构建十个 Golang 构建环境镜像。三套流水线(CNB / GitHub Actions / GitLab CI)各自发布到自己的制品库,镜像内容与标签规则保持一致。

镜像 地址示例(GitHub / GitLab) 说明
Golang 构建环境 ghcr.io/dtapps/golang / registry.gitlab.com/dtapps/golang Go + UPX + nfpm + Node + Go 工具
Golang 构建环境 + fnpack ghcr.io/dtapps/golang/fnpack / registry.gitlab.com/dtapps/golang/fnpack 上面的镜像 + fnpack
Golang 构建环境 + wails3 ghcr.io/dtapps/golang/wails3 / registry.gitlab.com/dtapps/golang/wails3 上面的镜像 + GTK4/WebKitGTK + wails3 CLI
Golang 构建环境 + wails2 ghcr.io/dtapps/golang/wails2 / registry.gitlab.com/dtapps/golang/wails2 上面的镜像 + GTK3/WebKit2GTK 4.1 + wails CLI
Golang 构建环境 + fyne ghcr.io/dtapps/golang/fyne / registry.gitlab.com/dtapps/golang/fyne 上面的镜像 + OpenGL/X11/Wayland + fyne CLI
Golang 构建环境 + mygo ghcr.io/dtapps/golang/mygo / registry.gitlab.com/dtapps/golang/mygo 上面的镜像 + GTK3/WebKitGTK 4.1 + 无头运行库 + mygo CLI + bun
Golang 构建环境 + gio ghcr.io/dtapps/golang/gio / registry.gitlab.com/dtapps/golang/gio 上面的镜像 + EGL/GLES + X11 + Wayland + Vulkan + 无头运行库 + gogio CLI
Golang 构建环境 + nsgo ghcr.io/dtapps/golang/nsgo / registry.gitlab.com/dtapps/golang/nsgo 上面的镜像 + GTK4/WebKitGTK 6.0/GStreamer + 无头运行库 + nsgo CLI
Golang 构建环境 + viva ghcr.io/dtapps/golang/viva / registry.gitlab.com/dtapps/golang/viva 上面的镜像 + XCB/Vulkan + GTK3/WebKit2GTK 4.1 + 无头运行库 + viva CLI
Golang 构建环境 + asuka ghcr.io/dtapps/golang/asuka / registry.gitlab.com/dtapps/golang/asuka 上面的镜像 + GTK4/libadwaita + 无头运行库 + asuka CLI

先看哪一篇

你要做的事 看这里
拉镜像、在项目里用 golang/getting-started.md
给 FnOS 打 .fpk 包 fnpack/getting-started.md
在容器里编译 Wails v3 应用 wails3/README.md
在容器里编译 Wails v2 应用 wails2/README.md
在容器里编译 Fyne 应用 fyne/README.md
在容器里编译 MyGo 应用 mygo/README.md
在容器里编译 Gio 应用 gio/README.md
在容器里编译 nsgo 应用 nsgo/README.md
在容器里编译 viva 应用 viva/README.md
在容器里编译 asuka 应用 asuka/README.md
本地构建、手动触发 CI golang/build.md
看镜像里装了什么、为什么这么分层 golang/dockerfile.md
看 fnpack 是怎么装进镜像的 fnpack/dockerfile.md
看 wails3 版本策略(latest 解析) wails3/README.md
看 wails2 版本策略与 build tag wails2/README.md、构建 v2 应用时的 build tag
看 fyne 版本策略与元数据 fyne/README.md
看 mygo 版本策略与元数据 mygo/README.md
看 gio 版本策略与元数据 gio/README.md
看 nsgo 版本策略与元数据 nsgo/README.md
看 viva 版本策略与元数据 viva/README.md
看 asuka 版本策略与元数据 asuka/README.md
查标签、digest、各镜像的对应关系 golang/images-and-tags.md
改 CI 事件、按钮、冒烟断言 golang/ci-pipeline.md
国内/海外镜像源与下载地址 golang/mirrors.md
升级 Go、工具、fnpack 版本 golang/maintenance.md
构建失败排查 golang/troubleshooting.md
构建缓存是怎么实现的 cache-implementation.md
查徽章、元数据键、unknown 排查 fnpack/metadata-and-badges.md、wails3/README.md、fyne/README.md、mygo/README.md、gio/README.md、nsgo/README.md、viva/README.md、asuka/README.md
CNB 平台层(变量、地址、元数据) cnb.md
GitHub Actions / GHCR 平台层 github.md
GitLab CI / Registry 平台层 gitlab.md

各镜像的 CLI 工具清单

按功能分类拆成三份 CSV,列定义与 ci-mirror-dependency.csv 一致(工具名 / 功能分类 / 具体作用 / 适用镜像):

文件 内容
cli-per-image.csv 十个镜像各自独有的 CLI:fnpack / fyne / gogio / mygo / bun / nsgo / viva / asuka / wails / wails3,以及对应版本变量
cli-go-toolchain.csv 基座安装的 Go 工具链 CLI(sqlc / ent / golangci-lint / gotestsum 等),全部镜像继承
cli-runtime-packaging.csv Go / Node 运行时与打包分发 CLI(upx / nfpm / wixl / lintian / rpm 等),全部镜像继承

九个变体镜像都是在 Golang 基础镜像之上 FROM 出来的,所以后两份表里的工具在全部十个镜像里都有;第一份表里的 CLI 只在对应镜像存在,互不混装。系统包(apt)清单见 ci-mirror-dependency.csv。

事实来源

  • 镜像内容:.cnb/docker/Dockerfile.golang、.cnb/docker/Dockerfile.fnpack、.cnb/docker/Dockerfile.wails3、.cnb/docker/Dockerfile.wails2、.cnb/docker/Dockerfile.fyne、.cnb/docker/Dockerfile.mygo、.cnb/docker/Dockerfile.gio、.cnb/docker/Dockerfile.nsgo、.cnb/docker/Dockerfile.viva、.cnb/docker/Dockerfile.asuka(GitHub 侧同名文件在 .github/docker/,GitLab 侧在 .gitlab/docker/)。
  • 标签与发布顺序:每个平台十个脚本,build-golang.sh 先发基座,build-fnpack.sh / build-wails3.sh / build-wails2.sh / build-fyne.sh / build-mygo.sh / build-gio.sh / build-nsgo.sh / build-viva.sh / build-asuka.sh 等基座镜像就绪后再各自构建。
    • CNB:.cnb/scripts/build-golang.sh、.cnb/scripts/build-fnpack.sh、.cnb/scripts/build-wails3.sh、.cnb/scripts/build-wails2.sh、.cnb/scripts/build-fyne.sh、.cnb/scripts/build-mygo.sh、.cnb/scripts/build-gio.sh、.cnb/scripts/build-nsgo.sh、.cnb/scripts/build-viva.sh、.cnb/scripts/build-asuka.sh
    • GitHub:.github/scripts/build-golang.sh、.github/scripts/build-fnpack.sh、.github/scripts/build-wails3.sh、.github/scripts/build-wails2.sh、.github/scripts/build-fyne.sh、.github/scripts/build-mygo.sh、.github/scripts/build-gio.sh、.github/scripts/build-nsgo.sh、.github/scripts/build-viva.sh、.github/scripts/build-asuka.sh
    • GitLab:.gitlab/scripts/build-golang.sh、.gitlab/scripts/build-fnpack.sh、.gitlab/scripts/build-wails3.sh、.gitlab/scripts/build-wails2.sh、.gitlab/scripts/build-fyne.sh、.gitlab/scripts/build-mygo.sh、.gitlab/scripts/build-gio.sh、.gitlab/scripts/build-nsgo.sh、.gitlab/scripts/build-viva.sh、.gitlab/scripts/build-asuka.sh
  • 触发器:每个平台按镜像拆成十个 workflow。
    • CNB:.cnb.yml(仅 include;cron 在各 workflow 内)、.cnb/workflows/build-{golang,fnpack,wails3,wails2,fyne,mygo,gio,nsgo,viva,asuka}.yml、.cnb/web_trigger.yml
    • GitHub:.github/workflows/build-{golang,fnpack,wails3,wails2,fyne,mygo,gio,nsgo,viva,asuka}.yml(各自定时触发)
    • GitLab:.gitlab-ci.yml(全局配置、schedules)+ .gitlab/workflows/build-{golang,fnpack,wails3,wails2,fyne,mygo,gio,nsgo,viva,asuka}.yml
  • 文档与脚本冲突时,以脚本和 Dockerfile 为准,并回头修文档。