Tu funcionalidad se ha integrado, así que ya puedes compartirla. En este tutorial, configurarás el despliegue automático para que cada push a main publique tu proyecto de software en un sitio web en producción.
Nota:
La URL de su sitio GitHub Pages depende de la versión de GitHub que utilice.
- A fecha de GitHub.com, tu sitio está publicado en
YOUR-USERNAME.github.io/REPOSITORY. - Si usa GitHub con residencia de datos en GHE.com, el sitio se publica en
pages.SUBDOMAIN.ghe.com/YOUR-USERNAME/REPOSITORY, dondeSUBDOMAINes el subdominio de su empresa. - En GitHub Enterprise Server, tu sitio está publicado en
pages.HOSTNAME/YOUR-USERNAME/REPOSITORY, dondeHOSTNAMEes el nombre de host de tu instancia GitHub Enterprise Server.
Prerequisites
- Un
stargazers-logrepositorio con tu funcionalidad integrada. Si aún no lo ha combinado, consulte Revisión de los cambios propuestos.
Habilitar GitHub Pages
Configura GitHub Pages para alojar tu sitio y usa GitHub Actions para compilarlo y publicarlo.
- En GitHub, vaya a su repositorio
stargazers-log. - En el nombre del repositorio, haga clic en Configuración.
- En la barra lateral, en la sección "Código y automatización", haga clic en Páginas.
- En "Compilación e implementación", en la lista desplegable Origen , seleccione GitHub Actions.
Deje la otra configuración en sus valores predeterminados. A continuación, creará su propio flujo de trabajo para compilar e implementar el sitio automáticamente.
Creación de un flujo de trabajo de implementación
Un flujo de trabajo es un conjunto de pasos automatizados que GitHub Actions ejecuta por ti. Añade uno que compile y despliegue tu sitio cada vez que hagas push a main.
-
En el repositorio, crea un archivo con el nombre
.github/workflows/deploy.yml.- En la página principal del repositorio encima de
stargazers-logla lista de archivos, haga clic en y, a continuación, haga clic en Crear nuevo archivo. - En el campo del nombre de archivo, escriba
.github/workflows/deploy.yml.
- En la página principal del repositorio encima de
-
Agregue el siguiente contenido de flujo de trabajo.
YAML name: Deploy to GitHub Pages on: push: branches: - main permissions: contents: read pages: write id-token: write jobs: deploy: runs-on: ubuntu-latest environment: name: github-pages url: ${{ steps.deployment.outputs.page_url }} steps: - name: Checkout uses: actions/checkout@v6 - name: Setup Pages uses: actions/configure-pages@v5 - name: Upload artifact uses: actions/upload-pages-artifact@v4 with: path: '.' - name: Deploy to GitHub Pages id: deployment uses: actions/deploy-pages@v4name: Deploy to GitHub Pages on: push: branches: - main permissions: contents: read pages: write id-token: write jobs: deploy: runs-on: ubuntu-latest environment: name: github-pages url: ${{ steps.deployment.outputs.page_url }} steps: - name: Checkout uses: actions/checkout@v6 - name: Setup Pages uses: actions/configure-pages@v5 - name: Upload artifact uses: actions/upload-pages-artifact@v4 with: path: '.' - name: Deploy to GitHub Pages id: deployment uses: actions/deploy-pages@v4 -
Confirme el archivo directamente en la
mainrama.
Descripción del flujo de trabajo
Cada parte del flujo de trabajo tiene un trabajo que realizar:
onle indica a GitHub Actions que ejecute el flujo de trabajo en cada push amain.permissionsconceda al flujo de trabajo el acceso que necesita para publicar en GitHub Pages.environmentconecta la tarea con tu sitio GitHub Pages y expone la URL publicada como${{ steps.deployment.outputs.page_url }}.stepsconsulte el código, prepare GitHub Pages, cargue los archivos como un artefacto e impleméntelos en el sitio activo.
Ver tu sitio en vivo
Después de confirmar el flujo de trabajo, GitHub Actions lo ejecuta automáticamente.
- En el repositorio, haga clic en la pestaña Acciones para ver la ejecución del flujo de trabajo.
- Haga clic en la última ejecución del flujo de trabajo para ver un resumen con los detalles de la tarea.
- Cuando finalice la ejecución, abra su sitio publicado en
https://YOUR-USERNAME.github.io/stargazers-log/. SustituyaYOUR-USERNAMEpor su nombre de usuario.- Por ejemplo, si el nombre de usuario de tu cuenta GitHub es
octocat, tu sitio está enhttps://octocat.github.io/stargazers-log/.
- Por ejemplo, si el nombre de usuario de tu cuenta GitHub es
A partir de ahora, cada push a main vuelve a desplegar tu sitio con tus cambios más recientes.
Lo que ha creado
A lo largo de esta serie, has creado un proyecto de software completo y has practicado el flujo de trabajo GitHub:
| Stage | Lo que ha aprendido |
|---|---|
| Creación de un proyecto de software | Repositorios, archivos README |
| Planificación del trabajo | Problemas, proyectos (paneles de proyecto) |
| Conexión local | |
| GitHub Desktop, clonación | |
| Escritura y almacenamiento de código | Ramas, confirmaciones, solicitudes de incorporación de cambios, Copilot |
| Revisión de los cambios | Revisiones de solicitudes de incorporación de cambios, Copilot |
| Desplegando automáticamente | |
| GitHub Actions, GitHub Pages |
Pasos siguientes
- Amplía tu comprensión de Git y GitHub. Para obtener más información, vea Recursos de aprendizaje de Git y GitHub.
- Explora Chat de Copiloto para aprender más rápido y obtener ayuda mientras programas. Para obtener más información, consulte Acerca de GitHub Copilot Chat.
- Profundiza en la inteligencia artificial y aprende cómo los agentes pueden actuar como un asociado de codificación práctico convirtiendo ideas en pequeños pasos accionables, generando ejemplos y controlando el trabajo repetitivo. Para obtener más información, consulte Conceptos para agentes de GitHub Copilot.
- Obtenga más información sobre cómo automatizar los proyectos de software con GitHub Actions flujos de trabajo. Para obtener más información, vea Descripción de Acciones de GitHub.
- Agregue un dominio personalizado o explore más formas de publicar el sitio web con GitHub Pages. Para obtener más información, vea Introducción a las páginas de GitHub.