Orbit
Pipeline de Implementação Orbit
The Pipeline tab is a single page that answers "what happens when we push". It shows every way a deploy can be triggered, every gate that can stop one, the state of each environment, and which build…
A aba Pipeline é uma única página que responde a "o que acontece quando fazemos push". Mostra todas as formas de desencadear uma implementação, cada gate que pode impedi-la, o estado de cada ambiente e quais funcionalidades de compilação estão ativadas, tudo lido a partir da configuração real do seu projeto.
Onde o Pipeline Se Encontra
Abra Orbit, clique no projeto e escolha Pipeline no grupo Deployments na fita de abas do projeto. A página tem a etiqueta Deployment pipeline.
É um dashboard apenas de leitura. Nada é configurado aqui; cada secção tem uma ligação para o local onde a definição realmente se encontra. É aí que reside o seu valor: um ecrã para compreender o projeto, em vez de ler oito cartões de definições.
Alertas no Topo
Dois banners aparecem quando se aplicam:
- Deploy lock active, com uma ligação Manage. As implementações desencadeadas por push estão a ser ignoradas.
- N deployments awaiting approval, com uma ligação Review. Alguém precisa de aprovar ou rejeitar.
Se qualquer uma delas está visível e está a questionar-se por que motivo um push não foi implementado, tem a sua resposta sem precisar de ler mais.
Estatísticas de Compilação
Um painel compacto mostra, ao longo das compilações recentes: taxa de sucesso, tempo médio de compilação e quantas tiveram sucesso. É uma verificação de integridade e não uma análise. Para ver o quadro completo, consulte Orbit Project Analytics e Orbit Build Insights.
Fontes de Disparo
Esta secção lista todas as formas de desencadear uma implementação para este projeto:
| Origem | O que mostra |
|---|---|
| Git push | O repositório conectado, ou No repo connected |
| Branch previews | Se as pré-visualizações são criadas automaticamente em qualquer ramo |
| Git tag | O padrão de etiqueta, se um estiver configurado |
| Manual deploy | Sempre disponível |
Leia isto sempre que se surpreenda com uma implementação. Se apareceu uma compilação e ninguém fez push, uma destas é a explicação: uma etiqueta, um hook de implementação ou alguém a carregar num botão.
Gates e Segurança
A secção maior é a lista de gates, cada uma mostrando o seu estado atual com uma ligação Configure para o cartão de definições relevante.
| Gate | O que faz |
|---|---|
| Approval gate | As implementações em produção requerem aprovação explícita |
| Staging prerequisite | A produção aguarda o staging no mesmo commit |
| CI checks | Verificações obrigatórias que devem passar, ou No checks required |
| Freeze window | Fins de semana bloqueados, horas personalizadas, ou sem agenda de congelamento |
| Deploy lock | Ativo, ou sem lock |
| Health check | O caminho verificado após implementação, ou Disabled |
| Auto-rollback | Reverte após falha da verificação de integridade |
| Skew protection | A janela de retenção para ativos antigos |
| Auto retry | Quantas vezes as falhas de infraestrutura são tentadas novamente |
A maioria destes gates aplica-se apenas a implementações desencadeadas por push. As implementações manuais a partir do painel e hooks de implementação passam diretamente. A exceção comporta-se de forma diferente, e o detalhe de cada gate é coberto em Deploying Your Project. Leia-o antes de confiar num gate como controlo.
Leitura dos Gates como uma Lista de Verificação
Para um projeto que interessa, uma linha de base sensata é:
- Health check: definido, apontando para um caminho que exercita a aplicação em vez de uma shell em cache.
- Auto-rollback: ativado. Sem uma verificação de integridade, não tem nada sobre o qual atuar, portanto os dois vão juntos.
- Auto retry: um ou dois. Recoloca na fila compilações que falharam em erros de infraestrutura como uma falha de rede, e não tenta novamente erros de código, portanto não lhe custa nada a não ser tempo poupado.
- Approval gate: ativado para qualquer coisa em que uma má implementação é cara, desativado quando o atrasa mais do que o protege.
Se a página mostra Health check Disabled e Auto-rollback ativado, essa combinação não faz nada. É uma das configurações erradas mais fáceis de manter durante meses sem notar, e esta página é onde a deteta.
Fluxo de Ambientes
A secção Environment flow desenha cada ambiente como um cartão com o seu estado atual: LIVE, BUILDING ou PAUSED, o ramo que segue e o número de tentativa se a implementação atual for uma tentativa.
Os crachás em cada cartão mostram o que está ativado para esse ambiente:
- Smoke tests, pedidos GET executados em caminhos escolhidos após cada implementação bem-sucedida.
- Auto-promote, promoção de staging para produção após um número de horas saudáveis.
- Canary, a percentagem de tráfego numa implementação canary.
- Inherits prod vars, onde staging mescla variáveis de ambiente de produção com prioridade mais baixa.
- Scheduled rebuild, onde a produção é reconstruída num intervalo.
Cada cartão tem uma ligação para as implementações desse ambiente. Se um ambiente mostra No deployments yet, existe na configuração mas nada foi enviado para ele.
Funcionalidades Ativas
A última secção resume as definições ao nível de compilação:
| Funcionalidade | Valores |
|---|---|
| Server mode | SSR ativado ou apenas estático |
| Auto-create on push | Se os pushes de ramo criam ambientes |
| Health checks | Ativado ou desativado |
| Build retry | Um máximo, ou desativado |
| Deploy groups | Agrupado com outros projetos, ou independente |
| Build timeout | O limite por compilação |
| Preview expiry | Dias antes de as pré-visualizações serem pausadas, ou nunca |
Server mode é aquele em que as pessoas ficam presas. Um framework que renderiza no servidor precisa que esteja ativado; uma exportação estática não. Se o seu projeto compila bem e depois serve uma página em branco ou um 404 em cada rota exceto a página inicial, verifique primeiro aqui. Consulte Frameworks Orbit Supports.
Preview expiry é a da manutenção. Definido para nunca, os ambientes de pré-visualização acumulam indefinidamente.
Utilizar a Página Pipeline
Ao integrar alguém. Envie-o aqui primeiro. É uma briefing mais rápida e precisa do que qualquer documento, porque é gerada a partir da configuração ativa.
Quando uma implementação não ocorreu. Trabalhe de cima para baixo: banners, depois fontes de disparo, depois gates. Uma das três explicará isto.
Antes de uma versão arriscada. Verifique se a secção de gates lê da forma como acha que deve. É a diferença entre acreditar que tem auto-rollback e tê-lo.
Durante um incidente. O fluxo de ambientes diz-lhe o que está ativo onde, e se algo está em fase de compilação.
Resolução de Problemas
A página mostra No repo connected. O projeto não tem repositório. Conecte um: consulte Connecting a GitHub Repository.
Um gate está ativado mas as implementações ainda passam. É apenas desencadeado por push. Um hook de implementação ou uma implementação manual do painel não é afetado.
Um ambiente mostra PAUSED. Os ambientes de pré-visualização pausam automaticamente após o vencimento. Reimplemente para trazer um de volta.
Auto-promote é mostrado mas nada promove. Requer o número configurado de horas saudáveis com testes de fumaça passando, e é avaliado periodicamente em vez de instantaneamente.
Para Onde Ir a Seguir
- Deploying Your Project para o que cada gate realmente bloqueia.
- Orbit Project Settings para alterar qualquer um deles.
- Rolling Back a Deployment quando um gate não o salvou.