Configurar una fuente de publicación para tu sitio de Páginas de GitHub

Acerca de las fuentes de publicación

You can publish your site when changes are pushed to a specific branch, or you can write a GitHub Actions workflow to publish your site.

If you do not need any control over the build process for your site, we recommend that you publish your site when changes are pushed to a specific branch. You can specify which branch and folder to use as your publishing source. The source branch can be any branch in your repository, and the source folder can either be the root of the repository (/) on the source branch or a /docs folder on the source branch. Whenever changes are pushed to the source branch, the changes in the source folder will be published to your Páginas de GitHub site.

If you want to use a build process other than Jekyll or you do not want a dedicated branch to hold your compiled static files, we recommend that you write a GitHub Actions workflow to publish your site. GitHub Enterprise Cloud provides starter workflows for common publishing scenarios to help you write your workflow.

Publicar desde una rama

1. Asegúrate de que la rama que quieres utilizar como tu fuente de publicación ya exista en tu repositorio.

2. En GitHub Enterprise Cloud, navega al repositorio de tu sitio.

3. Debajo de tu nombre de repositorio, da clic en Configuración.

4. En la sección de "Código y automatización" de la barra lateral, haz clic en Páginas .

5. Debajo de "Compilación y despliegue", debajo de "Fuente", selecciona Desplegar desde una rama.

6. Debajo de "Compilación y despliegue", debajo de "Rama", utiliza los menús desplegables de Ninguna o de Rama y selecciona una fuente de publicación.

   

7. Opcionalmente, utiliza el menú desplegable para seleccionar una carpeta para tu fuente de publicación.

8. Haz clic en Save (guardar).

Solucionar problemas de publicación desde una rama

Si eliges la carpeta de docs en cualquier rama como tu fuente de publicación y luego eliminas la carpeta de /docs de esta rama en tu repositorio posteriormente, tu sitio no se creará y obtendrás un mensaje de error de creación de página debido a una carpeta /docs faltante. Para obtener más información, consulta "Solución de problemas de errores de compilación de Jekyll para los sitios de Páginas de GitHub".

Tu sitio de Páginas de GitHub siempre se desplegará con una ejecución de flujo de trabajo de GitHub Actions, incluso si configuraste tu sitio de Páginas de GitHub para que compilara utilizando una herramienta de IC distinta. La mayoría de los flujos de trabajo de IC externos se "despliegan" en las GitHub Pages cuando confirmas la salida de compilación en la rama de gh-pages del repositorio y, habitualmente, incluyen un archivo de .nojekyll. Cuando esto sucede, el flujo de trabajo de GitHub Actions detectará el estado en el que la rama no necesita un paso de compilación y ejecutará solo los pasos necesarios para desplegar el sitio a los servidores de Páginas de GitHub.

Para encontrar errores potenciales en ya sea la compilación o el despliegue, puedes verificar la ejecución de flujo de trabajo para tu sitio de Páginas de GitHub si revisas las ejecuciones de flujo de trabajo del repositorio. Para obtener más información, consulta la sección "Visualizar el historial de ejecuciones de un flujo de trabajo". Para obtener más información sobre cómo volver a ejecutar el flujo de trabajo en caso de encontrar une error, consulta la sección "Volver a ejecutar flujos de trabajo y jobs".

Publicar con un flujo de trabajo de GitHub Actions personalizado

Para configurar tu sitio para que se publique con GitHub Actions:

1. En GitHub Enterprise Cloud, navega al repositorio de tu sitio.

2. Debajo de tu nombre de repositorio, da clic en Configuración.

3. En la sección de "Código y automatización" de la barra lateral, haz clic en Páginas .

4. Debajo de "Compilación y despliegue", debajo de "Fuente", selecciona GitHub Actions.

5. GitHub Enterprise Cloud te sugerirá varios flujos de trabajo iniciales. Si ya tienes un flujo de trabajo para publicar tu sitio, puedes omitir este paso. De lo contrario, elige una de las opciones para crear un flujo de trabajo de GitHub Actions. Para obtener más información sobre como crear tu flujo de trabajo personalizado, consulta la sección "Crear un flujo de trabajo de GitHub Actions personalizado para publicar tu sitio".

   Páginas de GitHub no asocia un flujo de trabajo específico a los ajustes de Páginas de GitHub. Sin embargo, los ajustes de Páginas de GitHub se enlazarán con la ejecución de flujo de trabajo que haya desplegado tu sitio más recientemente.

Crear un flujo de trabajo de GitHub Actions personalizado para publicar tu sitio

Para obtener más información sobre GitHub Actions, consulta la sección "Acciones".

Cuando configuras tu sitio para que se publique con GitHub Actions, GitHub Enterprise Cloud sugerirá flujos de trabajo iniciales para los escenarios de publicación comunes. El flujo general de un flujo de trabajo es:

1. Activarse cuando existe una subida a la rama predeterminada del repositorio o cuando una solicitud de cambios que apunta a la rama predeterminada se abre, se vuelve a abrir o se actualiza.
2. Utiliza la acción actions/checkout para erificar el contenido del repositorio.
3. Si tu sitio lo requiere, compila cualquier archivo de sitio estático.
4. Utiliza la acción actions/upload-pages-artifact para cargar los archivos estáticos como un artefacto.
5. Si el flujo de trabajo se activó mediante una subida a la rama predeterminada, utiliza la acción actions/deploy-pages para desplegar el artefacto. Este paso se omite si una solicitud de cambios activó el flujo de trabajo.

Los flujos de trabajo iniciales utilizan un ambiente de despliegue llamado github-pages. Si tu repositorio aún no incluye un ambiente llamado github-pages, este se creará automáticamente. Recomendamos que agregues una regla de protección de ambiente para que solo la rama predeterminada pueda desplegar hacia este. Para obtener más información, consulta la sección "Utilizar ambientes para despliegue".

Solucionar problemas de publicación con un flujo de trabajo de GitHub Actions personalizado

Para obtener más información sobre cómo solucionar los problemas de tu flujo de trabajo de GitHub Actions, consulta la sección "Acerca del monitoreo y la solución de problemas".