YAML and JSON Configuration Formats

What are YAML and JSON? When would you use each format in DevOps?

DevOpsbeginner

// interview question

What are YAML and JSON? When would you use each format in DevOps?

Sample answer

YAML (YAML Ain't Markup Language) and JSON (JavaScript Object Notation) are data serialization formats. YAML is human-readable with indentation-based syntax, supports comments, and is preferred for configuration files (Kubernetes, Ansible, CI/CD). JSON is more compact, has strict syntax, and is preferred for APIs and machine-to-machine communication. Both represent the same data structures: objects/maps, arrays/lists, and scalar values.

Why this matters

DevOps engineers work with YAML and JSON daily. Kubernetes manifests, Helm charts, GitHub Actions, and Ansible playbooks all use YAML. APIs typically return JSON. Understanding both formats and being able to convert between them is essential. Common pitfalls include YAML indentation errors and JSON trailing commas.

Code examples

YAML example

yaml

# YAML supports comments
app:
  name: myapp
  version: 1.0.0
  
  # Nested configuration
  database:
    host: localhost
    port: 5432
    
  # List/array
  environments:
    - development
    - staging
    - production
    
  # Boolean and null
  enabled: true
  deprecated: false
  optional_field: null
  
  # Multi-line string
  description: |
    This is a multi-line
    description block.

Equivalent JSON

json

{
  "app": {
    "name": "myapp",
    "version": "1.0.0",
    "database": {
      "host": "localhost",
      "port": 5432
    },
    "environments": [
      "development",
      "staging",
      "production"
    ],
    "enabled": true,
    "deprecated": false,
    "optional_field": null,
    "description": "This is a multi-line\ndescription block."
  }
}

Common mistakes to avoid

Using tabs instead of spaces in YAML (only spaces allowed)
Inconsistent indentation in YAML files
Trailing commas in JSON arrays/objects (not allowed)
Forgetting to quote strings with special characters in YAML

Likely follow-ups

What common YAML mistakes cause parsing errors?
How do you validate YAML or JSON files?
What tools can convert between YAML and JSON?

Answer out loud first, then check yourself against the model answer.

Practice all Junior questions More DevOps questions

#yaml#json#configuration#fundamentals#devops

Also worth your time on this topic

Article

How to Use Multiple Build Arguments in Docker Build

Learn how to pass multiple build-time variables to Docker builds using --build-arg, set default values in Dockerfiles, and use build arguments for environment-specific configurations.

Interview

CI/CD Pipeline Stages

What are the typical stages of a CI/CD pipeline and why is each stage important?

junior

Checklist

CI/CD Pipeline Setup Checklist

Step-by-step checklist for a production-ready CI/CD pipeline: source control, builds, tests, security scans, deploy gates, secrets, and rollback paths.

1-2 hours

YAML and JSON Configuration Formats

More DevOps interview questions

Also worth your time on this topic

How to Use Multiple Build Arguments in Docker Build

CI/CD Pipeline Stages

CI/CD Pipeline Setup Checklist