Promover entre ambientes
Promover é subir num serviço a versão já construída e verificada de outro. Nada é reconstruído no caminho.
Por que não basta publicar o mesmo commit
Dois builds do mesmo código produzem imagens diferentes com frequência — bases que mudaram, dependências resolvidas noutro instante, timestamps embutidos.
Isso não é teoria. Em 2026-08-27 o mesmo commit da plataforma foi construído duas vezes, na mesma máquina, com minutos de diferença, e produziu dois artefatos distintos.
Se a promoção reconstruísse, o que foi testado e o que subiu seriam objetos diferentes — e a diferença apareceria exatamente quando ninguém pudesse pagar por ela.
A regra do Zero: construa uma vez, promova muitas.
Pelo console
- Abra Serviços e localize o serviço de origem — o que já tem a versão aprovada.
- Clique em Promover, ao lado do identificador da versão.
- Escolha o serviço de destino.
- Confirme.
A tela mostra qual versão vai subir e para onde, antes de qualquer coisa acontecer.
Pela linha de comando
# promove a versão ATIVA da origem
zero promote web-prod --from web-preview
# ou uma versão específica
zero promote web-prod --release rel_01K...
zero promote web-prod --artifact art_01K...
# as versões já construídas de um serviço, com o digest de cada uma
zero artifacts web-preview
--from resolve a versão ativa da origem, não a mais recente. A diferença aparece depois de um rollback: a mais recente é a que falhou; a ativa é a que está atendendo.
Pela API
A promoção é a mesma operação de publicação, com o artefato no lugar da origem:
POST /api/v1/services/{id}/deployments
Idempotency-Key: 4f7c...
{ "artifact_id": "art_01K..." }
source e artifact_id juntos são recusados com 422. Quem manda os dois quase sempre quer dizer "reconstrua a partir daqui e promova" — e são coisas diferentes.
O que a promoção leva, e o que não leva
| Vai junto | Fica no destino |
|---|---|
| A imagem exata, identificada pelo conteúdo | Variáveis de ambiente |
| O commit de origem, para rastreio | Secrets |
| Domínio e endereço | |
| Escala e recursos |
Configuração é do ambiente, nunca do artefato. É isso que permite a mesma imagem servir preview e produção com credenciais diferentes.
Quando a plataforma recusa
| Situação | Resposta |
|---|---|
| Artefato de outra organização | 404 — a mesma resposta de "não existe", para não permitir enumerar |
| Artefato de outro projeto | 409 — a fronteira da promoção é o projeto |
| Artefato ainda não verificado | 409 — a plataforma só promove o que conferiu |
| Você só tem permissão de leitura | 403 |
A fronteira ser o projeto é deliberada: entre serviços do mesmo projeto é exatamente o movimento que a promoção existe para fazer; entre projetos diferentes seria injetar a imagem de uma aplicação noutra.
Voltar atrás
Promover não apaga nada. A versão anterior do destino continua inteira, e voltar a ela também não reconstrói — é a troca de um ponteiro. Ver Restaurar uma versão.
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.