Skip to content

Godot: CI/CD — build HTML5 headless + deploy a GitHub Pages #48

Description

@leocagli

Objetivo

Crear un workflow de GitHub Actions que construya automáticamente el juego como HTML5 con Godot 4 headless y lo despliegue en GitHub Pages.

Alcance

  • Job build: instala Godot 4 headless + plantilla de exportación HTML5, exporta a dist/
  • Job deploy: sube dist/ a la rama gh-pages (o usa actions/deploy-pages)
  • Reemplaza el redirect actual en index.html raíz apuntando al nuevo build
  • Se ejecuta en push a main y en pull requests (build only, sin deploy)
  • Cache de la instalación de Godot para acelerar runs posteriores

Referencia

Patrón de scripts existente en scripts/ del repositorio; acción oficial chickensoft-games/setup-godot.

Tareas

  • Crear .github/workflows/godot-build.yml con triggers push: [main] y pull_request
  • Step setup-godot: usar chickensoft-games/setup-godot@v1 con versión 4.x y plantilla HTML5
  • Step export: godot --headless --export-release "HTML5" dist/index.html
  • Step deploy (solo en main): peaceiris/actions-gh-pages@v3 con publish_dir: dist
  • Actualizar index.html raíz para que redirija a dist/ en lugar del demo JS actual
  • Añadir badge de build en README.md

Aceptación

Cada push a main genera un nuevo build HTML5 en GitHub Pages en menos de 5 minutos y el juego es accesible en la URL pública del repo sin pasos manuales.

Metadata

Metadata

Assignees

No one assigned

    Labels

    godotPort a Godot 4

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions