Agentes, MCP e projetos · Guia de ferramenta

Vercel: guia para perceber deploys, domínios e versões

Na Vercel, um deploy disponibiliza uma versão do teu projeto, enquanto o domínio dá às pessoas um endereço para a encontrar. O código guardado, o ambiente de teste e a versão pública podem estar em estados diferentes. Para perceberes o que está no ar, relaciona a revisão do código, o deployment e o endereço final.

Três versões de uma página, com uma destacada e ligada a um globo. Ilustração conceptual gerada com IA.
Ilustração gerada com IA para o Laboratório da IA.

O que significam versão, deploy e domínio na Vercel?

Uma versão identifica o estado do projeto que queres acompanhar. Um deploy resulta do processo de preparação e disponibilização desse projeto no alojamento. O domínio é o endereço que as pessoas usam para aceder. Estes elementos estão ligados, mas cada um responde a uma pergunta diferente sobre a publicação.

Quando pedes a um agente para alterar uma página, ele pode guardar os ficheiros no computador sem os enviar para lado nenhum. Se depois guardar uma revisão no Git, essa revisão ainda pode existir apenas localmente. Enviá-la para um repositório remoto é outra ação.

Na Vercel, o projeto passa por um processo de build para preparar a aplicação. O serviço cria um endereço associado ao deployment. A integração com Git é uma forma comum de iniciar esse processo, embora existam outras, como a linha de comandos. A documentação de deployments descreve estas possibilidades.

Usa esta tabela para organizar as perguntas:

ElementoPergunta que ajuda a responderEvidência a procurar
Ficheiros locaisO que foi editado?Alterações guardadas e resultado local
Revisão no GitQue conjunto de alterações foi registado?Identificador do commit e ficheiros incluídos
Repositório remotoEssa revisão foi enviada?Revisão presente na branch pretendida
DeploymentQue entrega foi preparada no alojamento?Identificador, origem e resultado do build
Domínio públicoO que recebe o visitante neste endereço?Destino configurado e comportamento observado

Esta separação é trabalhada na série de Claude Code do Laboratório. Ajuda-te a pedir uma entrega verificável e a localizar o ponto em que o trabalho ficou. “Está guardado” e “está disponível para os visitantes” descrevem estados diferentes.

Como acompanhas uma alteração do computador até ao site?

Acompanha uma alteração pequena e conserva a ligação entre a revisão escolhida e o deployment que a usa. Depois abre o endereço público e procura o comportamento esperado. O exercício fica mais claro quando defines antecipadamente uma mudança visível e uma função que deve continuar a funcionar exatamente como antes.

Vamos usar um exemplo fictício: o site Oficina Digital tem uma página de programa em example.com. A versão inicial apresenta três tópicos. A alteração acrescenta um quarto tópico e corrige a ligação para uma página interna. Não modifica inscrições, contactos ou outros serviços.

Para simplificar as notas do exercício, chamamos R1 à revisão inicial e R2 à revisão alterada. Chamamos D1 ao deployment inicial, D2 ao teste da alteração e D3 à entrega final. Estas etiquetas são inventadas para explicar o percurso. Num projeto real, registas os identificadores fornecidos pelas ferramentas.

Primeiro, R2 existe no computador e o domínio continua a mostrar D1. Depois, envias a alteração para uma branch de trabalho e verificas o deployment de teste D2. Nesta fase, o facto de veres quatro tópicos em D2 não demonstra que o domínio principal também os mostra.

Quando preparares a entrega de produção D3, confirma novamente a revisão de origem. O processo de integração das alterações pode gerar um novo commit. Por isso, compara a identificação efetiva e o conteúdo incluído, sem presumir que um nome de branch basta.

Por fim, abre example.com e testa os quatro tópicos e a ligação corrigida. O domínio mantém o mesmo nome ao longo do exercício. O que muda é a versão que serve esse endereço.

Qual é a diferença entre Preview e Production?

Preview permite avaliar uma alteração num endereço de teste antes de a usar na experiência pública. Production corresponde à versão destinada aos visitantes. Confirma o ambiente de cada deployment e o comportamento configurado no projeto, porque a origem do código e a atribuição dos domínios influenciam o que fica efetivamente disponível.

Depois da primeira publicação, a configuração habitual cria previews a partir de branches que não são a branch de produção. As alterações na branch de produção podem iniciar a entrega pública automaticamente. Essa atribuição automática pode ser configurada. Há ainda uma exceção relevante: o primeiro deployment de um projeto novo é de produção, mesmo quando parte de outra branch. Confere estas regras na documentação de ambientes da Vercel.

No exemplo Oficina Digital, queres que a revisão visual aconteça em D2 e que D1 continue a servir os visitantes enquanto a alteração está a ser avaliada. Antes de iniciar o percurso, confirma que essa separação corresponde à configuração real do projeto.

Testa a página num ecrã largo e num telemóvel. O quarto tópico deve aparecer completo, sem empurrar o botão para fora do ecrã. A ligação corrigida deve chegar ao destino previsto. Estes critérios são mais úteis do que pedir apenas “vê se está bom”.

O nome Preview também não substitui uma decisão sobre quem pode aceder ou que serviços são usados. Se a página tiver dados privados, confirma a proteção aplicável. Se tiver uma ação que envia mensagens, confirma o destino antes de a experimentar.

Ilustração conceptual gerada com IA: uma versão em teste e outra no domínio, separadas por uma lista de verificações.
Ilustração conceptual gerada com IA: uma versão em teste e outra no domínio, separadas por uma lista de verificações. Ilustração gerada com IA.

A imagem representa a revisão antes de mudar a versão pública. Não é uma captura da Vercel nem comprova a configuração de um projeto real.

Porque pode a mesma revisão funcionar de maneira diferente?

A revisão do código é apenas uma parte da execução. Configuração, dados e serviços externos também influenciam o resultado. Se um projeto funciona localmente e falha no alojamento, compara essas condições antes de concluir que a alteração está errada ou de pedir ao agente para reescrever a aplicação inteira.

As variáveis de ambiente guardam valores de configuração fora do código e podem ser aplicadas a ambientes diferentes. Na Vercel, alterar esses valores não atualiza deployments anteriores; a alteração aplica-se a novos deployments. A documentação de variáveis de ambiente explica o âmbito e este comportamento.

Imagina uma aplicação que usa um serviço externo para obter uma lista de sessões. O preview pode estar ligado a dados fictícios e a produção a dados reais. A página pode ter o mesmo código e mostrar conteúdos diferentes. O resultado do teste deve indicar qual das duas condições foi verificada.

Também pode acontecer o contrário: dois ambientes com nomes diferentes apontam para o mesmo serviço real. Nesse caso, um teste de escrita pode afetar os dados usados pelos visitantes. A separação precisa de existir nas ligações e nas permissões, para além dos nomes.

Ao investigar, regista a presença da configuração necessária e o ambiente a que pertence. Não coloques chaves, palavras-passe ou ligações autenticadas numa captura que vais partilhar. Para explicar a falha, normalmente basta indicar o nome da configuração em falta e o erro relevante, sem mostrar o valor secreto.

Um deployment também não congela o conteúdo de todos os sistemas que consulta. Uma base de dados pode mudar depois de o código ter sido publicado. Essa dependência torna-se especialmente importante quando pensas em recuperar uma versão anterior.

Como se relacionam o domínio, o DNS e o deployment?

O domínio precisa de estar associado ao projeto certo e de ter a configuração DNS necessária para chegar ao alojamento. Depois, o projeto determina a versão servida. Antes de alterar registos, identifica o serviço que já responde pelo site e conserva os restantes serviços do domínio, incluindo o email.

Na Vercel, a configuração do domínio fica no projeto, em Settings e Domains. O painel indica os registos necessários. Usa os valores apresentados para o teu projeto; não copies um endereço encontrado num tutorial antigo. O processo está descrito em adicionar e configurar um domínio.

A documentação distingue o domínio raiz, como example.com, de um subdomínio, como www.example.com. Também esclarece que alterar apenas os registos do site no fornecedor DNS atual não obriga a transferir toda a gestão do DNS. Mudar nameservers exige preservar os registos existentes, incluindo os do email.

No exercício Oficina Digital, decide qual o endereço principal e o que deve acontecer no outro. Podes escolher um deles como destino e encaminhar o alternativo. Confirma ambos no navegador, incluindo uma página interna, para perceberes se o caminho continua correto.

Depois de o domínio estar configurado, uma alteração normal de conteúdo não implica voltar a mudar o DNS. Se acrescentaste um tópico e continuas a ver três, começa por confirmar a versão servida. Alterar registos não é uma forma de selecionar o commit certo.

Se estás mesmo a preparar uma mudança de alojamento, usa o guia de preparação de um domínio. Inclui o inventário e a conferência dos serviços existentes, que merecem atenção própria antes de qualquer alteração.

O que verificas quando o domínio ainda mostra a versão antiga?

Começa por comparar três elementos: a revisão enviada, o deployment que terminou e o destino do domínio que estás a abrir. Esta sequência ajuda a separar uma alteração ainda local, um build falhado e uma versão que foi preparada apenas para teste. Investiga a cache depois de identificares estes estados.

No exemplo, vê primeiro se R2 foi enviada para a branch pretendida. Se só existe no computador, o site continuar com três tópicos é compatível com o trabalho ainda não ter chegado ao alojamento. Não há motivo para começar pelo DNS.

Se a revisão foi enviada, procura o deployment correspondente. Um registo na lista não basta: confere o resultado da preparação. Em caso de falha, os Build Logs mostram as etapas, avisos e erros do build. Estes registos referem-se à preparação e deixam de receber novas linhas quando ela termina, conforme a documentação dos logs de build.

Se o deployment está disponível, abre o endereço específico dessa entrega. Vês os quatro tópicos e a ligação correta? Então essa versão existe, mas ainda falta comparar com o domínio principal. Confirma se estás a olhar para um preview ou para a entrega efetivamente associada à produção.

Se o endereço específico e o domínio deveriam servir a mesma versão, recolhe o que observaste: URL, hora, texto visível e dispositivo. Uma janela privada ou outra rede pode ajudar a comparar resultados, mas não prova, sozinha, a origem do problema.

Evita mudar o código, o DNS e a configuração de cache na mesma tentativa. Se tudo mudar ao mesmo tempo, fica difícil perceber qual condição estava errada e se a correção introduziu outro problema.

O que recupera um rollback e o que fica por recuperar?

Um rollback permite voltar a servir uma entrega anterior elegível, mas precisas de avaliar os efeitos externos que já ocorreram. Recuperar a versão da página não recupera automaticamente dados alterados nem desfaz mensagens enviadas. Antes de reverter, identifica o problema, a versão pretendida e as dependências que essa versão vai encontrar.

O Instant Rollback da Vercel aponta os domínios para um deployment anterior elegível. A disponibilidade das versões depende do plano e das permissões. A operação recupera um build anterior; alterações recentes de variáveis no painel não são aplicadas retroativamente a esse build. A documentação de rollback explica estas condições.

Há outro efeito operacional a conferir: depois do rollback, a Vercel desativa a atribuição automática dos domínios de produção. Novos envios para a branch de produção não substituem automaticamente a versão recuperada. Para retomar o comportamento normal, é necessário seguir o processo de desfazer o rollback, promovendo outra entrega.

No nosso exemplo, imagina que D3 mostra o quarto tópico, mas a ligação corrigida afinal abre a página errada. Voltar a D1 pode recuperar o comportamento anterior, desde que confirmes a versão e o resultado no domínio. O tópico novo deixa de estar visível nessa recuperação.

Agora imagina que a alteração também tinha escrito dados num serviço externo. Essa escrita não é desfeita por escolher D1. Tens de analisar os dados separadamente, preservar o que aconteceu e decidir a recuperação adequada.

O mesmo cuidado se aplica ao repositório. Repor o site não significa que o código problemático deixou de estar na branch. O guia sobre recuperar uma versão com Git ajuda a tratar essa parte sem confundir histórico de código com estado do alojamento.

Que evidência deves pedir a quem publica o teu projeto?

Pede uma identificação da versão entregue, o endereço final e uma descrição dos testes realizados nesse endereço. Acrescenta as limitações relevantes e o ponto de recuperação. Esta informação permite que outra pessoa confirme a entrega e continue o trabalho sem ter de reconstruir toda a conversa com quem fez a alteração.

Para Oficina Digital, uma nota útil diria que a revisão correspondente ao quarto tópico está incluída em D3, que o domínio final foi aberto e que a ligação interna chegou à página pretendida. Juntaria a hora da conferência e os formatos de ecrã observados.

Se só foi testada a página do programa, a nota deve dizer isso. Não transforma esse teste numa garantia sobre formulários, área privada ou pagamentos que não fizeram parte da alteração. A cobertura precisa de acompanhar o que foi realmente observado.

Também deve ficar claro quem pode decidir a publicação. Ao trabalhar com um agente, podes autorizar a edição e o teste, ou autorizar também a disponibilização final. Se essa autorização já existe para o trabalho em curso, deve ser respeitada sem pedidos repetidos. O importante é o âmbito estar definido.

Para a próxima pessoa que pegar no projeto, guarda uma referência à entrega anterior e explica como confirmar que está a recuperar a versão certa. Uma captura ajuda a reconhecer o aspeto, mas não substitui o identificador do deployment nem os testes de funcionamento.

Se precisas de executar o percurso completo pela primeira vez, o guia de publicação de uma aplicação na Vercel desenvolve a preparação e a validação. Aqui, o objetivo é conseguires interpretar os estados e pedir evidência em cada um.

Como podes praticar sem alterar um site de trabalho?

Usa um projeto de exercício com conteúdo fictício e sem serviços reais ligados. Faz uma alteração visual pequena, acompanha a revisão e compara a entrega de teste com a versão pública desse projeto. No final, escreve o percurso com os identificadores reais e explica o que ainda não foi verificado.

Podes reproduzir a página com três tópicos e acrescentar o quarto. Antes de editar, guarda a referência inicial. Depois, regista separadamente o resultado local, a revisão enviada e o deployment preparado. Em cada ponto, escreve qual o endereço que estás a consultar.

Faz três perguntas de controlo. Primeiro: se o quarto tópico só aparece no computador, que etapa falta? Segundo: se aparece num preview mas não no domínio, que associação precisas de conferir? Terceiro: se o domínio mostra o tópico mas a ligação está errada, que teste revelou a falha?

As respostas esperadas são, respetivamente, verificar o envio e a publicação; verificar a entrega de produção e o destino do domínio; e corrigir o comportamento da ligação. Nenhuma dessas respostas exige concluir imediatamente que o DNS está errado.

Não precisas de provocar uma falha num site usado por clientes para aprender estes conceitos. O exercício pode terminar com uma nota de entrega, capturas sem dados privados e uma descrição do procedimento de recuperação. Se experimentares uma reversão no projeto de treino, confirma também como vais retomar as publicações seguintes.

Quando conseguires explicar qual a versão que cada endereço mostra, já tens uma base muito mais sólida para acompanhar o trabalho de um agente ou de uma equipa técnica.

Como podes aprender a publicar projetos no Laboratório da IA?

No Laboratório da IA, podes trabalhar a criação e a publicação de projetos com um processo que consigas acompanhar. As aulas semanais e os Zooms de acompanhamento semanais ajudam-te a ligar o que pedes ao agente ao resultado entregue, incluindo versões, testes e decisões sobre o que deve ficar disponível.

Este guia usa unidades revistas da primeira parte da série de Claude Code, com Roberto Cortez, Sara e perguntas dos participantes. O trabalho sobre preview e recuperação também aproveita princípios do workshop de Lovable com Jeferson e Sara. A documentação atual da Vercel sustenta os detalhes específicos da plataforma.

O exercício Oficina Digital é uma aplicação editorial desses princípios, não uma migração real nem uma demonstração retirada das contas dos formadores. Traz o teu projeto com o endereço, a alteração pretendida e a dúvida concreta sobre a publicação. Esse contexto permite trabalhar o próximo passo com mais precisão.

Aprofunda este percurso no LAB

Aprender Claude CodeAprender vibe coding
Passa à prática

Aprende a construir isto no Lab.

Trabalha o processo com aulas, materiais e acompanhamento. Leva o que estás a construir e esclarece as dúvidas da tua implementação.

  • Relacionar revisão de código, deployment e versão servida no domínio.
  • Distinguir teste, produção e recuperação, conferindo dados e configuração.
  • Desenvolver projetos nas aulas semanais e nos Zooms de acompanhamento semanais do Laboratório.

Aulas semanais para aprender e aplicar. Zooms de acompanhamento semanais para esclarecer dúvidas. Replay e materiais para retomar o trabalho ao teu ritmo.

Entrar no Laboratório da IA

Continua a aprender

Como preparar um domínio para publicar o teu projetoComo publicar uma aplicação na Vercel e confirmar que funcionaComo usar Git para recuperar uma versão do teu projeto
Laboratório da IA

Formação para empresas

Pede a demonstração para a tua empresa.

Deixa o teu contacto. A nossa equipa liga-te para perceber o contexto da tua empresa, mostrar a plataforma e apresentar as condições para o número de pessoas que queres formar.

O telemóvel serve para a nossa equipa te contactar e marcar a demonstração.

Os teus dados estão seguros connosco. Consulta a nossa Política de Privacidade.

Pedir uma demonstração é gratuito e não implica qualquer pagamento.