JSON to YAML Conversion for DevOps & Kubernetes
While JSON serves as the universal runtime serialization format for web APIs, microservices, and database stores, YAML (YAML Ain't Markup Language) is the undisputed standard for human-authored configuration in modern cloud-native ecosystems, including Kubernetes, Helm, Docker Compose, GitHub Actions, GitLab CI, and Ansible.
Converting JSON payloads into clean YAML replaces dense bracket nesting with human-scannable 2-space indentation, while preserving precise data typing, multiline strings, arrays, and nullability.
Structural Mapping: JSON Syntax to YAML 1.2
| Structure Type | JSON Representation | YAML Representation | DevOps Context / Notes |
|---|---|---|---|
| Key-Value Map | {"replicas": 3} | replicas: 3 | Quotes omitted for standard alphanumeric keys |
| List / Array | ["web", "db"] | - web - db | Indented hyphen notation per list element |
| Nested Object | {"spec": {"port": 80}} | spec: port: 80 | Strict 2-space indentation hierarchy |
| Multiline Text | "#!/bin/sh\necho hi" | | #!/bin/sh echo hi | Literal scalar block preserves shell script formatting |
| Boolean & Null | {"ok": true, "v": null} | ok: true v: null (or ~) | YAML 1.2 strict core schema boolean literals |
Multiline String Formatting: Literal (|) vs. Folded (>) Scalars
Essential for Kubernetes ConfigMaps, Nginx server blocks, and embedded bash scripts where exact newlines and indentation must remain intact:
entrypoint.sh: |
set -e
echo "Initializing pod container..."
exec node server.jsFolds newlines into spaces while preserving double newlines as paragraph breaks. Ideal for long commit messages and documentation fields:
description: >
This service routes incoming ingress
traffic to backend microservice clusters
with automatic TLS termination.YAML Parser Traps: The Norway Problem & Version Coercion
In older YAML 1.1 parsers (still found in some Python PyYAML defaults), the ISO 3166-1 country code for Norway (NO), as well as yes, on, and off, are parsed as boolean false and true. Always wrap two-letter country codes in quotes: country: "NO".
Writing version: 1.10 without quotes causes YAML parsers to interpret it as a floating-point number, converting it to 1.1. To preserve semantic versioning in Helm charts or CI configs, ensure string quoting is preserved: version: "1.10".
Kubernetes Manifest Conversion Example
Converting a Kubernetes API response or CRD schema from raw JSON to declarative YAML output:
apiVersion: apps/v1
kind: Deployment
metadata:
name: api-gateway
namespace: production
labels:
app.kubernetes.io/name: gateway
spec:
replicas: 3
selector:
matchLabels:
app: gateway
template:
metadata:
labels:
app: gateway
spec:
containers:
- name: proxy
image: nginx:1.25-alpine
ports:
- containerPort: 80
name: http
resources:
limits:
cpu: "500m"
memory: "256Mi"