JSON para YAML do Docker Compose

Gere um compose.yaml válido a partir de JSON, com portas e valores de ambiente entre aspas com segurança.

Opções de saída

JSONentrada

Vazio

YAMLsaída

A saída YAML aparece aqui

Funciona inteiramente no seu navegador: nada é enviado. Limites de uso justo se aplicam (5 MB por entrada, conversões com limite de frequência) para evitar spam e bots.

Carregar de URL

O arquivo é buscado diretamente pelo seu navegador, portanto o servidor precisa permitir requisições de outras origens.

Atalhos de teclado

Ctrl / ⌘ + Enter Converter agora
Ctrl / ⌘ + S Baixar a saída
Alt + Shift + C Copiar a saída
Alt + Shift + F Corrigir e formatar o JSON de entrada
Alt + Shift + S Inverter a direção
Alt + Shift + T Alternar entre as visualizações de código, árvore e mapa
Ctrl / ⌘ + Z Desfazer, inclusive Formatar, Corrigir e Limpar
Esc Sair da tela cheia
Tamanho do texto do editor

Portas e valores de ambiente com aspas seguras

Arquivos Compose são lidos por parsers YAML 1.1, em que 22:22 é um número de base 60 e NO é false. Toda string ambígua recebe aspas, para que os serviços iniciem com os valores que você escreveu.

JSON
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": [
        "80:80",
        "22:22"
      ],
      "environment": {
        "DEBUG": "false",
        "WORKERS": "4",
        "COUNTRY": "NO"
      }
    }
  }
}
compose.yaml
services:
  web:
    image: nginx:1.27
    ports:
      - '80:80'
      - '22:22'
    environment:
      DEBUG: 'false'
      WORKERS: '4'
      COUNTRY: 'NO'

Mantenha Seguro para YAML 1.1 ativado em arquivos Compose. Desative-o acima para ver 22:22 escrito sem aspas e o que um parser YAML 1.1 faz com ele.

Verifique o resultado com o Docker

O docker compose config valida o arquivo e mostra o modelo final, que também pode ser impresso em JSON.

bash
# Validate a compose file and print the fully resolved model
docker compose config

# The same model as JSON, e.g. to inspect it with jq
docker compose config --format json | jq '.services | keys'

Dicas de Compose

Use compose.yaml

É o nome de arquivo preferido. O docker-compose.yml ainda funciona em projetos mais antigos.

Remova a chave version

O campo version de nível superior está obsoleto; o Docker Compose atual o ignora e exibe um aviso.

Listas ou mapas para env

O environment aceita um mapa (KEY: value) ou uma lista (- KEY=value). Mapas gerados a partir de objetos JSON são mais fáceis de ler.

Mais ferramentas

Conversores, validadores e guias passo a passo para cada lugar onde JSON e YAML se encontram.

Perguntas frequentes

Como converto JSON em um arquivo Docker Compose?

Cole o JSON no editor e copie o YAML da direita para o compose.yaml. Mantenha as chaves de nível superior services, volumes e networks e depois rode docker compose config para verificar o resultado.

Por que mapeamentos de porta como "80:80" ficam entre aspas?

Parsers YAML 1.1 leem números sem aspas separados por dois-pontos, como 22:22, como inteiros de base 60. O Docker recomenda sempre colocar aspas nos mapeamentos de porta, e o conversor faz isso por você enquanto "Seguro para YAML 1.1" estiver ativado.

O arquivo deve se chamar compose.yaml ou docker-compose.yml?

compose.yaml é o nome preferido na especificação atual do Compose; docker-compose.yml e docker-compose.yaml ainda são lidos por compatibilidade com versões anteriores.

Ainda preciso da chave version?

Não. A chave version de nível superior está obsoleta na especificação do Compose, e o Docker Compose a ignora, exibindo um aviso. Você pode omiti-la.

Posso converter um arquivo compose de volta para JSON?

Sim. Mude a direção para YAML → JSON ou rode docker compose config --format json, que também resolve variáveis, extends e profiles.