Orbit
Ver Registos de Construção
Every Orbit deployment keeps its complete build log, plus a structured breakdown of what the build did and how long each phase took. This guide covers where to find the log, how to read the…
Visualizar o Registo da Implementação Mais Recente
Abra o projeto em Orbit. O painel Latest build no separador Overview mostra o registo da implementação mais recente. Se uma compilação está em execução neste momento, o registo transmite em direto, linha por linha, conforme o agente de compilação o produz.
Clique em Full details para abrir a página de detalhes completa da implementação.
Visualizar Registos de uma Implementação Específica
- Abra o seu projeto em Orbit.
- Abra o separador Deployments.
- Clique em qualquer implementação para abrir a sua página de detalhes.
- O registo completo da compilação está nessa página.
A lista Recent deployments no separador Overview tem uma ligação View logs em cada linha que vai para o mesmo local. As implementações de pré-visualização têm a mesma ligação na secção Preview deployments.
Fases da Compilação
A página de detalhes divide a compilação em fases nomeadas com uma duração para cada:
| Fase | O que acontece |
|---|---|
| Clone | Obter o seu repositório na confirmação implementada |
| Cache restore | Desempacotar a cache node_modules, em planos com cache de compilação |
| Install | Executar o seu comando de instalação |
| Cache save | Reempacotar node_modules para a próxima compilação |
| Build | Executar o seu comando de compilação |
| Upload | Empacotar o diretório de saída e armazenar o artefato |
| Done | O artefato está perante o tráfego |
Esta é a forma mais rápida de responder a "por que é que essa compilação foi lenta". Uma fase Install prolongada com um crachá Cold build significa que a cache foi perdida. Uma fase Build prolongada significa que a sua própria compilação ficou mais lenta.
Metadados da Compilação
Os cartões acima do registo mostram os factos sobre a implementação:
| Cartão | O que mostra |
|---|---|
| Status | Queued, Building, Deploying, Succeeded, Failed, Cancelled, Rolled back ou Awaiting approval |
| Commit | A confirmação que esta implementação compilou, ligando ao fornecedor |
| Branch | O ramo git de onde veio |
| Author | Quem empurrou a confirmação |
| Build time | Tempo total de parede, com uma classificação Fast, Normal ou Slow em relação ao seu próprio histórico |
| Artifact | Tamanho da saída empacotada, com uma ligação de descarregamento |
| Framework | A estrutura que Orbit detectou |
| Package manager | npm, yarn ou pnpm, detectado a partir do seu ficheiro de bloqueio |
| Build cache | Cache hit ou Cold build |
| Build host | Qual agente de compilação o executou |
| Queue position | O seu lugar na fila, enquanto a implementação ainda está na fila |
| Pull request | O número PR, para uma implementação de pré-visualização |
| Health score | Uma pontuação de 0 a 100 com as deduções listadas |
Análise que Orbit Executa Sobre o Registo
A página de detalhes não é apenas um despejo de texto. Orbit analisa o registo e apresenta o que interessa.
- Build timeline com durações por fase.
- Slow build detected quando uma compilação é significativamente mais lenta do que a sua mediana, com a percentagem e o seu tempo típico dos últimos 10 registos.
- TypeScript errors, extraídos e contados, quando a compilação falhou na verificação de tipo.
- Build analysis para compilações Next.js: tamanhos por rota, JS de primeira carga e contagens de rotas estáticas, dinâmicas e ISR.
- Bundle regression avisos quando o JS de primeira carga de uma rota cresce mais de 20% face à implementação anterior, ou o pacote JS partilhado cresce.
- npm audit resultados analisados diretamente da saída de instalação, resumidos por severidade.
- Security headers audit pontuado de 60 pontos.
- Smoke test resultados, se tiver configurado caminhos de teste de fumaça.
- Performance budgets ultrapassados, se tiver definido orçamentos.
- Build optimization advisor, listando alterações concretas com uma economia de tamanho estimada, classificadas por impacto.
- Real user metrics, os p75 Core Web Vitals registados enquanto essa implementação estava ativa.
Que Variáveis de Ambiente a Compilação Realmente Viu
A página de detalhes lista as chaves de variáveis de ambiente que foram injetadas no tempo de compilação e compara-as com a sua configuração atual: adicionado, alterado, removido, inalterado. As chaves cor de teal vieram de uma sobreposição específica do ambiente, as cinzentas do nível do projeto.
Os valores nunca são armazenados e nunca são mostrados. Passar o rato sobre uma chave dá-lhe uma impressão digital SHA-256, o que é suficiente para confirmar que dois ambientes têm o mesmo valor sem o revelar.
Esta comparação é a forma mais rápida de responder a "a minha alteração de variável de ambiente realmente entrou na compilação". Se a implementação é anterior à alteração, Orbit diz-o com um aviso Environment variables updated since this deployment e lembra-o de que a alteração não entrará em vigor até que reimplante.
Comparar Duas Implementações
Clique em Compare numa implementação para compará-la com a anterior: tempo de compilação, tamanho do artefato, estado da cache, estrutura e a comparação de artefatos ao nível do ficheiro. Esta é a rota mais rápida para "o que realmente mudou" quando uma implementação se comporta de forma diferente da anterior.
Quando uma Compilação Falha
O cartão de estado muda para Failed e o registo mostra onde parou. Acima do registo, Orbit adiciona um resumo de falha categorizado com uma correção sugerida. As categorias reconhecidas incluem falta de memória, erro de compilação, falha de teste, erro de lint, erro de instalação, erro de rede e tempo limite, e Orbit corresponde a padrões específicos como um módulo em falta, um conflito de dependência de pares ERESOLVE, um código de erro de TypeScript, um disco de compilação completo, um pacote 404 e um ficheiro de bloqueio desatualizado.
Há também um botão Get AI diagnosis, que lê as últimas 120 linhas do registo juntamente com a estrutura detectada e a categoria de falha e retorna uma explicação em linguagem natural.
O diagnóstico de IA é marcado como AI-generated, verify before acting por uma razão. É muito bom em apontar-o para a linha correta do registo, e não é autoritário sobre a sua base de código. Leia a linha do registo a que se refere antes de alterar qualquer coisa.
Tentar Novamente uma Compilação Falhada
Na página de detalhes da implementação, clique em Retry build para re-executar a mesma confirmação sem empurrar uma nova. Isto corrige falhas transitórias como um erro de rede durante a instalação.
Se suspeitar de uma dependência em cache obsoleta, utilize More retry options, depois Retry with cleared cache, que elimina a cache de compilação antes de tentar novamente.
A orientação completa falha por falha está em Resolução de Problemas de Compilações Falhadas.
Cancelar uma Compilação em Execução
Clique em Cancel enquanto uma compilação está em execução.
Cancelar termina a máquina de compilação imediatamente e não pode ser desfeito. A implementação é registada como Cancelled e a implementação anteriormente ativa continua a servir tráfego, pelo que cancelar nunca derruba o seu site. Note que empurrar uma nova confirmação para o mesmo ramo enquanto uma compilação está em execução cancela a compilação em voo automaticamente, portanto uma implementação cancelada seguida por uma em execução é normal.
Descarregar o Artefato
Cada implementação bem-sucedida mantém a sua saída empacotada. Clique em Download no cartão Artifact para obter o pacote exato que foi servido. Há também um navegador de artefatos para inspecionar o conteúdo sem descarregar o tudo.
O tempo durante o qual os artefatos são mantidos é definido em Settings, em Artifact retention: o número de artefatos bem-sucedidos a manter por ambiente, de 10 a 500, com o padrão de 50. Os artefatos mais antigos são eliminados diariamente. O artefato da implementação atualmente ativa é sempre mantido, independentemente da definição.
A retenção de artefatos é o que torna a reversão possível. Defini-la demasiado baixa encurta o tempo que pode voltar atrás uma implementação incorreta sem uma recompilação. Se implementar muitas vezes por dia, aumente-a em vez de a diminuir.