
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.
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.
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
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.
Erro comum
Revisar a URL de produção supondo que é a prévia da branch.
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.
Experimente
Que prévia você abriu e qual versão ela contém?
Converse com o tutor sobre sua resposta
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.
- 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.
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)
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.
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.
Erro comum
Tratar uma URL de branch como identificador imutável de versã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
Experimente
O que a mesma tarefa fez em cada versão e quais fronteiras de serviços de teste você verificou?
Converse com o tutor sobre sua resposta
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.
- 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.
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)
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.
Erro comum
Copiar todas as variáveis de produção para prévias sem considerar os efeitos.
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.
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 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.
Converse com o tutor sobre sua resposta
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.
- 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.
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: 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.
Erro comum
Integrar primeiro e chamar o resultado no ar de prévia.
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 desfazer uma implantação com falha do seu site
- Como fazer backup e restaurar os dados do seu site
- Como encontrar e corrigir erros no seu site no ar