# YAML examples

```json metadata
{
  "title": "YAML examples",
  "description": "Example YAML files for deploying Redis Enterprise on Kubernetes with different configurations.",
  "categories": ["docs","operate","kubernetes"],
  "tableOfContents": {"sections":[{"children":[{"id":"download-and-customize","title":"Download and customize"},{"id":"configuration-storage","title":"Configuration storage"},{"id":"applying-yaml-files","title":"Applying YAML files"},{"id":"monitoring-deployment","title":"Monitoring deployment"}],"id":"how-to-use-these-examples","title":"How to use these examples"},{"id":"example-categories","title":"Example categories"},{"id":"best-practices","title":"Best practices"},{"id":"related-documentation","title":"Related documentation"}]}

,
  "codeExamples": []
}
```
This section provides complete YAML examples that cover common Redis Enterprise for Kubernetes deployment scenarios. Each example includes the necessary configuration files and step-by-step instructions for editing and applying them.

## How to use these examples

### Download and customize

1. Copy the YAML content from the examples below
2. Save each YAML block to a separate file with a descriptive name
3. Edit the configuration values to match your environment
4. Apply the files in the correct order using `kubectl apply`

### Configuration storage

Redis Enterprise for Kubernetes stores configuration in several places:

- Custom resources: Cluster and database specifications are stored as Kubernetes custom resources (REC, REDB, REAADB, RERC)
- Secrets: Sensitive data like passwords and certificates are stored in Kubernetes secrets
- ConfigMaps: Non-sensitive configuration data is stored in ConfigMaps
- RBAC resources: Permissions are defined through Roles, ClusterRoles, and their bindings

### Applying YAML files

Apply YAML files using `kubectl apply`:

```bash
# Apply a single file
kubectl apply -f my-config.yaml

# Apply multiple files
kubectl apply -f rbac/ -f cluster/ -f database/

# Validate files without applying
kubectl apply --dry-run=client -f my-config.yaml
```

### Monitoring deployment

Check the status of your resources after applying:

```bash
# Check operator deployment
kubectl get deployment redis-enterprise-operator

# Check cluster status
kubectl get rec
kubectl describe rec <cluster-name>

# Check database status
kubectl get redb
kubectl describe redb <database-name>

# View events for troubleshooting
kubectl get events --sort-by=.metadata.creationTimestamp
```

## Example categories

- [Basic deployment examples](https://redis.io/docs/latest/operate/kubernetes/reference/yaml/basic-deployment) - Service account, RBAC, cluster, and database configurations
- [Rack awareness examples](https://redis.io/docs/latest/operate/kubernetes/reference/yaml/rack-awareness) - Rack-aware cluster configuration and required RBAC
- [Active-Active examples](https://redis.io/docs/latest/operate/kubernetes/reference/yaml/active-active) - Multi-cluster Active-Active database setup
- [Multi-namespace examples](https://redis.io/docs/latest/operate/kubernetes/reference/yaml/multi-namespace) - Cross-namespace operator and cluster configurations
- [Log collector RBAC examples](https://redis.io/docs/latest/operate/kubernetes/reference/yaml/log-collector-rbac) - RBAC permissions for log collection in restricted and all modes

## Best practices

- Validate configuration: Use `kubectl apply --dry-run=client` to validate YAML syntax and object schemas before applying
- Version control: Store your customized YAML files in version control
- Resource naming: Use consistent, descriptive names for all resources

## Related documentation

- [Reference](https://redis.io/docs/latest/operate/kubernetes/reference) - Complete API specifications for all custom resources
- [Deploy Redis Enterprise Software for Kubernetes](https://redis.io/docs/latest/operate/kubernetes/deployment/quick-start) - Step-by-step deployment instructions
- [Manage databases in multiple namespaces](https://redis.io/docs/latest/operate/kubernetes/re-clusters/multi-namespace) - Detailed multi-namespace setup instructions
- [Active-Active databases](https://redis.io/docs/latest/operate/kubernetes/active-active) - Active-Active configuration and management