Skip to main content

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

Puedes configurar tu sitio de Páginas de GitHub para que se publique cuando los cambios se suban a una rama específica o puedes escribir un flujo de trabajo de GitHub Actions para publicar tu sitio.

People with admin or maintainer permissions for a repository can configure a publishing source for a Páginas de GitHub site.

Páginas de GitHub se encuentra disponible en los repositorios públicos con GitHub Free y con GitHub Free para las organizaciones, y en los repositorios públicos y privados con GitHub Pro, GitHub Team, Nube de GitHub Enterprise, y GitHub Enterprise Server. Para obtener más información, consulta la sección "Productos 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.

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

  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. Botón de configuración del repositorio

  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.

    Menú desplegable para seleccionar una fuente de publicación

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

  8. Haz clic en Save (guardar). Botón para guardar los cambios en la configuración de la fuente de publicación

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:

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

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

  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".

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".