Linter de YAML do GitHub Actions
Faça lint de um arquivo YAML de workflow do GitHub Actions no seu navegador. Detecta erros de sintaxe (tabulações, aspas não fechadas, chaves duplicadas), chaves obrigatórias ausentes (on, jobs), jobs sem runs-on ou steps e referências a actions sem pin ou com @main/@master — apresentados como um resumo de severidade e uma tabela de problemas linha por linha.
Entrada
Saída
Resumo
| Severidade | Quantidade |
|---|---|
| No data yet | |
Problemas
| Linha | Severidade | Mensagem |
|---|---|---|
| No data yet | ||
Mais formas de usar esta ferramenta
API REST
curl -X POST https://api.iotools.cloud/v1/tool/github-actions-yaml-linter \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"inputYaml": "name: CI\non: [push]\njobs:\n build:\n runs-on: …",
"hints": "true"
}'Troque pela sua própria chave, da sua conta. Os campos da ferramenta viram o corpo da requisição — sem envelope.
Peça a um agente de IA
Use the IOTools `github-actions-yaml-linter` tool (GitHub Actions YAML Linter) on this input:
YOUR_INPUT_HERECole isto em qualquer agente conectado ao servidor MCP do IOTools e depois adicione sua entrada.
Widget para incorporar
<iframe
src="https://iotools.cloud/embed/github-actions-yaml-linter/"
width="100%" height="520" frameborder="0" scrolling="no" loading="lazy"
title="Linter de YAML do GitHub Actions — iotools.cloud"
sandbox="allow-scripts allow-forms allow-same-origin allow-downloads allow-popups allow-popups-to-escape-sandbox"
allow="clipboard-write"
style="width:100%;border:1px solid #e5e7eb;border-radius:12px;overflow:hidden"></iframe>
<script src="https://iotools.cloud/embed.js" async></script>Coloque isso na sua própria página — grátis, sem chave, só um link de volta.
| Custo por chamada de API/MCP | A partir de 5 créditos |
|---|---|
| Precisa de mais créditos? | Ver preços |
Também disponível via
Guias
Cole um arquivo de workflow do GitHub Actions e obtenha, na hora, um relatório linha por linha do que está errado nele — antes de enviar um .github/workflows/*.yml quebrado e esperar por uma execução com falha. Este linter analisa seu workflow no navegador e o verifica contra as regras que de fato quebram builds do Actions e, em seguida, agrupa os achados em um resumo de severidade e em uma tabela detalhada de problemas.
O que ele verifica
Sintaxe YAML. A causa mais comum de um workflow com falha é um YAML malformado. O linter sinaliza caracteres de tabulação usados para indentação (o YAML exige espaços), aspas não fechadas, chaves duplicadas dentro do mesmo mapeamento e linhas cuja indentação não se alinha com o bloco ao redor.
Estrutura obrigatória. Todo workflow precisa de um gatilho on: e de um bloco jobs:. Cada job comum precisa de um executor runs-on: e de pelo menos uma entrada em steps:. Jobs de workflows reutilizáveis (uses:) não devem declarar runs-on nem steps. Chaves ausentes ou mal posicionadas são reportadas como erros com o nome do job, para que você saiba exatamente onde procurar.
Fixação e segurança de actions. Referenciar uma action por um branch móvel — actions/checkout@main ou @master — significa que seu build muda silenciosamente sempre que esse branch muda, o que é um risco à cadeia de suprimentos. Essas referências são marcadas como avisos. Fixar uma tag de versão como @v4 gera uma dica de boa prática sugerindo um commit SHA completo para actions de terceiros. Uma action sem nenhum @ref é um erro.
Dicas de boas práticas. Com as dicas ativadas, o linter também sugere timeout-minutes em jobs de longa duração e recomenda evitar comandos de workflow obsoletos, como ::set-output:: e ::set-env::. Desative as dicas para ver apenas erros e avisos graves.
Como usar
- Copie o conteúdo do seu arquivo de workflow e cole na caixa de entrada.
- Leia a tabela de resumo para ver rapidamente a contagem de erros, avisos e dicas.
- Percorra a tabela de problemas de cima para baixo — cada linha traz o número da linha, a severidade e uma mensagem em linguagem simples.
- Corrija, cole novamente e repita até a contagem chegar a zero.
A tabela de problemas pode ser copiada ou baixada como CSV para compartilhar em uma revisão de pull request.
Meu workflow é enviado para algum lugar?
Não. Toda a análise e o linting são executados inteiramente no seu navegador, usando um analisador YAML leve e feito sob medida. Seu workflow — incluindo nomes de secrets ou detalhes internos de jobs — nunca sai da sua máquina.
Isto é um validador YAML completo?
Ele tem como alvo especificamente o esquema de workflows do GitHub Actions, então entende jobs, steps, executores, gatilhos e permissions em vez de tratar seu arquivo como YAML genérico. Esse foco é o que permite oferecer feedback acionável e específico do Actions, em vez de um simples "line 12: bad syntax".