Utilisez compose.yaml
C'est le nom de fichier recommandé. docker-compose.yml fonctionne toujours pour les projets plus anciens.
Générez un compose.yaml valide à partir de JSON, avec ports et valeurs d'environnement mis entre guillemets.
Chaque ligne de la sortie, en mise en forme par défaut, à côté du chemin de la valeur qu'elle contient. Cliquez sur une ligne pour copier le chemin.
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.
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.
{
"services": {
"web": {
"image": "nginx:1.27",
"ports": [
"80:80",
"22:22"
],
"environment": {
"DEBUG": "false",
"WORKERS": "4",
"COUNTRY": "NO"
}
}
}
} 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.
docker compose config valide le fichier et affiche le modèle final, y compris au format JSON.
# 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' C'est le nom de fichier recommandé. docker-compose.yml fonctionne toujours pour les projets plus anciens.
Le champ version de premier niveau est obsolète ; Docker Compose actuel l'ignore et affiche un avertissement.
environment accepte une map (KEY: value) ou une liste (- KEY=value). Les maps issues d'objets JSON sont plus faciles à lire.
Convertisseurs, validateurs et guides pas à pas pour tous les endroits où JSON et YAML se croisent.
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.
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é.
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é.
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.
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.