Archboard

Ferramenta gratuita

Visualizador de GitHub Actions

Cole um arquivo de workflow e receba um diagrama do GitHub Actions editável com gatilhos, jobs, dependências needs, tamanhos de matriz, ambientes e contêineres de serviço, antes mesmo de o workflow rodar. Não é preciso ter conta para testar.

Resultado de exemplo

Diagrama de exemplo desenhado a partir de um exemplo de GitHub Actions
Experimente um exemploWorkflow de CI/CD

Como funciona

  1. Cole um arquivo de workflow

    Qualquer arquivo YAML de .github/workflows, como ci.yml ou deploy.yml. Para comparar vários workflows, cole todos juntos com uma linha --- entre eles.

  2. Veja o pipeline

    Um cartão de gatilho inicia o fluxo, os jobs seguem da esquerda para a direita na ordem definida por needs, e cada job é ligado aos ambientes em que faz deploy e aos contêineres de serviço que usa.

  3. 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 de um arquivo de workflow

Estas chaves do workflow dão forma ao diagrama:

  • on

    Um cartão de gatilho por workflow com os dois primeiros eventos e o número dos demais, como push · pull_request +1, ligado a cada job que começa primeiro. workflow_call e workflow_run ganham cartões próprios.

  • jobs

    Cada job como um cartão com seu nome, ou com o ID do job quando o nome contém uma expressão. Os passos são contados em vez de desenhados, e jobs com uma condição if recebem linhas de entrada tracejadas.

  • needs

    Uma conexão de cada job listado em needs até o job que espera por ele, para você ler a ordem que uma execução segue. IDs de job desconhecidos e ciclos aparecem como avisos.

  • strategy.matrix

    Um job de matriz continua sendo um único cartão marcado com o número de jobs que ele cria, como ×6, contado do jeito que o GitHub expande, com include e exclude aplicados. Uma matriz montada a partir de uma expressão mostra ×?.

  • environment

    Cada ambiente de deploy, como staging ou production, como um cartão próprio, ligado a partir dos jobs que fazem deploy nele.

  • services

    Contêineres de serviço como cartões presos ao seu job: imagens postgres, redis e mongo ganham os cartões de banco de dados correspondentes, e qualquer outra imagem, um cartão de contêiner.

  • uses

    Um job que usa um workflow reutilizável é um único cartão com o nome dele ou o caminho do workflow, ligado por needs como qualquer outro job.

O que um diagrama de workflow deixa de fora

  • Passos individuais, seus scripts run e as actions que eles usam: os passos são apenas contados.
  • Resultados de execução: se uma execução passou ou falhou, quanto tempo os jobs levaram e seus logs. O diagrama mostra o workflow como ele está escrito.
  • Os jobs dentro de um workflow reutilizável, esteja ele no mesmo repositório ou em outro: o arquivo não é buscado, então ele fica como um único cartão.
  • O resultado de condições if e expressões: um job é desenhado mesmo quando a condição o pularia, e env, secrets e as entradas with não são lidos.

Perguntas sobre o visualizador de GitHub Actions

Posso visualizar vários workflows de uma vez?

Sim. Cole os arquivos de workflow um depois do outro, com uma linha --- entre eles. Cada workflow é desenhado em sua própria moldura com seu próprio cartão de gatilho, e um gatilho workflow_run mostra o nome do workflow que ele espera.

Como os jobs de matriz são mostrados?

Como um único cartão com ×N, em que N é o número de jobs que a matriz cria depois de aplicar exclude e include, até o limite de 256 do GitHub. Quando a matriz vem de uma expressão como fromJSON, a contagem não pode ser conhecida antes de uma execução, então o cartão mostra ×?.

Ele suporta workflows reutilizáveis?

Sim. Um job com uses no nível do job vira um único cartão de workflow reutilizável, e needs o liga como qualquer outro job. Os jobs dele não são expandidos, porque ficam em outro arquivo. Cole esse workflow separadamente para desenhá-lo: o gatilho workflow_call dele ganha um cartão próprio.

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 gatilho, jobs, ambientes 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 arquivo de workflow não atualizam o diagrama.

O visualizador de GitHub Actions é gratuito?

Sim. Colar um workflow 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.

Começar grátisVer preços