Guía rápida de GitHub Actions - Estructura estándar y lista de las acciones más útiles

GitHub Actions es una plataforma de automatización y CI/CD dentro de GitHub, utilizada para compilar, probar y desplegar su código basado en eventos como pushes, solicitudes de extracción o en un horario.

Además de GitHub estándar, puede usar GitHub Actions en un servidor Gitea autohospedado.

Este resumen cubre la estructura de GitHub Actions, una breve descripción y las acciones más comunes utilizadas en flujos de trabajo de código abierto y comerciales. Las acciones abarcan herramientas oficiales, de la comunidad y de terceros, apoyando la automatización desde construcciones y pruebas hasta despliegue, gestión de lanzamientos, QA y notificaciones.

Estructura de Configuración Básica

Los flujos de trabajo de GitHub Actions se definen en archivos YAML ubicados en el directorio .github/workflows dentro del repositorio.

name: Nombre del flujo de trabajo
on:
  push:
    branches: [ main ]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Configurar Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '18'
      - name: Ejecutar pruebas
        run: npm test

• El bloque on especifica los eventos de disparo.
• Cada job se ejecuta en su propio runner.
• steps pueden ejecutar comandos de shell o llamar a acciones reutilizables.

Componentes Principales del Flujo de Trabajo

Eventos de Desencadenamiento

• push
• pull_request
• schedule (usando sintaxis cron)
• workflow_dispatch (desencadenador manual, permite parámetros de entrada)
• release, issue, etc.

Ejemplo:

on:
  push:
    branches: [ main ]
  workflow_dispatch:
    inputs:
      environment:
        description: 'Entorno de despliegue'
        required: true
        default: 'producción'
        type: string

Acciones Útiles Preinstaladas

Parámetros de Acción

Parámetros Generales para Cualquier Llamada de Acción:

- name: Alguna Acción o Paso
  uses: owner/repo@ref
  with:
    param1: valor
    param2: valor
  env:
    ENV_VAR: valor
  if: ${{ condición }}
  run: comando_a_ejecutar
  shell: bash|pwsh|python|sh
  continue-on-error: true|false

• with: argumentos pasados a la acción (ver documentación de la acción para todas las opciones)
• env: variables de entorno para el paso
• if: ejecución condicional
• run: comandos de shell (si no se usa una acción)
• shell: shell usado para ejecutar el paso
• continue-on-error: continuar incluso si el paso falla

Definir Entradas de Acción Personalizadas

En su metadatos de acción (action.yml):

inputs:
  example-input:
    description: 'Un ejemplo de entrada'
    required: false
    default: 'valor-por-defecto'

Cuando se usa en un flujo de trabajo:

- uses: my/action@v1
  with:
    example-input: 'valor-personalizado'

Accedido como variable de entorno INPUT_EXAMPLE_INPUT cuando se ejecuta la acción.

Ejemplo: Flujo de Trabajo con Parámetros Manuales

name: Desplegar
on:
  workflow_dispatch:
    inputs:
      environment:
        description: 'Entorno de despliegue'
        required: true
        default: 'producción'
        type: string
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Ver código
        uses: actions/checkout@v4
      - name: Desplegar en entorno
        run: echo "Desplegando en ${{ github.event.inputs.environment }}"

Mercado de Acciones

• Hay miles de acciones reutilizables disponibles en el Mercado de GitHub.
• Categorías incluyen: despliegues en la nube, herramientas de notificación, marcos de prueba, análisis de código y más.
• Explorar: actions/checkout, actions/setup-node, docker/build-push-action, actions/cache, actions/upload-artifact, y muchos otros.

Consejos Rápidos

• Coloque los archivos de flujo de trabajo en .github/workflows.
• Use workflow_dispatch con inputs para ejecuciones manuales y parametrizadas.
• Use la acción cache para acelerar la instalación de dependencias.
• Use la matriz de trabajo para probar múltiples versiones de OS/entorno de ejecución.
• Use secretos para datos sensibles, referenciados como ${{ secrets.NOMBRE_DEL_SECRETO }}.

Este resumen cubre los fundamentos de usar, configurar y extender GitHub Actions para automatización, CI/CD y más. Para más detalles y actualizaciones, siempre consulte la documentación oficial de GitHub y los repositorios de acción.

Acciones de GitHub Comunes

Aquí hay una lista práctica de acciones de GitHub frecuentemente usadas que ayudan a automatizar CI/CD, pruebas, construcción, despliegue y tareas de flujo de trabajo:

Acciones Oficiales Principales

Acciones Comunitarias y de Terceros Populares

Acciones de Pruebas, QA y Reportes

Acciones de Despliegue y Notificación

Acciones de Utilidad y Gestión de Flujo de Trabajo

Cómo Encontrar Más

Hay muchas GurHub Actions que permiten la automatización de flujos de trabajo como pruebas automatizadas, despliegue a producción, notificaciones e integraciones con otros servicios. El Mercado de GitHub lista miles de acciones en categorías como pruebas, seguridad, despliegue, notificaciones, calidad del código e integraciones. Listas curadas como “Awesome Actions” también son excelentes para inspiración y descubrimiento.

Enlaces Útiles

• https://docs.github.com/actions
• https://github.com/marketplace
• https://docs.github.com/en/actions/get-started/quickstart
• https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions
• Hoja de Trucos de Git
• Gitea - instalación y pruebas
• Respuesta y copia de seguridad del servidor Gitea
• Usando Gitea Actions para desplegar un sitio web de Hugo a AWS S3
• Gitflow: Pasos, Alternativas, Ventajas y Desventajas
• DevOps con GitOps - Argo CD, Flux, Jenkins X, Weave GitOps y otros