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.
Advertencia: A menos de que tu empresa utilice Usuarios Administrados de Enterprise, los sitios de Páginas de GitHub estarán disponibles públicamente en la internet predefinidamente, incluso si el repositorio del sitio es privado o interno. Puedes publicar el sitio de forma privada si administras el control de accesos de este. De lo contrario, si tienes datos sensibles en el repositorio de tu sitio, deberías eliminar los datos antes de publicarlo. Para obtener más información, consulta las secciones "Acercad de los repositorios" y "Cambiar la visbilidad de tu sitio de Páginas de GitHub".
Publicar desde una rama
-
Asegúrate de que la rama que quieres utilizar como tu fuente de publicación ya exista en tu repositorio.
-
En GitHub Enterprise Cloud, navega al repositorio de tu sitio.
-
Debajo de tu nombre de repositorio, da clic en Configuración.
-
En la sección de "Código y automatización" de la barra lateral, haz clic en Páginas .
-
Debajo de "Compilación y despliegue", debajo de "Fuente", selecciona Desplegar desde una rama.
-
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.
-
Opcionalmente, utiliza el menú desplegable para seleccionar una carpeta para tu fuente de publicación.
-
Haz clic en Save (guardar).
Solucionar problemas de publicación desde una rama
Nota: Si estás publicando desde una rama y tu sitio no se publicó automáticamente, asegúrate de que alguien con permisos administrativos y una dirección de correo electrónico verificada lo haya subido a la fuente de publicación.
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
Note: Publishing your Páginas de GitHub site with a custom GitHub Actions workflow is in beta and subject to change.
Para configurar tu sitio para que se publique con GitHub Actions:
-
En GitHub Enterprise Cloud, navega al repositorio de tu sitio.
-
Debajo de tu nombre de repositorio, da clic en Configuración.
-
En la sección de "Código y automatización" de la barra lateral, haz clic en Páginas .
-
Debajo de "Compilación y despliegue", debajo de "Fuente", selecciona GitHub Actions.
-
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:
- 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.
- Utiliza la acción
actions/checkout
para erificar el contenido del repositorio. - Si tu sitio lo requiere, compila cualquier archivo de sitio estático.
- Utiliza la acción
actions/upload-pages-artifact
para cargar los archivos estáticos como un artefacto. - 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".
Nota: Un archivo de CNAME
en tu archivo de repositorio no agrega ni elimina un dominio personalizado automáticamente. En su lugar, debes configurar el dominio personalizado mediante los ajustes de tu repositorio o mediante la API. Para obtener más información, consulta la sección "Administrar un dominio personalizado para tu sitio de GitHub Pages" y la documentación de referencia de la API de páginas.
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".