LiçõesComo visualizar mudanças do site antes de publicar

Minilição 27 de 30 · Operar e manter seu site

Identifique as duas versões

Para quem é esta lição?

Para quem publica a partir de um repositório e quer examinar alterações antes do lançamento. Um assistente de programação e as ferramentas de repositório e hospedagem podem cuidar da mecânica das branches.

Uma revisão precisa tanto de um ponto de partida quanto de uma alteração proposta.

Objetivo desta lição

  • Crie uma versão separada para revisão.
  • Compare a prévia e o site atual com a mesma tarefa.
  • Vincule a aprovação à versão realmente revisada.
Explicação, exemplo resolvido e prática

Antes de começar

Seu próprio repositório GitHub separado conectado a um projeto Netlify de prática, com prévias de pull requests ativas. Compilações na nuvem usam créditos da conta. A oficina fornece arquivos anteriores e alterados; use um site descartável em vez de uma alteração real em produção.

Confira os conhecimentos iniciais

São habilidades úteis, não cursos obrigatórios bloqueados. Se já as domina, comece aqui; caso contrário, abra a preparação. Os arquivos fornecidos dispensam um site pessoal anterior.

  1. Como publicar seu site pelo GitHub

    Conecte um repositório de prática à hospedagem.

Tempo estimado: 20–32 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. Espera por compilações e configuração de conta são adicionais. Prévias públicas não devem conter dados privados de teste nem segredos de produção.

Entenda a ideia

Use a página inicial fornecida para publicar P1 no seu projeto separado de prática. Com o assistente, compare com a mudança fornecida: P1 diz “Find contact information”, P2 diz “Contact me”. As duas devem chegar à mesma seção Contact.

Guarde o endereço P1 publicado como base. A proposta P2 pertence a um branch de revisão ainda não mesclado e sua prévia separada; registre os marcadores visíveis para saber qual página está testando.

Um exemplo concreto

É uma pequena mudança de texto, não um sistema novo de contato. O rótulo proposto deve ficar mais claro enquanto o destino existente continua funcionando.

Use a alteração fornecida do site de prática. Ajude a criar uma branch e um pull request separados de revisão com prévia Netlify, deixando inalterada a versão de prática publicada atual. Mostre as duas URLs e identifique a versão em revisão. Não faça merge nem publique em produção sem minha aprovação. Ajude a testar a tarefa alterada e registrar problemas não resolvidos.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Que alteração você revisará e como reconhecerá as versões atual e proposta?

Mostrar uma solução comentada

Vou comparar “Find contact information” de P1 com “Contact me” de P2. Ambos devem chegar a Contact. Manterei P1 publicado como base e reconhecerei a prévia não mesclada pelo marcador P2; registrarei as duas URLs.

O que uma boa resposta inclui

  • Identifica a mudança exata no rótulo de contato e o que deve continuar igual.
  • Distingue o P1 publicado do P2 proposto na prévia.
Como funciona (opcional)

Visualize uma mudança antes de publicar

Dê à versão proposta sua própria URL de revisão enquanto a produção continua funcionando.

Uma prévia permite testar o resultado realmente compilado da branch antes de integrá-la à fonte de produção. Um arquivo local que parece bom ainda pode ter caminhos de compilação ou configurações de ambiente errados.

Esta oficina usa uma mudança pequena de propósito: P1 diz “Find contact information” (encontrar informações de contato); P2 diz “Contact me” (entre em contato). Você identificará as versões e verificará a mesma tarefa de contato antes de decidir integrar.

Exemplo resolvido

Enquanto o pull request não for integrado, a prévia deve mostrar P2 e o site público normal deve continuar em P1. Se ambos mudaram, investigue qual branch implanta em produção.

Exercício técnico complementar

Por que o registro de revisão deve incluir as versões da prévia e de produção?

Mostrar uma solução comentada

Ele estabelece que a prévia contém a proposta enquanto o site público mantém a versão aprovada. Uma prévia funcional sozinha não prova essa separação.

  • Prova qual versão está sendo revisada.
  • Confirma que a produção não mudou acidentalmente.

Etapa 1 · Como visualizar mudanças do site antes de publicar

Crie uma prévia de revisão

Deixe o assistente orientar as etapas do repositório.

Explicação, exemplo resolvido e prática

Entenda a ideia

Use o repositório exclusivo de prática e ative as prévias de pull request na hospedagem. Peça ao assistente para criar um branch com P2, enviá-lo e abrir um pull request sem mesclar. Esses builds hospedados podem consumir créditos da conta.

Abra a prévia resultante e leia P2. Salve a URL com o commit exato revisado no repositório ou na hospedagem. Um commit posterior no mesmo branch é outra versão para inspecionar.

Um exemplo concreto

Um branch chamado improve-contact-label pode conter commits diferentes ao longo do tempo. Aprovar sua primeira prévia não cobre automaticamente o próximo commit.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Que prévia você abriu e qual versão ela contém?

Mostrar uma solução comentada

Um registro ilustrativo identifica a URL gerada pela hospedagem, P2 e o commit exato copiado do pull request. Confirmaria que “Contact me” está lá. Se vir P1 ou não encontrar build de prévia, ela ainda não passou nessa verificação.

O que uma boa resposta inclui

  • Relaciona a URL real da prévia ao marcador P2 e à revisão exata do código.
  • Não trata o nome do branch, sozinho, como versão revisada.
Como funciona (opcional)

Abra uma revisão de branch com uma mudança reproduzível

Conecte um pull request a uma revisão específica da fonte.

Siga commands.txt apenas no seu repositório descartável. Registre P2 em uma branch e abra um pull request sem integrá-lo. Deploy Preview do Netlify deve ligar uma URL compilada a esse pedido e revisão.

Leia os detalhes de implantação em vez de deduzir o sucesso pelo navegador. Registre o commit e confira a pasta de publicação. Se não houver prévia, examine configurações e logs; não compense publicando a branch em produção.

Antes de executar os comandos da branch, abra a URL pública P1 existente, clique no link de contato e registre o commit P1 que funciona em review-record.csv. Se não houver uma implantação P1 funcional, conclua primeiro esse ponto de partida. Na tarefa, preencha as duas linhas: ambiente verificado (produção ou prévia), URL, commit, versão visível, resultado da ação de contato e qualquer efeito inesperado.

Se a branch de produção mudar durante o trabalho, examine o estado de atualização e conflitos do pull request antes de continuar. Busque o estado atual e resolva conflitos deliberadamente na sua branch; peça ajuda se tiver dúvida em vez de sobrescrever trabalho sem relação. Depois de resolver, revise novamente a nova prévia.

Se a URL da prévia faltar, confira se Deploy Previews está ativado para pull requests, se a branch não está excluída, se a compilação passa e se netlify.toml aponta para a pasta pública pretendida. Em Deploys do provedor, abra a implantação atual de produção para encontrar seu commit real.

Exemplo resolvido

Uma verificação verde de commit e uma prévia legível devem apontar para a mesma revisão. Editar depois cria outra revisão que precisa de nova análise.

Netlify: Deploy Previews

Exercício técnico complementar

Você revisou A e depois enviou B à mesma branch. B está coberto pela aprovação antiga?

Mostrar uma solução comentada

Não. O nome da branch ficou igual, mas o conteúdo mudou. Verifique a prévia compilada de B e revise as diferenças.

  • Vincula a revisão a um commit específico.
  • Testa a prévia alterada novamente antes da promoção.

Etapa 2 · Como visualizar mudanças do site antes de publicar

Repita a tarefa do visitante com segurança

Um hostname diferente não torna serviços reais inofensivos.

Explicação, exemplo resolvido e prática

Entenda a ideia

Abra P1 e a prévia P2 sem login e em uma largura estreita. Acione o contato nas duas e confira que a seção continua acessível. Neste exemplo estático, pare no destino de contato; não envie e-mail ao endereço de exemplo.

Se aplicar essa técnica depois a formulários, pagamentos ou dados, confira primeiro as configurações dos serviços da prévia. Um novo nome de host ainda pode chamar um serviço real; use contas e dados de teste separados para esses efeitos.

Um exemplo concreto

No exemplo, P1 e P2 chegam a Contact; P2 muda apenas o rótulo do link e a versão. Nenhuma precisa enviar e-mail ou gravar no banco.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

O que a mesma tarefa fez em cada versão e quais fronteiras de serviços de teste você verificou?

Mostrar uma solução comentada

Comparação ilustrativa: “Find contact information” de P1 e “Contact me” de P2 chegam a Contact em largura estreita e sem login. A alteração não tem envio de e-mail, pagamento ou ação de banco; não acionei o endereço de exemplo.

O que uma boa resposta inclui

  • Executa a mesma tarefa de contato nas duas versões e compara o resultado.
  • Verifica uso estreito/sem login e distingue essa ação estática de efeitos externos reais.
Como funciona (opcional)

Separe os dados e efeitos da prévia

Uma URL diferente não isola automaticamente o backend.

Nosso exemplo estático de contato não tem efeitos no backend. Em uma aplicação real, revise separadamente as variáveis de contexto da prévia: banco, destinatário de e-mail, modo de pagamento e credenciais ainda podem apontar para produção.

Use dados descartáveis e ambientes de teste dos provedores quando necessário. Uma prévia protegida de olhares casuais ainda pode executar uma função com as credenciais configuradas.

Por exemplo, se a função lê SUPABASE_URL, mantenha esse nome, mas configure o valor do contexto Deploy Preview para o projeto de banco descartável. Não invente um nome que o código nunca lê. Revise também cada segredo, destinatário e modo de pagamento; copiar o valor de produção elimina o isolamento.

No painel Netlify, abra as variáveis de ambiente e edite o valor do contexto Deploy Preview independentemente de Production. Salve apenas um valor de serviço de teste nesse contexto, inicie nova compilação e verifique a revisão; mudar o painel não prova que uma função implantada antes recebeu o valor. Veja o guia oficial de contextos abaixo.

Exemplo resolvido

Um formulário de prévia ligado ao provedor de e-mail de produção pode enviar mensagens reais. A palavra “preview” na URL não impede a chamada.

Netlify: variáveis de ambiente e contextos de implantação · Netlify: variáveis por contexto de implantação

Exercício técnico complementar

Um host exclusivo de prévia basta para garantir que compras de teste não cobrem dinheiro real?

Mostrar uma solução comentada

Não. Configure credenciais de teste e serviços isolados e verifique o comportamento real. Separar o host sozinho não basta.

  • Verifica credenciais, modo de pagamento e destinos dos dados.
  • Não confunde separação de URLs com isolamento do backend.

Etapa 3 · Como visualizar mudanças do site antes de publicar

Tome uma decisão de revisão específica da versão

A aprovação acompanha o resultado que você realmente examinou.

Explicação, exemplo resolvido e prática

Entenda a ideia

Preencha review-record.csv com URLs, versão revisada, observações e problemas restantes. Peça qualquer correção delimitada e examine novamente a prévia resultante.

Deixe o site atual inalterado até uma decisão explícita de lançamento. Se a versão mudar após a revisão, identifique o que precisa de novos testes.

Um exemplo concreto

Uma revisão útil é específica: “O rótulo revisado de P2 chega à mesma seção em 390px e desktop; a versão publicada continua P1.” Ela identifica a revisão testada e não mescla o pull request.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Apresente a comparação entre prévia e página atual com sua aprovação ou o problema restante.

O que entregar: As URLs da prévia e atual e um registro real de comparação da versão revisada.

Mostrar uma solução comentada

Decisão ilustrativa: “Contact me” de P2 é mais claro e chega à mesma seção de P1 em 390px e desktop. Aprovo essa revisão exata registrada para uma decisão posterior de publicação; o exercício mantém o pull request sem mesclar e P1 publicado. Qualquer commit novo precisa de outra revisão.

O que uma boa resposta inclui

  • Vincula a comparação e a decisão de revisão à revisão exata da prévia.
  • Mantém P1 publicado sem alteração e lista problemas que exigem nova revisão de prévia.
Como funciona (opcional)

Sua tarefa: entregar uma mudança que possa ser revisada

Mantenha a revisão pequena e apoie-a em resultados observáveis.

Crie mais uma melhoria de texto ou layout na branch. Confira abertura direta, largura móvel e contato na prévia. Compare com produção.

Forneça uma descrição curta com URL da prévia, revisão e observações. Integre apenas depois de a pessoa revisora aprovar a versão real; este exercício não exige promoção para produção.

Para a verificação estreita, use as ferramentas do navegador em 390px e depois largura de computador. Registre largura real e resultado do contato em review-record.csv; esta tarefa deixa a branch sem integrar.

Exemplo resolvido

“Mudei o texto do contato; o link ainda chega a #contact em 390px e no computador” é mais útil que “ficou melhor”.

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.

Exercício técnico complementar

Produza uma prévia de branch e um registro comparativo completo sem mudar produção.

Mostrar uma solução comentada

Confirme que P1 já funciona na URL pública de prática e registre o commit. Na branch de revisão, mude o marcador para P2 e o contato para 'Contact me', registre e envie a branch na sua conta e abra um pull request sem integrar.

Registre as duas linhas em review-record.csv: URL/commit/P1 de produção/contato funciona; URL/novo commit/P2 da prévia/contato funciona. Abra ambas desconectado e em largura estreita. Se houver efeitos, o backend da prévia deve apontar para serviços isolados de teste. Repita em 390px e no computador; use linhas CSV separadas e registre cada largura real.

Depois de outro commit, confira a nova revisão de prévia. A descrição de referência mostra as informações necessárias à revisão; mantenha a branch sem integrar e não promova produção nesta tarefa.

  • A produção continua na revisão aprovada durante a análise.
  • A revisão exata da prévia passa na tarefa do visitante indicada.

Esta lição foi útil?

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