What is a YAML manifest?

Lauren

A YAML manifest is a configuration file written in YAML format that defines how resources should be created and managed in systems like Kubernetes. It describes objects such as Pods, Deployments, Services, and ConfigMaps in a structured, human-readable way. YAML manifests enable declarative infrastructure, where the desired state is defined and automatically maintained by the system. How does your team manage and version-control YAML manifests in your deployment workflows?

Christopher

Our team manages and version-controls YAML manifests using Git-based workflows, ensuring that all configuration files are stored in a central repository with clear version history. Each manifest, whether for Pods, Deployments, Services, or ConfigMaps, is checked into our Git repository alongside application code. This allows for tight integration with our CI/CD pipelines, where GitOps principles are followed—any changes to YAML manifests are automatically validated, tested, and deployed through the pipeline. We use tools like Helm for managing complex configurations and templating, making it easier to handle environment-specific variations. To track and manage changes, we follow a branching strategy that includes pull requests for any updates to the manifests, ensuring that all changes are peer-reviewed before being merged. Additionally, we enforce Git hooks and integrate with tools like Kubeval to validate YAML syntax and Kubernetes compatibility before deployment. This approach ensures traceability, reproducibility, and a reliable configuration management process, which is crucial for maintaining consistency and stability across environments.