JSON para YAML do Kubernetes

Converta a saída JSON do kubectl e objetos da API em manifests limpos para revisar e aplicar.

Opções de saída

JSONentrada

Vazio

YAMLsaída

A saída YAML aparece aqui

Funciona inteiramente no seu navegador: nada é enviado. Limites de uso justo se aplicam (5 MB por entrada, conversões com limite de frequência) para evitar spam e bots.

Carregar de URL

O arquivo é buscado diretamente pelo seu navegador, portanto o servidor precisa permitir requisições de outras origens.

Atalhos de teclado

Ctrl / ⌘ + Enter Converter agora
Ctrl / ⌘ + S Baixar a saída
Alt + Shift + C Copiar a saída
Alt + Shift + F Corrigir e formatar o JSON de entrada
Alt + Shift + S Inverter a direção
Alt + Shift + T Alternar entre as visualizações de código, árvore e mapa
Ctrl / ⌘ + Z Desfazer, inclusive Formatar, Corrigir e Limpar
Esc Sair da tela cheia
Tamanho do texto do editor

Do JSON do kubectl a um manifest limpo

Objetos exportados trazem campos de status e de controle que o próprio cluster define. Remova-os primeiro, depois converta, e o resultado poderá ser aplicado em qualquer lugar.

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

Cole o web.json acima ou faça upload dele.

Valores de ambiente continuam strings

O API server rejeita um valor env que não seja string. Valores que parecem booleanos, números ou versões recebem aspas automaticamente.

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'

Desative Seguro para YAML 1.1 para ver quais valores um parser YAML 1.1 leria errado.

Um objeto por documento

Cole o array items de uma List do kubectl e ative "Multidocumento" para obter um único arquivo com --- entre os objetos.

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

Mais ferramentas

Conversores, validadores e guias passo a passo para cada lugar onde JSON e YAML se encontram.

Perguntas frequentes

Como converto JSON do Kubernetes para YAML?

Cole o objeto JSON no editor, por exemplo a saída de kubectl get deployment web -o json. O manifest YAML aparece à direita. Remova campos gerenciados pelo cluster, como status e metadata.managedFields, antes de aplicá-lo em outro cluster.

Como transformo uma List do kubectl em manifests separados?

O kubectl get com vários objetos retorna {"kind": "List", "items": [...]}. Cole só o array items e ative "Multidocumento": cada objeto vira um documento próprio separado por ---, que é o formato usual de um arquivo de manifests.

Por que alguns valores de variáveis de ambiente ficam entre aspas?

O Kubernetes exige que os valores env sejam strings. Sem aspas, true, 8080 ou no seriam lidos como booleano ou número, e o API server rejeitaria o manifest. O conversor coloca aspas em toda string que poderia ser mal interpretada, para que o YAML signifique exatamente o mesmo que o JSON.

O kubectl apply aceita JSON diretamente?

Sim, o kubectl apply -f aceita JSON além de YAML. As equipes ainda convertem para YAML porque ele é mais fácil de revisar em pull requests, aceita comentários e é o que charts do Helm e overlays do Kustomize esperam.

O conversor valida meu manifest contra a API do Kubernetes?

Não, ele converte apenas a sintaxe. Rode kubectl apply --dry-run=server -f manifest.yaml para que o API server valide campos e tipos sem alterar nada.