Ir para o conteúdo
ToolsMinify logo
Todos os artigos

YAML para JSON em DevOps - Compose, Actions e Kubernetes

Converta YAML de Docker Compose, GitHub Actions e Kubernetes para JSON sem enviar segredos. Cobre fluxos multi-documento com ---, o problema da Noruega (NO como string) e quando preferir JSON em vez de YAML.

Atualizado em 10 de novembro de 20268 min de leitura

Use o Conversor YAML para JSON - de graça

Abra a ferramenta e aplique o que você aprendeu neste guia.

Abrir Conversor YAML para JSON

Configs de DevOps vivem em YAML. APIs, fixtures de teste e muitas CLIs querem JSON. Essa divisão aparece todo dia: um compose.yaml que você precisa como fixture, um workflow do GitHub Actions que quer inspecionar como JSON aninhado, ou um Deployment do Kubernetes que precisa entregar a uma ferramenta que só aceita objetos. O Conversor de YAML para JSON gratuito roda no seu navegador para que segredos nunca saiam do dispositivo. Este guia cobre os fluxos de colar que importam, fluxos multi-documento, o problema da Noruega e quando JSON ou YAML devem ser a fonte da verdade.

Resposta rápida

Mantenha YAML como fonte editada por humanos para Compose, Actions e Kubernetes. Converta para JSON quando um consumidor, fixture ou API precisar de tipos estritos e sem comentários. Prefira YAML 1.2 CORE para que o código de país NO e a palavra yes permaneçam strings. Arquivos multi-documento separados por --- viram um array JSON - um elemento por documento.

Docker Compose, GitHub Actions e Kubernetes

Esses três formatos dominam o tráfego de colar e converter. Um bloco de serviços do Compose vira JSON tipado para uma API ou harness de teste - portas entre aspas como "8080:80" continuam strings; números e booleanos mantêm tipos JSON. Um trecho de workflow em YAML converte para você ver o aninhamento sem lutar com indentação. Um Deployment com apiVersion, kind, metadata e spec converte limpo; coloque aspas em strings de versão como "1.25" quando precisar de string, não float. Carregue as amostras integradas na página da ferramenta ou cole seu próprio arquivo - nada é enviado.

  • compose.yaml / docker-compose.yml: serviços e redes como fixtures JSON
  • Trechos de workflow do GitHub Actions para revisar aninhamento ou editar fixtures
  • Objetos Deployment, Service e ConfigMap do Kubernetes para ferramentas só-objeto
  • Swap de JSON de volta para YAML quando preferir editar o resultado à mão

Fluxos YAML multi-documento (---)

Kubernetes e alguns fluxos próximos ao Helm enviam vários recursos em um arquivo, separados por ---. Um conversor que só devolve o primeiro documento descarta o resto em silêncio. O mapeamento DevOps certo é um array JSON: ordem dos documentos preservada, um objeto (ou escalar) por documento. A direção Swap em um array de objetos reemite um fluxo YAML separado por ---. Observe o badge de contagem de docs para saber quantos documentos entraram no array - isso pega colagens truncadas e docs em branco acidentais.

  • Dois manifests separados por --- viram um array JSON de dois elementos
  • Documentos vazios e --- finais ainda contam - confira o badge
  • Round-trip com Swap quando precisar da forma de fluxo de novo
  • Prefira um recurso por arquivo no git quando diffs importam mais que a conveniência de colar

O problema da Noruega - mantenha NO como string

YAML 1.1 trata yes, no, on, off, y e n sem aspas como booleanos. O código de país NO portanto vira false em JSON - o clássico problema da Noruega. YAML 1.2 CORE mantém NO e yes como strings a menos que você escreva true/false explicitamente. Use YAML 1.2 por padrão em configs novas e em qualquer arquivo com códigos de país, flags de funcionalidade escritos yes/no ou rótulos on/off. Ative YAML 1.1 só quando um consumidor legado exigir essas coerções. Use o censo de tipos após converter: se uma chave que você esperava como string aparecer como boolean, coloque aspas na fonte ou fique no 1.2.

Quando preferir JSON vs YAML

Prefira YAML quando humanos editam o arquivo no git: comentários, âncoras e indentação legível ajudam nas revisões. Prefira JSON quando máquinas trocam os dados: APIs, muitos SDKs e validadores de schema estritos esperam tipos JSON sem comentários. Converta YAML para JSON para fixtures e APIs de objetos; converta JSON para YAML quando precisar de uma vista editável à mão de um blob. Para uma comparação mais ampla de formatos - aninhamento, planura do CSV e armadilhas clássicas - veja JSON vs YAML vs CSV. Combine a saída JSON com o Minificador e formatador JSON quando precisar de um payload de uma linha, ou o Conversor de XML para JSON quando a fonte for markup em vez de YAML.

  • YAML como fonte da verdade para Compose, Actions, values Helm e manifests K8s
  • JSON para corpos REST, fixtures tipados e ferramentas que rejeitam YAML
  • Espere que comentários desapareçam ao ir de YAML para JSON - JSON não tem sintaxe de comentário
  • Coloque aspas em escalares ambíguos (NO, números de versão) quando a segurança de tipos importar

Privacidade - converta localmente, não envie configs

Arquivos Compose, referências a segredos em workflows e manifests de cluster costumam nomear hosts internos, registros de imagem e chaves de ambiente. Conversão no navegador mantém esse texto no seu dispositivo: cole YAML, copie JSON, pronto. Esse é o ponto de um conversor local versus um pastebin com upload. Abra DevTools Network enquanto converte se quiser provar que nada saiu da aba. A página da ferramenta cobre buscas transacionais como yaml to json converter; este artigo cobre o porquê DevOps.

Um fluxo prático

  • Mantenha YAML de Compose / Actions / Kubernetes no git como fonte editável
  • Abra o Conversor de YAML para JSON quando um consumidor precisar de JSON
  • Use YAML 1.2 CORE a menos que saiba que precisa de booleanos 1.1
  • Em fluxos multi-doc, confirme que o tamanho do array JSON bate com a contagem de documentos
  • Confira o censo de tipos por coerções silenciosas (problema da Noruega)
  • Opcional: Swap de volta para YAML, ou minifique JSON para um fixture compacto

Teste uma colagem real de Compose ou manifest

Resumos SERP explicam os formatos; não podem guardar com segurança sua config privada. Cole um compose.yaml, workflow ou Deployment real e converta localmente.

Perguntas frequentes

Docker Compose deve continuar em YAML ou virar JSON?

Mantenha Compose em YAML no repositório - é isso que Docker e a maioria dos times esperam. Converta para JSON só quando um harness de teste, API ou ferramenta interna precisar de um objeto. Não mantenha duas cópias editadas à mão.

Como arquivos YAML multi-documento viram JSON?

Documentos separados por --- viram um array JSON na ordem da fonte. Um array de objetos pode fazer Swap de volta para um fluxo YAML separado por ---.

Por que o código de país NO virou false?

Isso é o problema da Noruega sob YAML 1.1. Mude para YAML 1.2 CORE, ou coloque aspas no valor como "NO", para que permaneça string em JSON.

Meu YAML é enviado quando converto?

Não no ToolsMinify. A análise roda no navegador, então manifests com segredos e hostnames internos ficam no seu dispositivo.

Converta YAML sem enviar

Abra o Conversor de YAML para JSON gratuito, cole YAML de Compose, Actions ou Kubernetes, escolha YAML 1.2 e copie JSON - privado, no navegador.

Use o Conversor YAML para JSON - de graça

Abra a ferramenta e aplique o que você aprendeu neste guia.

Abrir Conversor YAML para JSON

Artigos relacionados