Godot CI 入门:容器化导出与发布
从配置 Docker 导出环境开始,依次接入 GitLab CI 或 GitHub Actions,将游戏自动发布到 Pages 或 Itch.io。
- 1
准备项目与发布凭据
在本地创建 Godot 项目并确认可正常运行;进入 GitHub 或 GitLab 仓库的 Settings、Secrets,添加 Itch.io API Key 等发布凭据。
- 2
配置容器导出参数
依据仓库文档编写 Docker 导出配置,指定 Godot 版本、导出预设、项目目录和产物路径;先用本地命令验证镜像能够生成游戏。
- 3
接入 GitHub Actions
在仓库 Actions 页面新建工作流,复制 godot-ci 的 GitHub Actions 模板,填写导出配置与 Secrets 名称,并确认构建产物上传步骤。
- 4
或接入 GitLab CI
打开 GitLab 项目的 CI/CD 页面,复制仓库提供的 GitLab CI 模板并加入 .gitlab-ci.yml,在 Variables 中配置同名凭据后提交。
- 5
运行并检查导出产物
提交配置文件触发流水线,在 Actions 的运行记录或 GitLab CI 页面查看日志,确认导出成功、压缩包生成且下载产物与预期一致。
- 6
启用自动部署
按目标启用 GitHub Pages、GitLab Pages 或 Itch.io 模板,填写站点路径与上传信息;重新运行流水线,检查公开地址或游戏页面。
💡 实用技巧
- 固定 Godot 镜像版本,避免升级后导出失败
- 先手动导出一次,再接入自动流水线
- 密钥只放在 Secrets 或 Variables 中
- 为 Pages 配置正确的站点基础路径
⚠️ 常见坑
- 导出预设名称与配置文件不一致会失败
- 首次触发流水线前必须提交模板文件
常见问题
Q:Docker 导出配置应该放在哪里?
将导出配置与项目一起提交到仓库,并固定 Godot 镜像版本;配置中明确指定导出预设、项目目录和产物路径。先在本地运行镜像命令,确认能够生成游戏文件后再接入流水线。
Q:GitHub 和 GitLab 的发布密钥怎么配置?
GitHub 在仓库 Settings、Secrets 中添加 Itch.io API Key 等凭据,工作流中填写对应的 Secrets 名称;GitLab 则在项目的 CI/CD、Variables 中配置同名变量,并提交包含 .gitlab-ci.yml 的模板。
Q:流水线没有生成游戏文件怎么排查?
先核对 Docker 导出配置中的导出预设名称是否与项目实际预设一致,再检查项目目录和产物路径是否正确。随后查看 Actions 或 GitLab CI 日志,确认模板文件已随首次触发流水线的提交一并提交。