Pular para o conteúdo principal

Acompanhar uma publicação

Uma publicação leva tempo porque atravessa build, envio de imagem e ativação. O Zero mostra esse tempo em vez de escondê-lo atrás de um cronômetro parado.

Publicação em andamento​

Assim que você publica, a publicação aparece na hora em Deployments, numa seção Publicação em andamento — sem precisar recarregar a página.

O cartão diz o que está acontecendo agora, com o nome da etapa — por exemplo, Construindo a imagem · próxima etapa: Imagem construída (2 de 9) — e quem publicou.

Ver detalhes existe desde o primeiro segundo e abre, no próprio cartão:

  • o tempo decorrido;
  • as etapas, feitas, em curso e pendentes — as mesmas da página do Deployment;
  • a narração da plataforma, ao vivo: "Código fixado na versão que será publicada.", "Imagem da aplicação construída e armazenada.", e, se algo der errado, o motivo.

No começo a publicação ainda não é um Deployment: ele nasce quando a versão é registrada, depois de a plataforma buscar o código e construir a imagem. A partir daí o painel ganha Abrir o Deployment, e o Deployment entra sozinho na tabela. Publicações que não constroem — troca de endereço, ajuste de escala — mostram como puladas as etapas que não percorrem.

A lista de deployments​

A mesma lista aparece em dois lugares: no nível da organização, com todas as publicações; e dentro de um projeto, restrita a ele.

ColunaO que mostra
EstadoUm dos estados visíveis
ProjetoSó na lista da organização
VersãoA versão comprometida — traço quando ainda não há
DuraçãoTraço enquanto o trabalho não terminou
QuandoO início da publicação

Ausência nunca vira número: uma publicação sem versão comprometida mostra traço, não zero.

Uma troca de endereço também aparece aqui, como Troca de endereço: é a versão que já estava no ar, republicada com o endereço novo, sem reconstruir.

A linha do tempo​

Abrir um deployment mostra a linha do tempo, que é a fonte da verdade sobre o que aconteceu. Ela tem quatro abas:

AbaConteúdo
Visão geralAs etapas percorridas, com duração de cada uma
EventosO registro cronológico, em linguagem de produto
ConfiguraçãoA configuração exata daquela publicação
Detalhes técnicosIdentificadores e valores internos, rotulados como tais

Enquanto a publicação está em andamento, a tela se atualiza sozinha. Quando ela termina, para de atualizar — não há por que continuar consultando um desfecho que não muda.

Enquanto a plataforma espera a aplicação ficar pronta, a linha do tempo narra a espera — por exemplo, "A aplicação iniciou, mas ainda não aceita conexão na porta 8080." ou "Esperando capacidade livre no ambiente para a instância.". A frase "Versão N está no ar." só aparece quando a prontidão foi de fato observada. Se a aplicação não fica pronta, a publicação falha com o motivo e a ação; ver Estados da publicação.

Tentativas de publicação​

Nem toda tentativa vira um deployment. Uma falha de origem — repositório inacessível, branch inexistente — acontece antes de haver versão comprometida, e um objeto que só nasce depois disso não a registraria.

Por isso o projeto tem também a lista de tentativas de publicação: ela mostra as que morreram cedo, com o motivo. É onde procurar quando você clicou em Publicar e nada apareceu na lista de deployments.

Até onde foi confirmado​

Cada publicação mostra o quanto a plataforma de fato provou, numa escada de quatro etapas:

Imagem conferida → Configuração aplicada → Aplicação respondendo → Endereço confirmado

O console mostra isso como uma escada, e não como um selo verde único. "Configuração aplicada" e "Endereço confirmado" são afirmações diferentes, e tratá-las como uma só faz alguém anunciar uma versão que ainda não responde.

  • Aplicação respondendo é registrada quando as instâncias ficam prontas — aceitam conexão na porta do serviço.
  • Endereço confirmado vem de tráfego real: uma requisição que entrou pela internet depois da ativação desta versão e foi respondida pela aplicação. Uma resposta gerada pela própria plataforma quando não alcança a aplicação, como um 503, não conta.

Por isso uma publicação recém-feita fica em 3 de 4 até a primeira requisição real chegar e ser respondida — abrir o endereço no navegador basta. A partir daí, 4 de 4 e Recebendo tráfego. A mesma coleta de tráfego alimenta os gráficos de tráfego.

Na página de Domínios do projeto, o mesmo rigor vale para HTTPS e roteamento: os indicadores dizem confirmado ou ainda não confirmado, nunca "erro". A ausência de prova não é prova de falha, e pintar de vermelho um endereço recém-publicado ensina a ignorar o vermelho de verdade.

Erros comuns​

SintomaO que olhar
Cliquei em Publicar e nada aparece na listaTentativas de publicação — a falha foi antes da versão
Quero ver o que a publicação em andamento está fazendoVer detalhes no cartão: etapas e narração ao vivo
A publicação está há muito tempo em ConstruindoVer detalhes mostra até onde chegou. A saída do construtor fica no log do build do Deployment, depois que a versão é registrada; se o build falhar antes, o motivo vem no próprio cartão
Chegou a Online e a escada parou em 3 de 4Normal: falta a primeira requisição real. Abra o endereço
Chegou a Online mas o endereço não respondePágina de Domínios: veja se HTTPS e roteamento foram confirmados
A etapa Respondendo aparece como falhaA aplicação não ficou pronta; a tela diz o motivo e a ação. Ver Problemas comuns

Próximos passos​