发行与平台AI 撰写更新于 2026-10-25

Godot CI 入门:容器化导出与发布

从配置 Docker 导出环境开始,依次接入 GitLab CI 或 GitHub Actions,将游戏自动发布到 Pages 或 Itch.io。

关联工具GOGodot 持续集成工具官网 ↗
入门⏱ 约 20 分钟🎯 构建一次游戏并自动完成线上发布
  1. 1

    准备项目与发布凭据

    在本地创建 Godot 项目并确认可正常运行;进入 GitHub 或 GitLab 仓库的 Settings、Secrets,添加 Itch.io API Key 等发布凭据。

  2. 2

    配置容器导出参数

    依据仓库文档编写 Docker 导出配置,指定 Godot 版本、导出预设、项目目录和产物路径;先用本地命令验证镜像能够生成游戏。

  3. 3

    接入 GitHub Actions

    在仓库 Actions 页面新建工作流,复制 godot-ci 的 GitHub Actions 模板,填写导出配置与 Secrets 名称,并确认构建产物上传步骤。

  4. 4

    或接入 GitLab CI

    打开 GitLab 项目的 CI/CD 页面,复制仓库提供的 GitLab CI 模板并加入 .gitlab-ci.yml,在 Variables 中配置同名凭据后提交。

  5. 5

    运行并检查导出产物

    提交配置文件触发流水线,在 Actions 的运行记录或 GitLab CI 页面查看日志,确认导出成功、压缩包生成且下载产物与预期一致。

  6. 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 日志,确认模板文件已随首次触发流水线的提交一并提交。

相关工具