Skip to main content

Guía de inicio rápido para GitHub Actions

Prueba las características de las GitHub Actions en 5 minutos o menos.

Introducción

Solo necesitas un repositorio de GitHub para crear y ejecutar un flujo de trabajo de GitHub Actions. En esta guía, agregarás un flujo de trabajo que demuestre algunas de las características esenciales de las GitHub Actions.

El siguiente ejemplo te muestra cómo los jobs de las GitHub Actions pueden activarse automáticamente, dónde se ejecutan y cómo pueden interactuar con el código en tu repositorio.

Crear tu primer flujo de trabajo

  1. Cree un directorio .github/workflows en el repositorio de GitHub si todavía no existe. El directorio debe tener este nombre exacto para que GitHub detecte los flujos de trabajo de GitHub Actions que contenga.

  2. En el directorio .github/workflows, cree un archivo con la extensión .yml o .yaml . En este tutorial se llamará al archivo github-actions-demo.yml. Para obtener más información, consulte "Crear nuevos archivos".

  3. Copia el siguiente contenido de YAML en el archivo github-actions-demo.yml:

    YAML
    name: GitHub Actions Demo
    run-name: ${{ github.actor }} is testing out GitHub Actions 🚀
    on: [push]
    jobs:
      Explore-GitHub-Actions:
        runs-on: ubuntu-latest
        steps:
          - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event."
          - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!"
          - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}."
          - name: Check out repository code
            uses: actions/checkout@v4
          - run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner."
          - run: echo "🖥️ The workflow is now ready to test your code on the runner."
          - name: List files in the repository
            run: |
              ls ${{ github.workspace }}
          - run: echo "🍏 This job's status is ${{ job.status }}."
    
  4. Desplácese a la parte inferior de la página y seleccione Crear una rama para esta confirmación e iniciar una solicitud de incorporación de cambios. Después, para crear una solicitud de incorporación de cambios, haga clic en Proponer archivo nuevo.

    Captura de pantalla del área "Confirmar nuevo archivo" de la página.

Al confirmar el flujo de trabajo en una rama del repositorio se desencadena el evento push y se ejecuta el flujo de trabajo.

Ver los resultados de tu flujo de trabajo

  1. En GitHub.com, navega a la página principal del repositorio.

  2. En el nombre del repositorio, haz clic en Acciones.

    Captura de pantalla de las pestañas del repositorio "github/docs". La pestaña "Proyectos" aparece resaltada con un contorno naranja.

  3. En la barra lateral izquierda, haga clic en el flujo de trabajo que deseas mostrar, en este ejemplo "Demostración de las acciones de GitHub".

    Captura de pantalla de la página "Acciones". El nombre del flujo de trabajo de ejemplo, "Demostración de las acciones de GitHub", se resalta con un contorno naranja oscuro.

  4. En la lista de ejecuciones de flujo de trabajo, haga clic en el nombre de la ejecución que deseas ver, en este ejemplo "USERNAME está probando Acciones de GitHub".

  5. En la barra lateral izquierda de la página de ejecución del flujo de trabajo, en Trabajos, haz clic en el trabajo Explorar-Acciones-GitHub.

    Captura de pantalla de la página "Ejecución de flujo de trabajo". En la barra lateral izquierda, el trabajo "Explorar-Acciones-GitHub" está resaltado con un contorno naranja oscuro.

  6. La bitácora muestra cómo se procesó cada uno de los pasos. Expande cualquiera de los pasos para ver sus detalles.

    Captura de pantalla de los pasos ejecutados por el flujo de trabajo.

    Por ejemplo, puede ver la lista de archivos en el repositorio: captura de pantalla del paso "Enumerar archivos del repositorio" expandido para mostrar la salida del registro. La salida del paso se resalta con un resaltado naranja oscuro.

El flujo de trabajo de ejemplo que acabas de agregar se desencadena cada vez que se inserta código en la rama y te muestra cómo pueden funcionar las GitHub Actions con el contenido de tu repositorio. Para ver un tutorial detallado, consulte "Entender las GitHub Actions".

Más flujos de trabajo de inicio

GitHub proporciona flujos de trabajo preconfigurados que puedes personalizar para crear tu propio flujo de trabajo de integración continua. GitHub Enterprise Cloud analiza tu código y te muestra flujos de trabajo inicial de CI que podrían ser útiles para tu repositorio. Por ejemplo, si tu repositorio contiene un código Node.js, verás sugerencias para los proyectos de Node.js. Puedes utilizar flujos de trabajo iniciales como un primer paso para crear un flujo de trabajo personalizado o utilizarlos tal cual.

Puedes examinar la lista completa del flujo de trabajo de inicio en el repositorio actions/starter-workflows repository.

Pasos siguientes

GitHub Actions puede ayudarte a automatizar casi cualquier aspecto de tu s procesos de desarrollo de aplicaciones. ¿Ya está listo para comenzar? Aquí tienes algunos recursos útiles para que tomes tus siguientes pasos con GitHub Actions:

  • Para obtener una manera rápida de crear un flujo de trabajo de GitHub Actions, consulte “Utilizar flujos de trabajo iniciales”.
  • Para conocer los flujos de trabajo de integración continua (CI) para compilar y probar el código, consulta "Compilaciones automáticas y pruebas".
  • Para compilar y publicar paquetes, consulta "Publicar paquetes".
  • Para implementar proyectos, consulta "Implementación".
  • Para automatizar tareas y procesos en GitHub, consulta "Administrar propuestas y solicitudes de cambios".
  • Para ejemplos que muestren características más complejas de GitHub Actions, incluidos muchos de los casos de uso anteriores, consulta "Ejemplos". Puede ver ejemplos detallados que explican cómo probar el código en un ejecutor, acceder a la CLI de GitHub y usar características avanzadas, como la simultaneidad y las matrices de prueba.
  • Si quiere certificar su competencia en la automatización de flujos de trabajo y aceleración del desarrollo con GitHub Actions, puede obtener un certificado de GitHub Actions con GitHub Certifications. Para más información, consulta "Acerca de GitHub Certifications".