Conceito e mecanismo
Um repositório permite identificar a origem do playbook, mas a existência de Git não garante que o commit contém a correção pretendida. Git add prepara o conteúdo nesse momento. Uma edição posterior do ficheiro não entra automaticamente num commit normal sem nova preparação.
Revê a diferença entre working tree, índice e commit antes de publicar. Se push é recusado por non-fast-forward, analisa e integra alterações remotas pelo processo da equipa, resolve conflitos e valida o resultado. Forçar a substituição do histórico partilhado não é a correção automática para essa mensagem.
O pipeline deve identificar o commit utilizado, para que o diagnóstico compare o mesmo artefacto.
Aplicação guiada
VS Code e contentores de desenvolvimento ajudam a repetir ferramentas e dependências, mas exigem configuração coerente do runtime. Se a extensão espera Docker e o ambiente usa Podman, confirma a configuração documentada, em vez de mudar o playbook de produção para resolver um problema do editor.
Lint e syntax checks detetam classes úteis de defeitos sem demonstrar acesso remoto ou resultado funcional. Check mode também tem limites: uma tarefa command sem creates ou removes pode ser saltada, deixando um caminho por ensaiar. Num caso fictício de passagem a RUN, pede execução do mesmo commit e ambiente por outro colega.
Guarda resultado, limites da simulação e verificações funcionais. Remove saídas debug sensíveis antes de partilhar artefactos, mesmo quando os valores vieram de Vault.
Separar o ficheiro, o índice e o commit
No laboratório original, o commit inicial contém batch_window=120. O autor altera para 90, executa git add e depois escreve 60 sem voltar a preparar. Existem agora três estados: HEAD 120, índice 90 e working tree 60.
Um commit normal grava 90. Para rever o que será gravado, compara o índice com HEAD através de git diff --cached; para ver a edição que ainda falta preparar, usa git diff. A indicação MM no status resume as duas diferenças.
Antes de promover uma correção, não basta olhar para o editor: confirma o snapshot preparado. Se precisas de retirar a alteração do próximo commit preservando a edição, git restore --staged atua no índice. Acrescentar --worktree também substituiria o ficheiro, alterando a intenção da operação.
Obter revisões sem confundir referências
O segundo clone recebe 90, porque 60 ainda não foi publicado. Depois de o autor publicar 80, fetch atualiza origin/main mas deixa HEAD e o ficheiro do segundo clone em 90. Esta separação permite inspecionar a diferença antes de integrar. origin/main é uma referência local ao estado observado, não uma leitura contínua do remoto.
Regista o instante de fetch e os identificadores usados. Um branch pode avançar; a tag approved-90 do exercício conserva o commit aprovado enquanto main evolui. Para reproduzir uma entrega, confirma o identificador do commit associado ao manifesto.
Se trabalhares em detached HEAD e criares um commit que queres manter, cria um branch nessa revisão antes de mudar de contexto.
Resolver um conflito com intenção operacional
Partindo de 90, um clone publica 80 e o outro cria 60. O push do segundo é recusado. Fetch permite observar a divergência, mas não decide qual janela é correta.
O merge do exercício gera um conflito e três entradas no índice para o caminho. O autor escolhe 70 como valor fictício acordado, remove os marcadores e faz add antes de concluir. O novo commit tem dois pais, preservando as duas linhas de trabalho.
A aprovação do valor 70 é uma decisão de ensino, não uma conclusão automática de Git. Num projeto real, compara a resolução com o requisito e repete testes sobre o conteúdo combinado. Testes dos pais não provam que a combinação funciona.
Force-with-lease verifica uma condição da referência; não integra automaticamente o trabalho remoto.
Reversão de código e recuperação de serviço
O laboratório publica depois um valor errado de 5. Git revert cria outro commit que volta a 70; o commit de 5 continua alcançável no histórico. Essa preservação permite explicar o erro e a correção sem substituir silenciosamente o passado.
Não confundas a reversão do ficheiro com recuperação operacional. Se o playbook já aplicou alterações, há efeitos remotos a avaliar, alguns potencialmente irreversíveis. O plano de retorno deve descrever dados afetados, compensação autorizada e verificação do serviço.
Um push bem-sucedido confirma publicação de código, sem demonstrar que um serviço voltou a responder. O exemplo não executou Ansible nem alterou servidores: os valores observados pertencem a ficheiros em repositórios locais fictícios.
Conteúdo seguido, ignore e exposição histórica
Um ficheiro chamado credentials.example.yml contém apenas DEMO_NOT_A_SECRET. Depois de ser seguido, acrescentá-lo a .gitignore não deixa de mostrar as suas edições. O exercício retira-o do índice com rm --cached e cria um commit: a cópia local permanece, o snapshot novo já não contém o caminho e o histórico antigo continua a devolver o exemplo.
A regra de ignore passa a atuar sobre o ficheiro agora não seguido. Este mecanismo não revoga uma credencial nem elimina cópias anteriores. Se o conteúdo fosse sensível, seria necessário tratar a exposição pelo processo aplicável.
Num clone novo, o exemplo removido não aparece, mas isso também não prova limpeza histórica. O laboratório nunca utiliza segredos reais.
Ensaio reproduzível e passagem a RUN
Duas execuções de Git 2.56.0 passaram 31 verificações cada, com 77 invocações por execução. O runner cria um destino novo, um remoto bare local e três clones; não acede a redes nem usa o repositório da aplicação. Conserva logs, hash do script, valores e identificadores dos commits.
O clone final mostra 70 em main e 90 ao selecionar a tag aprovada. Para a passagem a RUN, entrega o identificador da revisão, estado local de alterações, inventário de ficheiros usados e dependências do ambiente. Um clone coerente continua a precisar de collections, acesso aos nós e critérios funcionais.
Git diff --check ajuda com whitespace e marcadores de conflito, mas não valida semântica YAML, autorização remota ou resultado de Ansible. Repete o runner apenas num novo diretório de laboratório.
RESULTADOS DO LABORATÓRIO
HEAD=120; índice=90; working tree=60
Commit normal ->90; edição local continua 60
Fetch: origin/main=80; HEAD permanece 90
Conflito:80 vs 60; resolução fictícia=70
Erro publicado=5; revert produz novo commit com 70
Tag approved-90 mantém 90
Inspeções: git status --porcelain
git diff; git diff --cached
git show HEAD:group_vars.yml
git ls-files --unmergedO editor mostra a correção, mas o commit usado pelo pipeline ainda contém a versão preparada antes dela.
Armadilhas comuns
Ficheiro guardado como commit; lint como ensaio funcional; check sem alterações como prova completa.
Tópicos relacionados: Estado e repetibilidade · Inventários, variáveis e configuração · Acesso e ambiente de execução
Liga a revisão aprovada ao conteúdo efetivamente executado, mantendo a distinção entre integração Git e resultado operacional.
Referências
- Git add · Current primary reference inspected 2026-09-30
- git-diff reference · Current Git reference inspected 2026-10-08; actual lab Git 2.56.0
- git-restore reference · Current Git reference inspected 2026-10-08; actual lab Git 2.56.0
- git-fetch reference · Current Git reference inspected 2026-10-08; actual lab Git 2.56.0
- git-merge reference · Current Git reference inspected 2026-10-08; actual lab Git 2.56.0
- git-revert reference · Current Git reference inspected 2026-10-08; actual lab Git 2.56.0
- gitignore reference · Current Git reference inspected 2026-10-08; actual lab Git 2.56.0
- git-tag reference · Current Git reference inspected 2026-10-08; actual lab Git 2.56.0
- git-switch reference · Current Git reference inspected 2026-10-08; actual lab Git 2.56.0
- git-clone reference · Current Git reference inspected 2026-10-08; actual lab Git 2.56.0