JSON en YAML Docker Compose

Générez un compose.yaml valide à partir de JSON, avec ports et valeurs d'environnement mis entre guillemets.

Options de sortie

JSONentrée

Vide

YAMLsortie

La sortie YAML s'affiche ici

Fonctionne entièrement dans votre navigateur: rien n'est envoyé. Des limites d'usage raisonnable s'appliquent (5 MB par entrée, nombre de conversions limité) pour éviter le spam et les robots.

Charger depuis une URL

Le fichier est récupéré directement par votre navigateur : le serveur doit donc autoriser les requêtes cross-origin.

Raccourcis clavier

Ctrl / ⌘ + Enter Convertir maintenant
Ctrl / ⌘ + S Télécharger la sortie
Alt + Shift + C Copier la sortie
Alt + Shift + F Réparer et formater le JSON d'entrée
Alt + Shift + S Inverser le sens
Alt + Shift + T Basculer entre les vues code, arbre et correspondance
Ctrl / ⌘ + Z Annuler, y compris Formater, Réparer et Effacer
Esc Quitter le plein écran
Taille du texte de l'éditeur

Ports et valeurs d'environnement, entre guillemets en toute sécurité

Les fichiers Compose sont lus par des analyseurs YAML 1.1, pour lesquels 22:22 est un nombre en base 60 et NO vaut false. Chaque chaîne ambiguë est mise entre guillemets pour que les services démarrent avec les valeurs que vous avez écrites.

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'

Laissez Compatible YAML 1.1 activé pour les fichiers Compose. Désactivez-le ci-dessus pour voir 22:22 écrit sans guillemets, et ce qu'en fait un analyseur YAML 1.1.

Vérifier le résultat avec Docker

docker compose config valide le fichier et affiche le modèle final, y compris au format 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'

Conseils pour Compose

Utilisez compose.yaml

C'est le nom de fichier recommandé. docker-compose.yml fonctionne toujours pour les projets plus anciens.

Supprimez la clé version

Le champ version de premier niveau est obsolète ; Docker Compose actuel l'ignore et affiche un avertissement.

Listes ou maps pour env

environment accepte une map (KEY: value) ou une liste (- KEY=value). Les maps issues d'objets JSON sont plus faciles à lire.

Autres outils

Convertisseurs, validateurs et guides pas à pas pour tous les endroits où JSON et YAML se croisent.

Questions fréquentes

Comment convertir du JSON en fichier Docker Compose ?

Collez le JSON dans l'éditeur et copiez le YAML de droite dans compose.yaml. Conservez les clés de premier niveau services, volumes et networks, puis lancez docker compose config pour vérifier le résultat.

Pourquoi les mappages de ports comme "80:80" sont-ils entre guillemets ?

Les analyseurs YAML 1.1 lisent les nombres sans guillemets séparés par des deux-points, comme 22:22, comme des entiers en base 60. Docker recommande de toujours mettre les mappages de ports entre guillemets, et le convertisseur le fait pour vous tant que « Compatible YAML 1.1 » est activé.

Le fichier doit-il s'appeler compose.yaml ou docker-compose.yml ?

compose.yaml est le nom recommandé par la spécification Compose actuelle ; docker-compose.yml et docker-compose.yaml sont toujours lus pour des raisons de rétrocompatibilité.

La clé version est-elle encore nécessaire ?

Non. La clé version de premier niveau est obsolète dans la spécification Compose et Docker Compose l'ignore en affichant un avertissement. Vous pouvez l'omettre.

Puis-je reconvertir un fichier Compose en JSON ?

Oui. Passez le sens à YAML → JSON, ou exécutez docker compose config --format json, qui résout aussi les variables, les extends et les profils.