GitHub Actions aceita YAML inválido segundo a especificação 1.2.2

GitHub Actions aceita YAML inválido segundo a especificação 1.2.2

Publicado em 22/11/2026 0 visualizações

Ainda sem avaliações

O GitHub Actions aceita uma construção fora do YAML 1.2.2, embora analisadores conformes possam rejeitá-la.

Uma etapa de ação expõe a divergência

O GitHub Actions aceita uma construção que viola a especificação YAML 1.2.2. A divergência veio à tona quando uma pessoa relatou que o zizmor rejeitou um fluxo de trabalho com uma etapa aceita pela plataforma.

A etapa usava a ação jsdaniell/create-json@v1.2.3 para criar um arquivo JSON de configuração de um repositório remoto do npm. O valor da entrada json era um texto JSON entre aspas simples, distribuído por várias linhas. A construção parece comum, mas não atende à regra de indentação do YAML.

A regra de indentação do YAML

A especificação YAML 1.2.2 determina que nós no estilo de fluxo dentro de uma coleção em bloco — como uma lista ou um mapa — comecem com pelo menos um espaço a mais que a coleção que os contém. Eles também podem começar em uma linha seguinte, desde que respeitem essa exigência de recuo.

No exemplo, a construção aceita pelo GitHub Actions difere da forma compatível com a especificação por um espaço: o conteúdo da string JSON precisa avançar ao menos um espaço em relação à coleção em bloco. A diferença é discreta e pode passar despercebida, mas leva um analisador estritamente conforme a rejeitar o arquivo.

Consequências para a análise de fluxos

Essa diferença dificulta a leitura automatizada de fluxos de trabalho reais. Um arquivo tolerado pelo GitHub Actions pode ser recusado por uma ferramenta que aplica a regra publicada, impedindo seu processamento. O autor descreve o caso como um obstáculo à análise de algumas configurações usadas na prática.

O episódio também levou a uma revisão de uma tentativa de corrigir o comportamento do tree-sitter-yaml. Primeiro, o autor abriu o item nº 36 para acomodar a construção observada. Depois, concluiu que a mudança tratava como válida uma sintaxe fora da especificação e abriu o item nº 51 para revertê-la.

O parser usado pela plataforma ainda é uma hipótese

Como boa parte do código por trás do GitHub Actions é proprietária, não há confirmação direta sobre o analisador empregado. O autor considera provável que seja o YamlDotNet e estima que o Actions use a versão 5.3.0, lançada em 2018. Essa identificação é uma hipótese, não uma confirmação do GitHub.

Segundo a análise do autor, atualizar para o YamlDotNet 18.1.0, versão mais recente considerada no relato, ainda não corrigiria esse caso: o comportamento problemático permanece nessa versão. A explicação proposta é que uma correção de 2020 cobriu strings entre aspas duplas, mas não as entre aspas simples. O autor relaciona essa possibilidade ao fato de a suíte oficial de testes YAML exercitar a regra 8.2.3 com aspas duplas, embora ela também se aplique às simples. Leia o relato original.

Autor

Jaime LinharesEmpresa

CEO do Guia de TI

Comentários

0

Comece a conversa.
Seja a primeira pessoa a comentar este conteúdo.

Deixe um comentário

Entre no nosso grupo!