Que GitHub trabaje mientras duermes

Este es el último ladrillo, y es el que convierte un repositorio en algo que trabaja solo. La idea en una frase: cuando pase esto, corre esto ⚙️

Para qué sirve de verdad

• Revisar que lo que alguien propone no rompa nada, antes de aceptarlo.
• Publicar la web sola cada vez que subes, como en 19.
• Tareas de calendario: un reporte todos los lunes a las siete.
• Comprobaciones aburridas que nadie se acuerda de hacer, como que ningún CSV llegue con la ciudad vacía.

Y para qué no: si tu proyecto es una carpeta con dos scripts que corres tú una vez al mes, montar Actions es trabajo que no se paga 🙃

El archivo

Vive en una ruta exacta, .github/workflows/, y termina en .yml. Vamos a escribir uno que revise el CSV de ventas en cada push:

mkdir reporte-ventas
cd reporte-ventas
git init -q
printf 'ciudad,monto\nLima,1200\nArequipa,890\n' > ventas.csv
mkdir -p .github/workflows
cat > .github/workflows/revisa.yml <<'FIN'
name: Revisa el CSV de ventas

on:
  push:
  pull_request:

jobs:
  revisar:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Ningun monto vacio
        run: |
          tail -n +2 ventas.csv | cut -d, -f2 | grep -q '^$' && exit 1
          echo "CSV correcto"
FIN
git add .
git commit -q -m "Se revisa el CSV de ventas en cada push"
git ls-files

.github/workflows/revisa.yml
ventas.csv

Léelo de arriba abajo y se entiende sin saber nada: se llama así, se dispara con un push o un pull request, corre en una máquina Linux, se baja tu código y ejecuta esos comandos 📖

Probar la revisión aquí antes de subirla

Lo que corre allá son comandos normales, así que se pueden probar en tu máquina primero. Es lo que yo hago siempre, porque esperar a que GitHub falle para descubrir un error de dedo es lentísimo:

tail -n +2 ventas.csv | cut -d, -f2 | grep -q '^$' && exit 1
echo "CSV correcto"

CSV correcto

printf 'Cusco,\n' >> ventas.csv
tail -n +2 ventas.csv | cut -d, -f2 | grep -q '^$'
echo "encontro una fila vacia, la revision fallaria"

encontro una fila vacia, la revision fallaria

Con eso ya sabes que la revisión detecta lo que tiene que detectar, y recién ahí la subes 🔍

git checkout -q ventas.csv
cat ventas.csv

ciudad,monto
Lima,1200
Arequipa,890

Cuándo se dispara

El de pull_request es el que más cambia la vida de un equipo: la revisión automática corre sobre la propuesta y quien revisa ya sabe si funciona antes de leer una línea, que es justo lo que le faltaba a la trampa de 23 ✅

Las claves no van dentro

Si tu automatización necesita una clave, va en Settings > Secrets and variables > Actions, y en el archivo se usa por su nombre:

      - name: Manda el reporte
        env:
          TOKEN: ${{ secrets.TOKEN_DEL_REPORTE }}
        run: python3 manda_reporte.py

Ese archivo se puede subir tranquilamente: no lleva el valor, lleva el nombre. Y GitHub tapa el valor en los registros si por accidente se imprime 🔐

Cuánto cuesta

En repositorios públicos, Actions es gratis. En privados hay minutos incluidos al mes y después se paga, así que conviene mirar el consumo antes de poner algo a correr cada cinco minutos ⏱️

name: Reporte diario
on:
  schedule:
    - cron: '0 12 * * *'
jobs:
  reporte:
    runs-on: ubuntu-latest
    steps:
      - run: curl -H "Authorization: Bearer sk-abc123..." ...

Comprueba que se entendió

Ejercicios

cd ..
mkdir catalogo
cd catalogo
git init -q
printf 'bodega,ciudad\nBodega Inti,Cusco\n' > bodegas.csv
mkdir -p .github/workflows
cat > .github/workflows/revisa.yml <<'FIN'
name: Revisa el catalogo

on:
  push:
  pull_request:

jobs:
  revisar:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: |
          tail -n +2 bodegas.csv | cut -d, -f2 | grep -q '^$' && exit 1
          echo "catalogo correcto"
FIN
git add .
git commit -q -m "Se revisa el catalogo en cada push"
git ls-files

.github/workflows/revisa.yml
bodegas.csv

tail -n +2 bodegas.csv | cut -d, -f2 | grep -q '^$' && exit 1
echo "catalogo correcto"

catalogo correcto

printf 'Mayorista Norte,\n' >> bodegas.csv
tail -n +2 bodegas.csv | cut -d, -f2 | grep -q '^$'
echo "detectado, la revision fallaria"

detectado, la revision fallaria

git checkout -q bodegas.csv
cat bodegas.csv
git status --short

bodega,ciudad
Bodega Inti,Cusco

cat > .github/workflows/semanal.yml <<'FIN'
name: Reporte semanal

on:
  schedule:
    - cron: '0 12 * * 1'
  workflow_dispatch:

jobs:
  reporte:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: wc -l bodegas.csv
FIN
git add .github
git commit -q -m "Reporte semanal del catalogo"
git ls-files .github

.github/workflows/revisa.yml
.github/workflows/semanal.yml

grep -rn "TOKEN=\|API_KEY=\|password" .github || echo "limpio"
cat .github/workflows/semanal.yml | head -6

limpio
name: Reporte semanal

on:
  schedule:
    - cron: '0 12 * * 1'
  workflow_dispatch:

cat .github/workflows/despliegue.yml

cat: .github/workflows/despliegue.yml: No such file or directory

Lo que te llevas

Cuando pase esto, corre esto. Prueba los comandos en tu máquina antes, y las claves siempre en los secrets.