
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.
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.
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
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.
Erro comum
Escolher uma implantação antiga aleatória porque sua data parece conveniente.
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
Experimente
Qual versão a hospedagem restaurou e o que o endereço público mostrou depois?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Resultado ilustrativo: Selecionei R1 salvo no projeto descartável; a URL agora mostra Version R1 e “Find contact information” chega a Contact. Se ainda mostrasse R2, a recuperação continuaria pendente, independentemente do selo da hospedagem.
- Identifica o artefato R1 selecionado e confirma o alvo descartável.
- Verifica R1 público e a ação de contato antes quebrada após restaurar.
Arquivos desta etapa
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.
Erro comum
Encerrar o incidente assim que o botão de reversão funciona.
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.
Experimente
O que fez a tarefa do visitante voltar a funcionar e o que impede o retorno da versão com defeito?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Republicar R1 restaurou Contact. Para prevenir recorrência, pediria ao assistente que trocasse #contact-missing de volta por #contact, revisaria essa alteração pequena e sua próxima prévia antes de publicar. O rollback da hospedagem não corrige essa fonte sozinho.
- Separa restauração imediata na hospedagem de correção da fonte quebrada no repositório.
- Explica como a próxima publicação evitará reintroduzir a falha de contato R2.
Arquivos desta etapa
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.
Erro comum
Supor que a reversão de uma implantação também reescreve o histórico Git e o estado externo.
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.
Experimente
Materiais para começar
Os arquivos e conteúdos de teste estão incluídos. A verificação real exige sua própria conta, caixa de entrada ou domínio conforme os pré-requisitos. É possível inspecionar localmente; marque etapas reais não executadas como não testadas.
Apresente o registro de recuperação e a verificação real da tarefa restaurada.
O que entregar Um registro de recuperação com a versão restaurada, o resultado real da tarefa e a etapa de prevenção.
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Registro ilustrativo: R2 aparecia normalmente, mas seu destino Contact não existia. Restaurei R1 registrado na hospedagem descartável e a tarefa pública voltou a funcionar. O alvo no repositório ainda precisava de correção e revisão da prévia antes de publicar. Nenhuma recuperação de banco, e-mail ou pagamento fez parte do ensaio estático.
- Relaciona R2 com falha, artefato R1 restaurado e novo teste público real da tarefa.
- Inclui prevenção e distingue rollback de código de dados ou efeitos externos.
Arquivos desta etapa
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.
Erro comum
Escrever instruções de recuperação só depois de esquecer qual implantação resolveu o problema.
Esta lição foi útil?
Deixe uma curtida ou compartilhe com alguém que possa aproveitar.
Continue aprendendo
- Como criar seu primeiro site pessoal
- Como publicar seu site pelo GitHub
- Como conectar um domínio próprio ao seu site
- Como configurar e-mail no seu próprio domínio
- Como tornar seu site utilizável em celulares
- Como acelerar o carregamento das imagens do seu site
- Como receber os comentários do seu site na sua caixa de entrada
- Como adicionar assinaturas por e-mail ao seu site
- Como enviar e-mails automáticos pelo seu site
- Como salvar envios de formulário em um banco de dados
- Como permitir que as pessoas entrem no seu site
- Como manter uma página privada
- Como permitir que usuários editem as informações do perfil
- Como permitir que usuários enviem imagens
- Como manter chaves de API fora do frontend
- Como mostrar dados de uma API externa no seu site
- Como adicionar um chatbot de IA ao seu site
- Como fazer um chatbot responder com base no seu conteúdo
- Como adicionar um blog ao seu site
- Como adicionar busca ao seu site
- Como adicionar outro idioma ao seu site
- Como ajudar o Google a encontrar seu site
- Como corrigir a prévia do seu site ao compartilhar um link
- Como medir visitas e ações úteis no seu site
- Como permitir que visitantes agendem um horário
- Como aceitar um pagamento no seu site
- Como visualizar mudanças do site antes de publicar
- Como fazer backup e restaurar os dados do seu site
- Como encontrar e corrigir erros no seu site no ar