Depure um erro de recuo YAML convertendo-o para JSON

A etapa que nunca foi executada – um arquivo de fluxo de trabalho que foi analisado corretamente e uma chave que terminou em um nível muito alto

Um fluxo de trabalho pode ser analisado com êxito ao colocar `with` ao lado de uma etapa, e não dentro dela. O corredor então ignora ou rejeita a forma posteriormente, e a inspeção visual perde a mudança porque a fonte permanece organizada. A conversão para JSON expõe o pai real por meio de colchetes e limites de array.

ToolAcre relata YAML malformado com linha e coluna, mas estrutura incorreta válida não produz erro de sintaxe. A árvore convertida é, portanto, uma visualização de diagnóstico: ela informa o que esse analisador aceitou, e não o que o esquema do fluxo de trabalho pretendia.

Por que erros de indentação geralmente não são erros — a estrutura de YAML é um espaço em branco, então uma linha deslocada geralmente cria um documento válido, mas diferente

O espaço em branco carrega a hierarquia YAML. Mover uma linha para a esquerda pode transformar um filho em irmão; mover um traço pode colocar um item em outra sequência. Ambos os documentos podem satisfazer a gramática YAML. A validação de sintaxe não pode decidir qual aninhamento corresponde ao aplicativo.

As tabulações no recuo são rejeitadas pelo analisador e recebem uma posição. Espaços que produzem a hierarquia válida errada requerem, em vez disso, comparação estrutural. Essa diferença explica por que alguns erros de indentação falham imediatamente, enquanto outros sobrevivem até o comportamento do aplicativo.

O que JSON torna explícito - colchetes e colchetes que mostram precisamente a qual objeto uma chave pertence

JSON grava limites de objetos com colchetes e membros de array com colchetes. Uma chave YAML mal colocada aparece fora do objeto onde você esperava, e um traço se torna um limite de matriz que é difícil de ignorar. O recuo em beautiful JSON é apresentação; a pontuação define a estrutura.

A visualização também revela tipos resolvidos. Um escalar sem aspas pode ser nulo, número ou booleano no esquema selecionado. Corrigir a hierarquia sem verificar os valores pode deixar um segundo bug, então compare o caminho da propriedade e o tipo JSON.

Formas comuns do erro – um item de lista sob o pai errado, uma chave que se tornou irmã em vez de filha e tabulações misturadas com espaços

Erros comuns incluem um item de sequência alinhado com a lista errada, uma chave de mapeamento recuada em um irmão e caracteres de tabulação misturados com espaços. Chaves duplicadas são outra armadilha: ToolAcre mantém o último valor e avisa com uma posição, então JSON contém apenas a propriedade sobrevivente.

As âncoras podem fazer o resultado parecer maior porque os aliases se expandem em dados repetidos. Isso é esperado para esta conversão e não deve ser confundido com recuo acidental. Leia os avisos antes de atribuir todas as diferenças estruturais aos espaços em branco.

Exemplo resolvido: um fluxo de trabalho de CI com um bloco 'com' mal recuado - convertendo para JSON, identificando a chave perdida, corrigindo e reconvertendo

Crie uma tarefa editada com `steps`, uma entrada `uses` e um mapeamento `with`. Outdent `with` para que ele se torne irmão de `steps` e depois converta. As chaves JSON mostram que `with` pertence ao trabalho e não ao objeto da etapa. Mova-o para baixo do item da lista e reconverta para ver o aninhamento pretendido.

Este exemplo evita reivindicar como um serviço de IC específico responde, porque o conversor não carrega esse esquema. A prova é a hierarquia analisada. A validação do esquema deve seguir e pode então relatar se `with` é aceito no caminho corrigido.

Usando a conversão reversa — JSON para YAML para produzir uma versão recuada corretamente que você pode colar de volta

Depois que a estrutura JSON estiver correta, convertê-la novamente em YAML produz um recuo consistente do serializador. Strings ambíguas podem ganhar aspas e os comentários não são restaurados. Trate a saída como uma serialização de dados limpa, não como um formatador que preserva a origem.

Se os comentários originais explicarem escolhas operacionais, copie a estrutura corrigida no arquivo mantido em vez de substituí-la cegamente. Um arquivo gerado pode estar estruturalmente correto e editorialmente incompleto.

O que isso não cobre – validação semântica em relação ao fluxo de trabalho ou esquema de manifesto, que captura chaves desconhecidas em vez de chaves perdidas

Nenhum fluxo de trabalho, Compose, Kubernetes ou esquema de aplicativo está envolvido. Uma chave pode ficar sob o pai pretendido e ainda assim estar escrita incorretamente ou não ter suporte. Os conversores de sintaxe provam apenas que YAML é aceito e mostram o valor resultante em formato de JSON.

Use o validador da plataforma proprietária para chaves desconhecidas, campos obrigatórios e restrições semânticas. Manter as verificações de sintaxe e de esquema separadas produz falhas mais claras e evita creditar a um conversor genérico conhecimento de domínio que ele não possui.

Conclusão: quando YAML parece certo e se comporta de maneira errada, veja-o como JSON — e como o painel de conversores de sintaxe faz isso instantaneamente

Quando YAML parece certo, mas se comporta de maneira errada, inspecione a árvore analisada. JSON colchetes e colchetes tornam a ascendência explícita, enquanto os avisos de ToolAcre expõem duplicatas, fluxos e alterações de valor que podem complicar o quadro.

Corrija um erro de hierarquia, reconverta e execute a validação do esquema. Esta sequência transforma uma suspeita de espaço em branco invisível em uma estrutura observável sem afirmar que uma conversão bem-sucedida torna a configuração válida para seu destino.

Ao comparar o antes e o depois, concentre-se nos caminhos das propriedades em vez dos números das linhas, pois a serialização pode reordenar a apresentação ou adicionar aspas. Uma revisão útil lista o caminho esperado, seu tipo JSON e se ele está dentro de um objeto ou array. Essa pequena lista de verificação captura uma segunda chave perdida mesmo quando o primeiro sintoma visual é corrigido e evita transformar a formatação YAML gerada no oráculo de teste.