Vitreum Hub

Deploy

Deploys

Histórico de publicações, status por empresa e reenvio de falhas.

Atualizado em 22/11/2026

Os Deploys são o histórico e o acompanhamento das publicações de código por empresa e ambiente. Cada deploy — disparado por um pull request no GitHub ou manualmente — registra o que foi publicado, para quais empresas, em homologação ou produção, e com qual resultado por alvo. Aqui a equipe vê o status de cada publicação, reenvia os alvos que falharam e abre o detalhe com as etapas, as métricas e os arquivos da mudança. É o painel que dá rastreabilidade e controle sobre o que entrou em produção.

Onde fica

No menu lateral, em Deploy, abra Deploys. Filtre por Ambiente (Homologação/Produção), Status e Projeto — este último lista as empresas/tags que recebem deploy, para ver o histórico de uma só. Os filtros ficam guardados: se você sair para outra tela e voltar, a lista continua como estava; use Limpar filtros para ver tudo de novo.

O que a lista mostra

Cada card traz o ambiente, o status (Na fila, Executando, Concluído, Concluído com erros, Falhou), o PR, o autor, o commit e os badges por empresa. Se um alvo falhou, use Reenviar falhas.

O detalhe do deploy

Ver detalhe → abre a página (com atualização ao vivo) e as abas Descrição, Empresas (status e métricas por alvo, com Reenviar), Logs (o log de execução do servidor) e Fontes (os arquivos da mudança). O número do Pull request é um link: clicando nele, o PR abre no GitHub em outra aba.

Na aba Empresas, cada alvo mostra ainda uma faixa com a versão do receiver, o servidor que atendeu, a duração e a pasta de backup gerada antes de sobrescrever os arquivos — é por onde se recupera um arquivo à mão, sem abrir acesso remoto.

O log de execução

A aba Logs traz o mesmo texto que o servidor grava no arquivo de log dele, linha a linha: o que foi copiado, o tamanho de cada arquivo, os scripts de banco executados ou ignorados e os erros. Dispensa pedir acesso ao servidor para entender uma publicação.

  1. Escolha a empresa nos botões do topo — o log é por empresa.
  2. Use Filtrar linhas… para achar um arquivo ou uma mensagem específica no meio do log.
  3. Copiar log leva o texto inteiro para a área de transferência, pronto para anexar num chamado.

As linhas vêm destacadas por cor: erros em vermelho, avisos e itens ignorados em âmbar, e as marcações de início e fim em azul.

Deploys antigos, e empresas cujo servidor ainda não foi atualizado, não têm log detalhado — a aba avisa isso e as demais informações continuam disponíveis.

O que cada empresa recebeu

Na aba Fontes, quando o deploy já terminou, a lista de arquivos vira uma tabela com uma coluna por empresa. Cada célula diz o que aconteceu com aquele arquivo naquela empresa: gravado, já estava idêntico, script de banco executado ou ignorado, falhou, ou não enviado. A legenda abaixo da tabela explica cada símbolo. As colunas Bytes e SHA identificam a versão exata do arquivo publicado.

Quando um arquivo volta para a versão anterior

O botão Reenviar republica exatamente o que aquele deploy publicou, na versão do commit dele — é o que se espera quando uma empresa ficou de fora e precisa receber aquela publicação. O efeito colateral aparece quando se reenvia um deploy antigo: se outro deploy mais novo já tinha subido os mesmos arquivos para aquela empresa, o reenvio grava a versão antiga por cima.

Nesse caso o Hub mostra um aviso no topo do detalhe, dizendo quantos arquivos ficaram numa versão anterior, em quais empresas e qual deploy tinha a versão mais nova — com link para ele. Os mesmos arquivos aparecem marcados na tabela da aba Fontes.

Para voltar à versão atual, reenvie os deploys citados no aviso, do mais antigo para o mais novo. O aviso só aparece em Produção: em homologação os pull requests publicam de branches diferentes e "mais novo" não significa que um contém o outro.

Baixar os fontes do deploy

Na aba Fontes, o botão Baixar fontes (.zip) monta um pacote com os arquivos daquele deploy na mesma estrutura de pastas do repositório — a mesma árvore que o deploy grava no servidor da empresa. Serve para aplicar a mudança à mão num servidor fora do fluxo automático, conferir o que foi publicado ou guardar o pacote de uma publicação específica.

  1. Abra o deploy em Ver detalhe → e vá na aba Fontes.
  2. Clique em Baixar fontes (.zip). Quando o deploy tem scripts da pasta sql/, aparece também Baixar sem SQL, que traz só os arquivos — use quando o SQL já foi aplicado manualmente.
  3. O arquivo vem nomeado pelo deploy, PR e commit (ex.: deploy-869-pr346-d1d2b2f.zip).

Os arquivos ficam na raiz do pacote, prontos para extrair sobre o destino. A única pasta a mais é _vitreum-deploy/, com um LEIA-ME.txt que registra o commit, o ambiente, quem gerou o pacote e — importante — os arquivos removidos pelo deploy: eles não existem mais no commit, então não vêm no zip, mas o deploy os apaga no servidor. Essa pasta pode ser apagada depois de extrair.

O pacote sai sempre do commit registrado no deploy, então baixar hoje um deploy de meses atrás devolve exatamente o que foi publicado na época. Deploys de projeto inteiro (milhares de arquivos) não são empacotados pelo Hub — nesse caso a própria mensagem informa o endereço para baixar o commit direto do GitHub. Quem enxerga o deploy pode baixar os fontes; não há permissão adicional.