Publicar
Publicar é o ato de colocar uma nova versão da aplicação no ar. A plataforma busca o código, constrói a imagem e ativa a nova versão — a anterior continua atendendo até a nova responder.
Antes de começar
- O projeto precisa ter uma origem: o repositório de onde todos os serviços dele publicam. Ela é informada na criação do projeto e pode ser alterada em Origem.
- O
Dockerfileprecisa existir na pasta publicada. Ver Como a imagem é construída. - A aplicação precisa escutar em
0.0.0.0, na porta da variávelPORT. Ver Como a aplicação roda.
Passo a passo
- Abra o projeto e clique em Publicar.
- Confira o que a confirmação mostra:
| Campo | O que é |
|---|---|
| Serviço | Qual serviço será publicado, quando o projeto tem mais de um |
| Origem | O repositório e a pasta declarados |
| Branch ou tag | Editável — o que estiver no campo é o que será publicado |
| Environment | O alvo da publicação |
| Recursos | CPU e memória reservados e máximos, com aviso quando são o padrão da plataforma |
| Endereço | O endereço que vai responder |
- Clique em Publicar agora.
O console leva você para Deployments, onde a publicação aparece na hora, na seção Publicação em andamento — sem recarregar a página. Ver Acompanhar uma publicação.
O campo de branch é editável na confirmação. Publicar uma branch diferente da declarada não altera a configuração do projeto: vale para aquela publicação.
O que acontece depois de confirmar
Preparando → Construindo → Publicando → Verificando → Online
A resposta imediata não é o resultado — é o acompanhamento. Ver Acompanhar uma publicação.
Publicações repetidas
Um clique duplo, ou uma reconexão no meio do envio, não cria duas publicações. A operação é protegida contra repetição.
O que muda uma versão
Não é só código novo. Toda mudança que afeta como a aplicação executa cria uma versão nova:
- código publicado de uma branch ou tag;
- variáveis e secrets declarados;
- recursos e limites ajustados;
- a troca do endereço público — que republica a versão no ar com o endereço novo, sem reconstruir.
Alterar variáveis ou recursos não altera a aplicação que já está no ar: as telas de configuração avisam que a mudança passa a valer na próxima publicação, e as de recursos podem republicar o serviço com a mesma imagem.
Cancelar
Uma publicação em Preparando ou Construindo pode ser cancelada. Depois que o artefato foi enviado, cancelar deixa de ser uma saída — a saída passa a ser restaurar a versão anterior.
Cancelamento antes da troca de tráfego não produz mudança visível: a versão que estava no ar continua.
Quando falha
Uma publicação que falha não deixa o serviço sem versão ativa. A anterior continua atendendo, intacta.
Abra o deployment que falhou: a linha do tempo mostra em qual etapa parou, e o log do build mostra a saída do construtor.
Quando o build passa e a aplicação não fica pronta — não chegou a iniciar, parou logo depois de iniciar, ou iniciou e não respondeu na porta —, a publicação falha com esse motivo e a ação, sem trocar nada. Ver Estados da publicação. Casos comuns em Problemas comuns.
Próximos passos
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.