{
  "id": "basic-deployment",
  "title": "Basic deployment examples",
  "url": "https://redis.io/docs/latest/operate/kubernetes/8.0/reference/yaml/basic-deployment/",
  "summary": "YAML examples for basic Redis Enterprise deployment including RBAC, cluster, and database configurations.",
  "content": "\nThis page provides complete YAML examples for a basic Redis Enterprise deployment on Kubernetes. These examples include all the essential components you need to deploy a Redis Enterprise cluster and create a database.\n\nFor complete deployment instructions, see [Deploy on Kubernetes](https://redis.io/docs/latest/operate/kubernetes/deployment/quick-start).\n\n## Service account\n\nThe service account provides an identity for the Redis Enterprise operator.\n\n\n\nService account configuration:\n- `name`: The service account name used by the operator\n- `labels`: Standard labels for Redis Enterprise resources\n\n## Role\n\nThe Role defines the permissions needed by the Redis Enterprise operator within the namespace.\n\n\n\nRole configuration:\n- `name`: Must match the role name referenced in the role binding\n- `rules`: Comprehensive permissions for managing Redis Enterprise resources\n- `apiGroups`: Includes core Kubernetes APIs and Redis Enterprise custom resources\n\nKey permissions:\n- `app.redislabs.com`: Full access to Redis Enterprise custom resources\n- `secrets`: Manage TLS certificates and database credentials\n- `services`: Create and manage service endpoints\n- `pods`: Monitor and manage Redis Enterprise pods\n- `persistentvolumeclaims`: Manage persistent storage\n\n## Role binding\n\nThe RoleBinding connects the service account to the role, granting the necessary permissions.\n\n\n\nRole binding configuration:\n- `subjects.name`: Must match the service account name\n- `roleRef.name`: Must match the role name\n- `namespace`: Apply in the same namespace as other resources\n\n## Redis Enterprise cluster\n\nThe RedisEnterpriseCluster (REC) custom resource defines the cluster specification.\n\n\n\nCluster configuration:\n- `metadata.name`: Cluster name (cannot be changed after creation)\n- `spec.nodes`: Number of Redis Enterprise nodes (minimum 3)\n- `persistentSpec.volumeSize`: Storage size per node\n- `redisEnterpriseNodeResources`: CPU and memory allocation per node\n\nEdit the values in the downloaded YAML file based on your requirements, such as increasing the number of nodes, adjusting storage size, or modifying resource allocation.\n\n## Redis Enterprise database\n\nThe RedisEnterpriseDatabase (REDB) custom resource defines the database specification.\n\n\n\nDatabase configuration:\n- `metadata.name`: Database name\n- `spec.memorySize`: Memory allocation for the database\n- `spec.shardCount`: Number of shards (affects performance and scalability)\n- `spec.replication`: Enable/disable database replication\n\nEdit the values in the downloaded YAML file based on your requirements, such as increasing memory for larger datasets, adding more shards for better performance, enabling replication for high availability, or adding Redis modules.\n\n## Apply the configuration\n\nTo deploy these YAML files, follow [Deploy on Kubernetes](https://redis.io/docs/latest/operate/kubernetes/deployment/quick-start), which provides step-by-step instructions for creating namespaces, deploying the operator, and applying these configuration files.\n\n## Related documentation\n\n- [Deploy on Kubernetes](https://redis.io/docs/latest/operate/kubernetes/deployment/quick-start)\n- [REC API reference](https://redis.io/docs/latest/operate/kubernetes/reference/api/redis_enterprise_cluster_api)\n- [REDB API reference](https://redis.io/docs/latest/operate/kubernetes/reference/api/redis_enterprise_database_api)\n",
  "tags": ["docs","operate","kubernetes"],
  "last_updated": "2026-06-04T14:49:57+01:00"
}