Da JSON a YAML per Docker Compose

Genera un compose.yaml valido da JSON, con porte e valori d'ambiente messi tra virgolette in modo sicuro.

Opzioni di output

JSONinput

Vuoto

YAMLoutput

L'output YAML appare qui

Funziona interamente nel tuo browser: nulla viene caricato. Si applicano limiti di uso corretto (5 MB per input, numero di conversioni limitato) per prevenire spam e bot.

Carica da URL

Il file viene recuperato direttamente dal tuo browser, quindi il server deve consentire le richieste cross-origin.

Scorciatoie da tastiera

Ctrl / ⌘ + Enter Converti ora
Ctrl / ⌘ + S Scarica l'output
Alt + Shift + C Copia l'output
Alt + Shift + F Ripara e formatta il JSON di input
Alt + Shift + S Inverti la direzione
Alt + Shift + T Passa tra le viste codice, albero e mappa
Ctrl / ⌘ + Z Annulla, anche dopo Formatta, Ripara e Cancella
Esc Esci da schermo intero
Dimensione del testo nell'editor

Porte e valori d'ambiente, tra virgolette in modo sicuro

I file Compose vengono letti da parser YAML 1.1, dove 22:22 è un numero in base 60 e NO è false. Ogni stringa ambigua viene messa tra virgolette, così i servizi partono con i valori che hai scritto.

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'

Tieni attivo Sicuro per YAML 1.1 per i file Compose. Disattivalo qui sopra per vedere 22:22 scritto senza virgolette e come lo interpreta un parser YAML 1.1.

Verifica il risultato con Docker

docker compose config valida il file e stampa il modello finale, che può stampare anche in formato 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'

Consigli per Compose

Usa compose.yaml

È il nome di file preferito. docker-compose.yml funziona ancora per i progetti meno recenti.

Elimina la chiave version

Il campo version di primo livello è obsoleto; l'attuale Docker Compose lo ignora e stampa un avviso.

Liste o mappe per env

environment accetta una mappa (KEY: value) o una lista (- KEY=value). Le mappe ottenute da oggetti JSON sono più facili da leggere.

Altri strumenti

Convertitori, validatori e guide passo passo per ogni punto in cui JSON e YAML si incontrano.

Domande frequenti

Come converto JSON in un file Docker Compose?

Incolla il JSON nell'editor e copia lo YAML a destra in compose.yaml. Mantieni le chiavi di primo livello services, volumes e networks, poi esegui docker compose config per verificare il risultato.

Perché le mappature di porte come "80:80" sono tra virgolette?

I parser YAML 1.1 leggono i numeri senza virgolette separati da due punti, come 22:22, come interi in base 60. Docker consiglia di mettere sempre tra virgolette le mappature di porte, e il convertitore lo fa per te finché «Sicuro per YAML 1.1» è attivo.

Il file deve chiamarsi compose.yaml o docker-compose.yml?

compose.yaml è il nome preferito nell'attuale specifica Compose; docker-compose.yml e docker-compose.yaml vengono ancora letti per retrocompatibilità.

Serve ancora la chiave version?

No. La chiave version di primo livello è obsoleta nella specifica Compose e Docker Compose la ignora, stampando un avviso. Puoi ometterla.

Posso riconvertire un file compose in JSON?

Sì. Imposta la direzione su YAML → JSON, oppure esegui docker compose config --format json, che risolve anche variabili, extends e profili.