Aula 4 · 17 min
Pôr um link de volta em quarenta repositórios, trocar um rodapé em cem páginas, corrigir um canônico em todo o site: é aqui que o agente economiza horas e é aqui que um erro se espalha. Três proteções resolvem quase tudo: mostrar antes de fazer, não duplicar e não mexer no que outra pessoa está mexendo.
Começar a aula
Objetivo: rodar uma operação em vários repositórios com dry-run, marcador contra duplicar e pulo de repo sujo, conferindo por amostra.
Clique em cada bloco.
Três proteções: dry-run, marcador e pulo de repositório sujo.
Clique em cada passo.
O padrão do script é não gravar. Gravar exige pedir: --apply. Assim um erro no mapa aparece na lista, não no site.
Peça a mesma coisa a qualquer agente: primeiro a lista do que ele faria, depois a execução.
O bloco gravado vai entre dois comentários com o marcador link-de-volta:v1. Antes de gravar, o script procura o marcador: se já existe, responde "OK: já tinha".
É o que deixa rodar de novo depois de uma falha sem criar dois links na mesma página.
Se o repositório tem alteração não commitada, o script pula. Quase sempre é outra sessão (sua ou de outro agente) trabalhando nele.
Pula também o repositório fora da branch esperada e o que não tem HTML. No INEMA, repositórios pulados por árvore suja ficaram para a rodada seguinte.
Se o index.html é só um redirecionamento (meta refresh), o link vai na página de destino. Se o HTML é gerado por script, o link vai no gerador, senão some no próximo build.
No INEMA: 35 de 40 repositórios em 24/09, mais 25 em 02/10 e mais 21 em 05/10.
Troque os caminhos e os destinos pelos seus.
[{"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
Monte o mapa.json com os repositórios da lista e rode o link_de_volta.py SEM opções (dry-run). Me mostre a saída inteira e pare. Não use --apply nem --commit até eu responder "aplica". Repositório com PULA: não force, não faça stash, não commite por ele. Só me diga qual é.
$ 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
Quatro repositórios de teste montados para a aula.
Depois do --apply sem --commit, curso-pao e curso-vinho ficam com alteração não commitada: rodar de novo sem commitar faz o script pular os dois. Commite ou descarte antes da próxima rodada.
Rode, interrompa no meio e rode de novo. O que já foi feito não é refeito.
Simulação ilustrativa no navegador: nada é gravado de verdade. O pulo é proposital, para mostrar o repositório sujo.
Use 3 ou mais repositórios seus (ou crie repositórios de teste com um index.html simples).
Peça ao agente o mapa.json e o dry-run, com o pedido acima. Deixe de propósito um repositório com uma alteração não commitada.
Pronto quando: a saída mostra pelo menos um DRY e um PULA com o motivo, e o git status dos repositórios não mudou.
Responda "aplica", rode com --apply, confira o diff de cada repositório, commite (ou use --commit) e rode o dry-run de novo.
Pronto quando: a segunda rodada responde "OK: já tinha" nos repositórios aplicados, e você abriu pelo menos 2 páginas publicadas e viu o link no HTML.
A explicação aparece depois da sua resposta.
Pergunta 1 de 4
O que o link_de_volta.py faz quando você roda sem nenhuma opção?competência
Pergunta 2 de 4
Um repositório aparece como "PULA: alterações não commitadas". O que fazer?
Pergunta 3 de 4
Para que serve o marcador link-de-volta:v1?
Pergunta 4 de 4
O index.html de um curso é só um redirecionamento. Onde o link deve entrar?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.