JSON a YAML de Docker Compose

Genera un compose.yaml válido a partir de JSON, con puertos y valores de entorno entrecomillados de forma segura.

Opciones de salida

JSONentrada

Vacío

YAMLsalida

La salida YAML aparece aquí

Se ejecuta íntegramente en tu navegador: no se sube nada. Se aplican límites de uso razonable (5 MB por entrada, conversiones con límite de frecuencia) para evitar el spam y los bots.

Cargar desde URL

Tu navegador obtiene el archivo directamente, por lo que el servidor debe permitir solicitudes de origen cruzado.

Atajos de teclado

Ctrl / ⌘ + Enter Convertir ahora
Ctrl / ⌘ + S Descargar la salida
Alt + Shift + C Copiar la salida
Alt + Shift + F Reparar y formatear el JSON de entrada
Alt + Shift + S Invertir la dirección
Alt + Shift + T Alternar entre las vistas de código, árbol y mapa
Ctrl / ⌘ + Z Deshacer, incluidos Formatear, Reparar y Borrar
Esc Salir de pantalla completa
Tamaño del texto del editor

Puertos y valores de entorno, entrecomillados de forma segura

Los archivos Compose los leen analizadores de YAML 1.1, en los que 22:22 es un número en base 60 y NO es false. Cada cadena ambigua se entrecomilla para que los servicios arranquen con los valores que escribiste.

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'

Mantén Seguro para YAML 1.1 activado en los archivos Compose. Desactívalo arriba para ver 22:22 escrito sin comillas y lo que hace con él un analizador de YAML 1.1.

Comprueba el resultado con Docker

docker compose config valida el archivo y muestra el modelo final, y también puede mostrarlo como 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'

Consejos para Compose

Usa compose.yaml

Es el nombre de archivo preferido. docker-compose.yml sigue funcionando en proyectos antiguos.

Quita la clave version

El campo version de nivel superior está obsoleto; Docker Compose actual lo ignora y muestra una advertencia.

Listas o mapas para env

environment acepta un mapa (KEY: value) o una lista (- KEY=value). Los mapas que salen de objetos JSON son más fáciles de leer.

Más herramientas

Conversores, validadores y guías paso a paso para cada lugar donde se encuentran JSON y YAML.

Preguntas frecuentes

¿Cómo convierto JSON en un archivo Docker Compose?

Pega el JSON en el editor y copia el YAML de la derecha en compose.yaml. Mantén las claves de nivel superior services, volumes y networks, y luego ejecuta docker compose config para comprobar el resultado.

¿Por qué van entre comillas los mapeos de puertos como "80:80"?

Los analizadores de YAML 1.1 leen los números sin comillas separados por dos puntos, como 22:22, como enteros en base 60. Docker recomienda entrecomillar siempre los mapeos de puertos, y el conversor lo hace por ti mientras «Seguro para YAML 1.1» esté activado.

¿El archivo debe llamarse compose.yaml o docker-compose.yml?

compose.yaml es el nombre preferido en la especificación actual de Compose; docker-compose.yml y docker-compose.yaml se siguen leyendo por compatibilidad con versiones anteriores.

¿Sigo necesitando la clave version?

No. La clave version de nivel superior está obsoleta en la especificación de Compose y Docker Compose la ignora mostrando una advertencia. Puedes omitirla.

¿Puedo convertir un archivo Compose de nuevo a JSON?

Sí. Cambia la dirección a YAML → JSON o ejecuta docker compose config --format json, que además resuelve variables, extends y perfiles.