JSON към Kubernetes YAML

Конвертирайте JSON изхода на kubectl и API обекти в чисти манифести, които можете да прегледате и приложите.

Опции за изхода

JSONвход

Празно

YAMLизход

Изходът YAML се появява тук

Работи изцяло във вашия браузър: нищо не се качва. Прилагат се ограничения за честна употреба (5 MB на вход, ограничен брой конвертирания) срещу спам и ботове.

Зареждане от URL

Файлът се изтегля директно от вашия браузър, затова сървърът трябва да разрешава заявки от друг произход (cross-origin).

Клавишни комбинации

Ctrl / ⌘ + Enter Конвертиране сега
Ctrl / ⌘ + S Изтегляне на изхода
Alt + Shift + C Копиране на изхода
Alt + Shift + F Поправяне и форматиране на входния JSON
Alt + Shift + S Размяна на посоката
Alt + Shift + T Превключване между изгледите код, дърво и карта
Ctrl / ⌘ + Z Отмяна, включително на „Форматирай“, „Поправи“ и „Изчисти“
Esc Изход от цял екран
Размер на текста в редактора

От kubectl JSON до чист манифест

Експортираните обекти носят статус и служебни полета, които клъстерът задава сам. Първо ги премахнете, после конвертирайте, и резултатът може да се приложи навсякъде.

bash
# Export a live object as JSON and strip the fields the cluster manages
kubectl get deployment web -o json \
  | jq 'del(.status, .metadata.uid, .metadata.resourceVersion,
            .metadata.creationTimestamp, .metadata.generation,
            .metadata.managedFields)' > web.json

Поставете web.json по-горе или го качете.

Стойностите на средата остават низове

API сървърът отхвърля env стойност, която не е низ. Стойностите, които приличат на булеви, числа или версии, автоматично се ограждат в кавички.

JSON
{
  "env": [
    {
      "name": "FEATURE_FLAG",
      "value": "true"
    },
    {
      "name": "PORT",
      "value": "8080"
    },
    {
      "name": "REGION",
      "value": "no"
    },
    {
      "name": "API_VERSION",
      "value": "1.20"
    }
  ]
}
YAML
env:
  - name: FEATURE_FLAG
    value: 'true'
  - name: PORT
    value: '8080'
  - name: REGION
    value: 'no'
  - name: API_VERSION
    value: '1.20'

Изключете Безопасно за YAML 1.1, за да видите кои стойности парсер за YAML 1.1 би прочел погрешно.

По един обект на документ

Поставете масива items на kubectl List и включете „Няколко документа“, за да получите един файл с --- между обектите.

items (JSON)
[
  {
    "apiVersion": "v1",
    "kind": "ConfigMap",
    "metadata": {
      "name": "web-config"
    },
    "data": {
      "LOG_LEVEL": "info"
    }
  },
  {
    "apiVersion": "v1",
    "kind": "Service",
    "metadata": {
      "name": "web"
    },
    "spec": {
      "selector": {
        "app": "web"
      },
      "ports": [
        {
          "port": 80
        }
      ]
    }
  }
]
manifests.yaml
---
apiVersion: v1
kind: ConfigMap
metadata:
  name: web-config
data:
  LOG_LEVEL: info
---
apiVersion: v1
kind: Service
metadata:
  name: web
spec:
  selector:
    app: web
  ports:
    - port: 80

Още инструменти

Конвертори, валидатори и ръководства стъпка по стъпка за всяко място, където се срещат JSON и YAML.

Често задавани въпроси

Как да конвертирам Kubernetes JSON към YAML?

Поставете JSON обекта, например изхода на kubectl get deployment web -o json, в редактора. YAML манифестът се появява отдясно. Премахнете управляваните от клъстера полета като status и metadata.managedFields, преди да го приложите в друг клъстер.

Как да превърна kubectl List в отделни манифести?

kubectl get с няколко обекта връща {"kind": "List", "items": [...]}. Поставете само масива items и включете „Няколко документа“: всеки обект става отделен документ, разделен с ---, което е обичайната подредба на файл с манифести.

Защо някои стойности на променливите на средата са в кавички?

Kubernetes изисква env стойностите да са низове. Без кавички true, 8080 или no биха се прочели като булева стойност или число и API сървърът би отхвърлил манифеста. Конверторът огражда в кавички всеки низ, който може да бъде прочетен погрешно, така че YAML означава точно това, което означаваше JSON.

Може ли kubectl да прилага JSON директно?

Да, kubectl apply -f приема JSON, както и YAML. Екипите все пак конвертират към YAML, защото е по-лесен за преглед в pull request, поддържа коментари и е това, което очакват Helm чартовете и Kustomize overlays.

Проверява ли конверторът манифеста ми спрямо Kubernetes API?

Не, той конвертира само синтаксиса. Изпълнете kubectl apply --dry-run=server -f manifest.yaml, за да може API сървърът да валидира полетата и типовете, без да променя нищо.