JSON na YAML dla Docker Compose

Wygeneruj poprawny compose.yaml z JSON, z portami i wartościami środowiskowymi bezpiecznie ujętymi w cudzysłowy.

Opcje wyniku

JSONwejście

Pusto

YAMLwynik

Tutaj pojawi się wynik YAML

Działa w całości w przeglądarce: nic nie jest przesyłane. Obowiązują limity uczciwego użytkowania (5 MB na dane wejściowe, ograniczona liczba konwersji), aby zapobiegać spamowi i botom.

Wczytaj z adresu URL

Plik jest pobierany bezpośrednio przez przeglądarkę, więc serwer musi zezwalać na żądania cross-origin.

Skróty klawiszowe

Ctrl / ⌘ + Enter Konwertuj teraz
Ctrl / ⌘ + S Pobierz wynik
Alt + Shift + C Kopiuj wynik
Alt + Shift + F Napraw i sformatuj wejściowy JSON
Alt + Shift + S Zamień kierunek
Alt + Shift + T Przełączaj widoki: kod, drzewo i mapa
Ctrl / ⌘ + Z Cofnij, także po użyciu Formatuj, Napraw i Wyczyść
Esc Wyjdź z pełnego ekranu
Rozmiar tekstu w edytorze

Porty i wartości środowiskowe bezpiecznie w cudzysłowach

Pliki Compose są odczytywane przez parsery YAML 1.1, w których 22:22 to liczba w systemie sześćdziesiątkowym, a NO to false. Każdy niejednoznaczny ciąg trafia w cudzysłowy, więc usługi startują z wartościami, które zapisałeś.

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'

W plikach Compose pozostaw włączoną opcję Zgodność z YAML 1.1. Wyłącz ją powyżej, aby zobaczyć 22:22 zapisane bez cudzysłowu i to, co zrobi z nim parser YAML 1.1.

Sprawdź wynik za pomocą Dockera

docker compose config waliduje plik i wypisuje końcowy model, który może też wypisać jako 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'

Wskazówki dotyczące Compose

Używaj compose.yaml

To zalecana nazwa pliku. docker-compose.yml nadal działa w starszych projektach.

Usuń klucz version

Pole version na najwyższym poziomie jest przestarzałe; obecny Docker Compose je ignoruje i wyświetla ostrzeżenie.

Listy lub mapy dla env

environment przyjmuje mapę (KEY: value) lub listę (- KEY=value). Mapy powstałe z obiektów JSON łatwiej się czyta.

Więcej narzędzi

Konwertery, walidatory i przewodniki krok po kroku dla każdego miejsca, w którym spotykają się JSON i YAML.

Najczęściej zadawane pytania

Jak przekonwertować JSON na plik Docker Compose?

Wklej JSON do edytora i skopiuj YAML z prawej strony do compose.yaml. Zachowaj klucze najwyższego poziomu services, volumes i networks, a potem uruchom docker compose config, aby sprawdzić wynik.

Dlaczego mapowania portów, takie jak "80:80", są w cudzysłowach?

Parsery YAML 1.1 odczytują liczby bez cudzysłowów rozdzielone dwukropkami, takie jak 22:22, jako liczby całkowite w systemie sześćdziesiątkowym. Docker zaleca, aby zawsze ujmować mapowania portów w cudzysłowy, a konwerter robi to za Ciebie, dopóki włączona jest opcja „Zgodność z YAML 1.1”.

Plik powinien nazywać się compose.yaml czy docker-compose.yml?

compose.yaml to zalecana nazwa w obecnej specyfikacji Compose; docker-compose.yml i docker-compose.yaml są nadal odczytywane ze względu na zgodność wsteczną.

Czy klucz version jest nadal potrzebny?

Nie. Klucz version na najwyższym poziomie jest w specyfikacji Compose przestarzały, a Docker Compose go ignoruje i wyświetla ostrzeżenie. Możesz go pominąć.

Czy mogę przekonwertować plik compose z powrotem na JSON?

Tak. Zmień kierunek na YAML → JSON albo uruchom docker compose config --format json, które dodatkowo rozwiązuje zmienne, extends i profile.