Minilição · Português

Como visualizar mudanças do site antes de publicar

Prepare uma pequena alteração de site com um assistente, revise seu endereço separado de prévia e mantenha a produção intacta até a aprovação.

Começar a aula interativaLer as notas da aula

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.

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.

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.

O que você vai aprender

  • 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.

Arquivos da oficina

Etapa 1

Identifique as duas versões

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

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

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)

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.

Extra implementation exercise

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 2

Crie uma prévia de revisão

Deixe o assistente orientar as etapas do repositório.

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.

Netlify: Deploy Previews

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)

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

Extra implementation exercise

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 3

Repita a tarefa do visitante com segurança

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

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.

Netlify: variáveis de ambiente e contextos de implantação · Netlify: variáveis por contexto de implantaçã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)

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

Extra implementation exercise

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 4

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

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

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

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: 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.

Extra implementation exercise

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.

Continue aprendendo

Explore as outras lições