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.
- Conversor de YAML para JSON - Ambas as direções com Swap, YAML 1.2 vs 1.1, arrays multi-doc, amostras DevOps - nada é enviado.
- Minificador e formatador JSON - formate ou minifique o resultado JSON para fixtures e payloads de API.
- JSON vs YAML vs CSV - comparação de formatos para aninhamento, tipos, comentários e quando cada um encaixa.
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.