Em projetos VTEX IO, publicar um novo recurso em produção vai muito além de subir código. Em muitos cenários, é preciso garantir que a feature já esteja configurada e cadastrada antes de ficar disponível para os usuários. É exatamente aqui que entra o deploy com Promote.
Neste post, você vai entender:
-
o que é o Promote na VTEX;
-
qual a diferença entre deploy normal e deploy com Promote;
-
quando usar esse processo;
-
quais cuidados devem ser tomados;
-
como promover uma workspace para Master.
O que é o deploy com Promote na VTEX
Promover uma workspace para Master é a etapa final para disponibilizar publicamente uma nova versão de um app.
Quando você executa o Promote:
👉 a workspace de produção substitui a Master
👉 a nova versão passa a atender os usuários finais
👉 não é possível alterar código diretamente após a promoção
Depois do Promote, qualquer nova alteração deve ser desenvolvida em outra workspace, testada e promovida novamente.
Em termos simples: Promote = tornar a workspace atual a nova produção.
(Campo opcional) Editar Subtítulo
(Campo opcional) Editar descrição principal da seção do subtítulo, se não tiver, remover esse bloco.
Por que o Promote é tão importante
Na VTEX, muitas funcionalidades dependem de cadastros via Site Editor. Exemplo:
- Menu
- Banners
- Configurações de apps
Se fizermos um deploy tradicional, o fluxo costuma ser:
-
Dev sobe a feature para produção
-
Cliente acessa o Site Editor
-
Começa a cadastrar tudo manualmente
O problema?
Esse cadastro pode levar muito tempo — e durante esse período a loja fica incompleta.
Imagine subir um novo menu vazio e levar 1 hora para preencher tudo. Durante esse tempo, a loja pode ficar sem navegação adequada.
É aqui que o Promote resolve o problema.
Quando usar o deploy com Promote
O Promote deve ser usado quando a nova feature precisa já entrar em produção configurada.
Exemplos comuns:
- Novo menu da loja
- Landing pages de campanha
- Alterações grandes de cadastros
- Mudanças estruturais no tema
- Configurações de apps que exigem cadastro
Nesse fluxo, o cadastro acontece antes da publicação, não depois.
Implantação normal vs. Implantação com Promover
Implantação tradicional
-
Desenvolver a feature
-
Publicar em produção
-
Cliente cadastra conteúdo depois
Consequência:
-
a feature sobe sem configuração
-
existe janela de inconsistência na loja
Implantação com Promote
-
Criar uma workspace de produção
-
Instalar a nova feature nessa workspace
-
Cliente realiza todos os cadastros nela
-
Validar tudo com tráfego real
-
Promover a workspace para Master
Resultado:
- a feature sobe já configurada
- cadastros não são perdidos
- não existe janela de inconsistência
Basicamente, o Promote pega a workspace pronta e transforma ela na nova produção.
Como o Promote preserva os cadastros
Aqui está a diferença mais importante:
-
Deploy normal → perde cadastros feitos na workspace
-
Deploy com Promote → leva os cadastros para produção
Isso acontece porque o Promote substitui a Master inteira pela workspace promovida.
Ou seja: tudo que estava nela sobe junto.
Código + configurações + cadastros.
Cuidados essenciais antes de fazer Promote
Como a workspace substitui a Master, alguns cuidados são fundamentais.
1) Workspace precisa estar atualizada
Antes do Promote, confirme que a workspace contém:
-
todas as features aprovadas
-
todos os ajustes finais
-
todas as validações concluídas
Nada deve ficar “faltando”.
2) Pausar cadastros em produção
Após criar a workspace de produção:
🚫 Evite cadastrar direto na Master.
Se alguém fizer cadastros em produção durante esse período, eles serão perdidos.
Por quê?
Porque a Master será substituída pela workspace promovida.
3) Onde fazer cadastros durante o período de Promote
Se surgirem novas demandas de cadastro:
👉 faça na workspace de produção
Assim, tudo sobe junto quando o Promote for realizado.
4) E se não for possível pausar cadastros?
Cenário comum: campanhas ou urgências.
Nesse caso, a orientação é:
-
cadastrar na Master (para não impactar a loja)
-
repetir o cadastro na workspace
Isso garante que nada será perdido após o Promote.
Resumo das orientações
Quando existir uma workspace preparada para Promote:
-
Pare cadastros na Master sempre que possível
-
Faça novos cadastros na workspace de produção
-
Se for urgente, cadastre nos dois ambientes
-
Avise todos os times sobre o período de Promote
Comunicação é essencial para evitar perda de dados.
Como promover uma workspace para Master (passo a passo)
No terminal, execute:
1) Fazer login na conta VTEX
vtex login {accountName}
2) Acessar a workspace de produção
vtex use {workspaceName}
3) Promover a workspace para a master
vtex workspace promote
Após esse comando, a workspace se torna a nova Master.
Conclusão
O deploy com Promote é a forma mais segura de publicar funcionalidades que dependem de cadastro prévio.
Ele permite:
-
subir features já configuradas
-
evitar janelas de inconsistência
-
reduzir riscos operacionais
-
alinhar desenvolvimento, negócio e conteúdo
Mais do que um comando, o Promote é um processo de publicação colaborativo entre devs, POs, QAs e clientes.
Quando bem utilizado, ele garante que a loja evolua sem impactar a experiência do usuário.
Quer se aprofundar em Front-end e VTEX IO?
Na DFreedom, trabalhamos com uma formação prática e orientada ao mercado. Por isso, nosso foco está no desenvolvimento web e no ecossistema da VTEX. Assim, atendemos desde quem está começando até profissionais em nível avançado.
