Clase 4 · 17 min
Poner un enlace de vuelta en cuarenta repositorios, cambiar un pie de página en cien páginas, corregir un canónico en todo el sitio: aquí es donde el agente ahorra horas y también donde un error se esparce. Tres protecciones resuelven casi todo: mostrar antes de hacer, no duplicar y no tocar lo que otra persona está tocando.
Comenzar la lección
Objetivo: ejecutar una operación en varios repositorios con dry-run, marcador contra duplicar y salto de repositorio sucio, verificando por muestra.
Toca cada bloque.
Tres protecciones: dry-run, marcador y salto de repositorio sucio.
Toca cada paso.
El comportamiento predeterminado del script es no escribir. Escribir exige pedirlo: --apply. Así un error en el mapa aparece en la lista, no en el sitio.
Pídele lo mismo a cualquier agente: primero la lista de lo que haría, después la ejecución.
El bloque escrito va entre dos comentarios con el marcador link-de-volta:v1. Antes de escribir, el script busca el marcador: si ya existe, responde "OK: já tinha".
Es lo que permite volver a ejecutar después de una falla sin crear dos enlaces en la misma página.
Si el repositorio tiene un cambio sin commit, el script lo salta. Casi siempre es otra sesión (tuya o de otro agente) trabajando en él.
También salta el repositorio que está fuera de la rama esperada y el que no tiene HTML. En INEMA, los repositorios saltados por árbol de trabajo sucio quedaron para la ronda siguiente.
Si el index.html es solo una redirección (meta refresh), el enlace va en la página de destino. Si el HTML lo genera un script, el enlace va en el generador; si no, desaparece en el próximo build.
En INEMA: 35 de 40 repositorios el 24/09, otros 25 el 02/10 y otros 21 el 05/10.
Cambia las rutas y los destinos por los tuyos.
[{"repo": "repos/curso-pao", "destino": "https://www.seusite.com/cursos/pao/", "rotulo": "Ficha completa"},
{"repo": "repos/curso-cafe", "destino": "https://www.seusite.com/cursos/cafe/", "rotulo": "Ficha completa"},
{"repo": "repos/curso-queijo", "destino": "https://www.seusite.com/cursos/queijo/", "rotulo": "Ficha completa"},
{"repo": "repos/curso-vinho", "destino": "https://www.seusite.com/cursos/vinho/", "rotulo": "Ficha completa"}]python3 tools/link_de_volta.py mapa.json # dry-run: só mostra python3 tools/link_de_volta.py mapa.json --apply # grava, sem commit python3 tools/link_de_volta.py mapa.json --apply --commit # grava, commita e faz push
Arma el mapa.json con los repositorios de la lista y ejecuta link_de_volta.py SIN opciones (dry-run). Muéstrame la salida completa y detente. No uses --apply ni --commit hasta que yo responda "aplica". Repositorio con PULA: no fuerces, no hagas stash, no hagas commit por él. Solo dime cuál es.
$ python3 tools/link_de_volta.py mapa.json repos/curso-pao: DRY: entraria em index.html repos/curso-cafe: PULA: alterações não commitadas repos/curso-queijo: OK: já tinha repos/curso-vinho: DRY: entraria em landing.html $ python3 tools/link_de_volta.py mapa.json --apply repos/curso-pao: APLICADO em index.html repos/curso-cafe: PULA: alterações não commitadas repos/curso-queijo: OK: já tinha repos/curso-vinho: APLICADO em landing.html
Cuatro repositorios de prueba armados para la clase.
Después del --apply sin --commit, curso-pao y curso-vinho quedan con cambios sin commit: volver a ejecutar sin hacer commit hace que el script salte a los dos. Haz commit o descarta los cambios antes de la próxima ronda.
Ejecuta, interrumpe a la mitad y ejecuta de nuevo. Lo que ya se hizo no se rehace.
Simulación ilustrativa en el navegador: no se escribe nada de verdad. El salto es intencional, para mostrar el repositorio sucio.
Usa 3 o más repositorios tuyos (o crea repositorios de prueba con un index.html simple).
Pídele al agente el mapa.json y el dry-run, con el pedido de arriba. Deja a propósito un repositorio con un cambio sin commitear.
Listo cuando: la salida muestra al menos un DRY y un PULA con el motivo, y el git status de los repositorios no cambió.
Responde "aplica", ejecuta con --apply, revisa el diff de cada repositorio, haz commit (o usa --commit) y ejecuta el dry-run de nuevo.
Listo cuando: la segunda ronda responde "OK: já tinha" en los repositorios aplicados, y abriste al menos 2 páginas publicadas y viste el enlace en el HTML.
La explicación aparece después de tu respuesta.
Pregunta 1 de 4
¿Qué hace link_de_volta.py cuando lo ejecutas sin ninguna opción?competencia
Pregunta 2 de 4
Un repositorio aparece como "PULA: alterações não commitadas". ¿Qué haces?
Pregunta 3 de 4
¿Para qué sirve el marcador link-de-volta:v1?
Pregunta 4 de 4
El index.html de un curso es solo una redirección. ¿Dónde debe entrar el enlace?
Elige una alternativa. La explicación aparece después de tu intento.