Ferramenta gratuita
Visualizador de GitLab CI
Cole um .gitlab-ci.yml e receba um diagrama de pipeline do GitLab CI editável: stages como colunas, jobs dentro do seu stage, conexões needs que se adiantam, pipelines filhos e ambientes. Não é preciso ter conta para testar.
Resultado de exemplo
Como funciona
Cole ou solte o .gitlab-ci.yml
O arquivo de pipeline na raiz do seu projeto. Âncoras YAML, templates de extends e tags !reference funcionam normalmente, e um cabeçalho spec de componente de CI/CD no início é ignorado.
Veja o pipeline em colunas
Os stages viram colunas da esquerda para a direita, cada job fica na coluna do seu stage, e needs liga os jobs que começam antes do seu stage.
Abra no Archboard
Salve como um novo diagrama para reorganizar os jobs, adicionar notas, compartilhar um link ou exportar em SVG e PNG. Para se cadastrar basta uma conta Google ou GitHub.
O que é desenhado a partir do .gitlab-ci.yml
O diagrama segue estas palavras-chave do seu arquivo de pipeline:
stagesstageStages como colunas, na ordem da sua lista stages, ou build, test e deploy quando não há lista. Um job sem stage vai para test, e stages sem jobs não são desenhados.
scriptCada job como um cartão na coluna do seu stage. Chaves que começam com ponto são templates: não são desenhadas como jobs, mas continuam moldando os jobs que herdam delas.
needsneeds: []Uma conexão a partir de cada job listado em needs, para os jobs que começam antes do seu stage se destacarem. needs: [] marca um job que começa na hora. Uma conexão fica tracejada quando a entrada de needs é opcional ou o job que espera tem rules, only ou except.
extendsextends resolvido por até 11 níveis de templates, junto com âncoras YAML e chaves de merge, para que os valores herdados de stage, needs, when, parallel, trigger e environment sejam desenhados.
parallelparallel:matrixparallel: 3 ou parallel:matrix mantém o job como um único cartão, marcado ×3 ou com o número de combinações da matriz.
triggerJobs de gatilho ligados a um cartão para o que eles iniciam: o arquivo do pipeline filho indicado em trigger: include, ou o projeto downstream de trigger: project.
environmentCada ambiente, como review, staging ou production, como um cartão ligado a partir dos jobs que fazem deploy nele.
when: manualJobs manuais marcados com · manual, para que as etapas de aprovação do seu pipeline se destaquem.
O que um diagrama do GitLab CI deixa de fora
- A configuração trazida com include, sejam arquivos locais, outros projetos, URLs remotas, templates ou componentes de CI/CD: ela não é buscada, e jobs que herdam de um template desses arquivos aparecem nos avisos.
- Se rules, only ou except adicionariam ou pulariam um job: eles não são avaliados, então todo job é desenhado.
- Variáveis e seus valores, scripts, imagens, caches e caminhos de artefatos.
- Execuções do pipeline: status dos jobs, durações, logs e artefatos. O diagrama mostra a configuração, não uma execução específica.
Perguntas sobre o visualizador de GitLab CI
O que acontece com include?
Arquivos incluídos não são buscados, então só os jobs escritos no arquivo que você cola são desenhados. Para ver os jobs de um arquivo incluído, cole esse arquivo separadamente ou junte os arquivos em um só antes de colar.
Ele resolve extends e hidden jobs?
Sim. extends é mesclado do jeito que o GitLab mescla: hashes são mesclados em profundidade e arrays são substituídos, por até 11 níveis. Hidden jobs, cujo nome começa com ponto, não são desenhados, mas continuam moldando os jobs que herdam deles. Âncoras YAML com chaves de merge também funcionam; tags !reference não são resolvidas.
Como stages e needs aparecem juntos?
Stages são colunas, então a coluna de um job mostra quando ele roda por padrão. Uma conexão needs mostra um job que começa assim que os jobs listados terminam. Sem needs, os jobs não são ligados e só as colunas mostram a ordem. needs que apontam para outros pipelines ou projetos aparecem nos avisos.
Pipelines filhos e downstream são desenhados?
Sim, como cartões. Um job com trigger: include aponta para o arquivo do pipeline filho, e um com trigger: project aponta para o projeto downstream. Os jobs dentro deles não são expandidos; cole o arquivo do pipeline filho para desenhá-lo.
O que acontece quando abro o diagrama no Archboard?
A prévia desta página não é salva. Quando você escolhe “Abrir no Archboard”, o diagrama que você vê, com stages, jobs e conexões, é salvo como um novo diagrama no seu espaço de trabalho, onde dá para reorganizar, anotar, compartilhar ou exportar. É um ponto de partida: mudanças posteriores no seu .gitlab-ci.yml não atualizam o diagrama.
O visualizador de GitLab CI é gratuito?
Sim. Colar um arquivo de pipeline e ver o diagrama não exige conta. Para abrir no Archboard, basta uma conta gratuita.
Abra um canvas em um minuto
Entre com Google ou GitHub. Grátis para um assento. Faça upgrade quando a equipe entrar.