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.

  2. En el directorio .github/workflows, cree un archivo denominado github-actions-demo.yml. Para más información, vea "Creación de archivos".

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

    YAML
    name: GitHub Actions Demo
    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@v3
          - 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. Archivo de flujo de trabajo de confirmación

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, vaya a la página principal del repositorio. 1. En el nombre del repositorio, haga clic en Acciones. Pestaña Acciones en la navegación del repositorio principal

  2. En la barra lateral izquierda, da clic en el flujo de trabajo que quieras ver.

    Lista de flujos de trabajo en la barra lateral izquierda

  3. Desde la lista de ejecuciones de flujo de trabajo, da clic en el nombre de la ejecución que quieres ver.

    Nombre de la ejecución de flujo de trabajo

  4. En Trabajos, haga clic en el trabajo Explore-GitHub-Actions.

    Ubicar un job

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

    Resultados del flujo de trabajo de ejemplo

    Por ejemplo, puede ver la lista de archivos del repositorio: Detalle de la acción de ejemplo

Más flujos de trabajo de inicio

GitHub Proporciona un flujo de trabajo preconfigurado que puedes personalizar para crear tu propio flujo de trabajo de integración contínua. GitHub Enterprise Cloud analiza tu código y te muestra el flujo de trabajo inicial de IC que podría ser útil 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 el flujo de trabajo inicial como un lugar para comenzar a crear tu flujo de trabajo personalizado o utilizarlo tal cual.

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

Ejemplos más complejos

Para ver ejemplos que demuestren características más complejas de GitHub Actions, consulta "Ejemplos". Para ver ejemplos detallados que explican cómo probar el código en un ejecutor, accede a la CLI de GitHub y usa características avanzadas, como la simultaneidad y las matrices de prueba.

Pasos siguientes

El flujo de trabajo de ejemplo que acabas de agregar se ejecuta cada vez que se sube el código a la rama y te muestra cómo pueden funcionar las GitHub Actions con el contenido de tu repositorio. Pero esto es solo el principio de lo que puede hacer con GitHub Actions:

  • Tu repositorio puede contener varios flujos de trabajo que activen jobs diferentes basándose en eventos diferentes.
  • Puedes utilizar un flujo de trabajo apra instalar las apps de prueba de software y hacer que prueben tu código automáticamente en los ejecutores de GitHub.

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: