Minilição · Português

Como desfazer uma implantação com falha do seu site

Ensaie a restauração de uma versão comprovadamente funcional num site descartável e depois verifique se a ação do visitante realmente funciona novamente.

Começar a aula interativaLer as notas da aula

Para quem é esta lição?

Para quem quer uma forma tranquila de recuperar uma publicação com defeito. Você pode usar os controles de versões da hospedagem e um assistente de programação; scripts de implantação são opcionais.

Antes de começar

Você precisa de um projeto novo e descartável de hospedagem e das páginas fornecidas, funcional e quebrada. Primeiro publicará R1 funcionando e depois R2 quebrada de propósito somente nesse site. Um assistente pode orientar; não use um serviço real com usuários nesse ensaio.

Tempo estimado: 19–31 min

Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. Os controles de hospedagem variam. Reverter código estático não desfaz mudanças no banco, e-mails enviados, pagamentos nem exposição de segredos.

O que você vai aprender

  • Escolha uma versão comprovadamente funcional.
  • Restaure-a pelas ferramentas de hospedagem.
  • Verifique a tarefa do visitante e impeça uma repetição imediata.

Arquivos da oficina

Etapa 1

Escolha a versão funcional conhecida

Uma versão anterior só é útil se cumpria a tarefa pretendida.

Peça ao assistente para publicar working/public como R1 em um novo site descartável. Abra a URL pública, leia R1 e acione “Find contact information”. Guarde o identificador da publicação ou revisão cujo link chega a Contact.

Somente no mesmo site descartável, publique broken/public como R2. Repita: R2 aponta para um destino ausente. Guarde sua identificação ao lado da R1 comprovadamente funcional. Agora existe uma falha real de prática e um candidato específico à restauração.

Um exemplo concreto

O link R1 aponta para #contact, que existe. R2 aponta para #contact-missing. Não é a data antiga que torna R1 adequada; a tarefa Contact funciona nela.

Use somente meu projeto novo e descartável. Publique working/public como R1 e ajude a conferir o contato e salvar seu identificador. Depois que eu confirmar o alvo, publique broken/public como R2 só ali e reproduza a falha. Ajude então a restaurar o artefato R1 identificado, repetir a ação e impedir que a fonte R2 quebrada seja publicada imediatamente de novo. Não toque em outro site, dados reais ou serviço de produção.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Desfaça uma implantação com falha sem adivinhar

Restaure a versão que realmente passou na tarefa do visitante afetada.

A recuperação começa pela falha do usuário, não por um desejo vago de voltar a uma data antiga. A oficina quebra uma âncora de contato em R2, enquanto R1 contém o destino correto.

Uma hospedagem pode permitir republicar rapidamente uma implantação anterior já compilada. Isso restaura o artefato de código, enquanto a branch Git pode continuar com a fonte defeituosa. Trate a recuperação imediata e a correção permanente como ações separadas.

Exemplo resolvido

A página de R2 pode carregar com status 200 enquanto a ação de contato falha. Uma verificação de saúde que só abre a página inicial não detectaria o incidente.

Extra implementation exercise

Que evidência torna R1 uma candidata adequada para reversão?

Mostrar uma solução comentada

Ela é a implantação conhecida cuja tarefa de contato funciona, com um artefato ou revisão identificado. Ser “mais antiga” não prova que uma versão seja adequada.

  • Verifica em R1 a tarefa específica que falhou.
  • Identifica a revisão exata implantada.

Etapa 2

Restaure na hospedagem de prática

Use o controle do site descartável pretendido.

Confirme com o assistente o nome do projeto descartável e o marcador R2. No histórico da hospedagem, selecione o artefato R1 salvo e use a restauração ou republicação suportada. Isso muda o site de prática, não o histórico do código no repositório.

Quando a hospedagem terminar, abra novamente a URL pública real. Confira R1 e repita “Find contact information”; um selo de sucesso não informa se o navegador está testando o site correto.

Um exemplo concreto

Se a hospedagem informa R1, mas o endereço mostra R2, compare projeto, URL e artefato publicado antes de declarar a recuperação concluída.

Netlify: gerenciar implantações e reversões

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Ensaie a reversão em um projeto descartável

Use o histórico de implantações para publicar o artefato comprovadamente funcional.

Siga START-HERE.txt apenas na hospedagem de prática. Registre R1, publique a falha intencional de R2 e reproduza a tarefa de contato quebrada. Depois localize R1 no histórico e use a ação de publicação ou reversão da hospedagem.

Examine a URL pública resultante e o marcador de versão depois que a ação terminar. Interfaces e permissões de hospedagem variam; consulte o guia atual em vez de confiar na posição antiga de um botão.

Exemplo resolvido

A página pública agora deve mostrar R1 e o link de contato deve chegar à seção real de contato. A ação do painel, por si só, não conclui a verificação de recuperação.

Netlify: gerenciar implantações e reversões

Extra implementation exercise

O painel diz que a implantação anterior foi publicada. O que você deve verificar em seguida?

Mostrar uma solução comentada

Confirme o artefato e a versão públicos e repita a ação de contato. Registre o resultado em vez de supor que uma ação administrativa bem-sucedida prova a recuperação para o usuário.

  • Abre a URL pública e a versão reais.
  • Repete a tarefa que estava falhando.

Etapa 3

Impeça que a mesma falha volte

Recuperar e corrigir a próxima publicação são trabalhos separados.

Repita Contact em R1 restaurada. Depois peça ao assistente para conferir a cópia no repositório: o link R2 quebrado pode continuar ali, embora a hospedagem sirva o artefato antigo funcional.

Peça ao assistente para corrigir o destino no repositório e revise a pequena mudança antes de outra publicação. Controle a publicação automática da fonte ainda quebrada pelo fluxo disponível na hospedagem; restaurar um artefato não reescreve o Git.

Um exemplo concreto

A correção permanente faz o destino corresponder novamente à seção Contact existente. É outra mudança de código, diferente de republicar o artefato R1 já construído.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Corrija o código-fonte e avalie os efeitos restantes

Impeça que a próxima compilação automática restaure o mesmo bug.

A branch de produção ainda pode conter o código R2. Corrija-o em uma alteração de fonte revisada e controle a publicação automática durante a recuperação conforme a hospedagem permitir. Caso contrário, a próxima implantação pode reintroduzir a falha.

Reverter código não recupera registros excluídos nem desfaz mensagens ou cobranças. Uma mudança de esquema também pode tornar o código antigo incompatível. Investigue esses efeitos separadamente antes de reverter uma aplicação real que mantém estado.

Imagine que R2 remove uma coluna de banco que R1 ainda lê. Republicar o código antigo de R1 não recria a coluna, então a reversão ainda pode falhar. Verifique primeiro a compatibilidade de estado e esquema. Neste exercício estático, a correção é menor: mude href='#contact-missing' de volta para href='#contact', revise as diferenças e verifique a branch corrigida antes de futuras publicações automáticas.

O exemplo de banco explica um limite da reversão em uma aplicação com estado; a oficina em si só altera arquivos estáticos e não pede ações no banco. Se estiver aprendendo sozinho, execute o procedimento em uma nova janela do navegador e leia como instruções para alguém que não escreveu a alteração.

Exemplo resolvido

Restaurar uma página antiga de formulário não consegue recolher e-mails já entregues pela versão nova. Se credenciais vazaram, a reversão sozinha também não as revoga.

Extra implementation exercise

Uma reversão restaura a página, mas o commit com defeito continua na branch de produção. Que risco permanece?

Mostrar uma solução comentada

Uma compilação posterior pode publicar o bug novamente. Corrija ou reverta a fonte pelo processo normal de revisão e verifique a versão resultante antes de restabelecer a implantação sem supervisão.

  • Antecipa uma reimplantação automática da fonte com defeito.
  • Planeja a correção do código-fonte e sua verificação.

Etapa 4

Escreva a entrega da recuperação

Facilite entender o próximo incidente.

Complete recovery-record.txt com a tarefa R2 que falhou, o identificador R1 salvo, a restauração e o novo teste público de Contact. Acrescente a correção no repositório ou o próximo passo exato ainda necessário.

Esse ensaio restaura código estático do site. Não desfaz alterações de banco, e-mails enviados, cobranças ou chaves expostas; cada um precisaria de sua própria ação em um incidente real.

Um exemplo concreto

Uma história curta de recuperação é: destino R2 ausente → R1 funcional republicada → Contact público R1 funcionou → fonte corrigida e revisada antes da próxima versão.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Sua tarefa: escrever e demonstrar um procedimento curto de recuperação

Torne a próxima recuperação executável por alguém que não escreveu a alteração.

Preencha o registro com os identificadores exatos da implantação e da fonte, a tarefa que falhou, a ação de reversão e a verificação visível para o usuário. Inclua a correção da fonte e qualquer estado fora do escopo da reversão.

Peça a outra pessoa que siga as etapas escritas no site descartável ou percorra-as em um navegador novo. Remova suposições como “clique na antiga”, que só fazem sentido para você.

Exemplo resolvido

Um procedimento útil informa qual versão escolher e como reconhecer uma recuperação bem-sucedida. Uma lista de cliques no painel sem verificar a tarefa é frágil.

O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.

Extra implementation exercise

Produza um registro de recuperação que restaure a tarefa de teste e evite recorrência imediata.

Mostrar uma solução comentada

No site descartável, reproduza a falha de contato de R2 e registre o ID da implantação e o commit. No histórico, localize o registro R1 comprovadamente funcional, examine o artefato e a revisão e escolha o controle de publicação ou reversão do provedor para esse registro.

Abra a URL pública real, leia R1 e repita a ação de contato. Depois corrija a fonte restaurando href='#contact'; revise e registre essa alteração em um commit antes de permitir outra publicação automática.

Separe a restauração de código da recuperação de dados. Se uma versão mais nova removeu uma coluna necessária ao código antigo, republicar HTML/JS antigos não a recria. O registro de incidente de referência identifica a tarefa recuperada, a correção da fonte e o estado fora do escopo da reversão.

  • A versão restaurada passa na mesma tarefa que falhou.
  • A correção da fonte e os efeitos externos ao código são explicitamente tratados.

Esta lição foi útil?

Deixe uma curtida ou compartilhe com alguém que possa aproveitar.

Continue aprendendo

Explore as outras lições