[{"_1":2,"_178":-5,"_179":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_152":153},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_85":-5,"_86":87,"_143":-5,"_144":11,"_145":17,"_146":11,"_147":-5,"_148":11,"_149":-5,"_150":151},"canonicalUrl","https://hub.docker.com/r/drumsergio/redis-operator/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","drumsergio","reponame","redis-operator","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_54":31,"_28":29,"_55":56,"_57":40,"_58":59,"_60":61,"_62":63,"_64":-5,"_65":59,"_66":67,"_68":11,"_69":29,"_70":71,"_76":11,"_77":78,"_82":29,"_83":84},"categories",[],"content_types",[40],"image","date_registered","2025-05-17T14:08:56.630358Z","description","","is_private","last_updated","2026-06-07T19:02:22.517698Z","last_modified","2026-04-11T13:25:10.194262Z","media_types",[52,53],"application/vnd.docker.container.image.v1+json","application/vnd.oci.image.index.v1+json","name","pull_count",1873,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

\n $\"Redis$ \n

\n\n

Redis Operator

\n\n

\n $\"codecov\"/$ \n

\n\n

\n Redis Operator for Kubernetes (Proof-of-Concept).\n

\n\n---\n\nA lightweight Kubernetes Operator that manages single-node Redis instances defined through a Custom Resource (CR).\n\n## Features\n\n* Automated, **immutable, secure password** generation stored in a Secret\n* Declarative **CPU / memory requests & limits**\n* Simple **scaling** through `spec.replicas`\n* **Health watch** -- emits a Warning event on the Redis CR when a Pod restarts\n three or more times\n* Automatic **clean-up** via OwnerReferences (Deployments, Pods and Secret are\n removed when the CR is deleted)\n\n## Quick Start\n\nPrerequisites: a working `kubectl` context, `kubectl apply` permissions and Kubernetes between v1.26 and v1.33 (included).\n\n### 1) Install CRDs and Operator in your Kubernetes Cluster:\n\n**Option A** - apply published manifest (no clone required):\n```bash\nkubectl apply -f https://raw.githubusercontent.com/GeiserX/redis-operator/main/config/deploy-redis-operator.yaml\n```\n\n**Option B** - build & deploy from source:\n```bash\ngit clone https://github.com/GeiserX/redis-operator.git\ncd redis-operator\nmake docker-build IMG=docker.io//redis-operator:\nmake deploy IMG=docker.io//redis-operator:\n```\n\nOr use my prebuild image (`latest` always available too):\n```bash\nmake deploy IMG=docker.io/drumsergio/redis-operator:0.0.1\n```\n\n**In any case***: Verify that the controller manager pod is running:\n```bash\nkubectl -n redis-operator-system get pods\n```\n\n### 2) Deploy a Redis instance (Example Redis CR):\n\nCreate a file `redis-cr.yaml` with the following contents, as an example:\n\n```yaml\napiVersion: cache.geiser.cloud/v1alpha1\nkind: Redis\nmetadata:\n name: redis-demo\n namespace: default\n labels:\n app.kubernetes.io/name: redis-demo\nspec:\n # ────────────── scale ──────────────\n replicas: 1\n\n # ───────────── image ──────────────\n image: bitnami/redis:8.0\n\n # ───────── resource requests / limits ─────────\n resources:\n requests:\n cpu: \"200m\"\n memory: \"256Mi\"\n limits:\n cpu: \"500m\"\n memory: \"512Mi\"\n\n # ───────── probes ─────────\n probes:\n liveness:\n command: [\"sh\", \"-c\", \"redis-cli -a \\\"$REDIS_PASSWORD\\\" PING\"]\n initialDelaySeconds: 20\n periodSeconds: 10\n timeoutSeconds: 3\n failureThreshold: 5\n readiness:\n command: [\"sh\", \"-c\", \"redis-cli -a \\\"$REDIS_PASSWORD\\\" SET readiness_probe OK\"]\n initialDelaySeconds: 5\n periodSeconds: 5\n timeoutSeconds: 3\n failureThreshold: 3\n```\n\nAnd then apply:\n```bash\nkubectl apply -f redis-cr.yaml\n```\n\n## Checks\n\n### Check the status of the Redis instance\n\nConfirm that Redis is up (if name and namespace are as default):\n\n```bash\nkubectl get redis redis-demo\nkubectl get deploy,po -l app=redis-demo -w\n```\n\n### Check the password\nTo retrieve the password in use:\n\n```bash\nkubectl get secret my-redis-secret -o jsonpath='{.data.password}' | base64 --decode\n```\n\n### Check working condition locally\nOptionally, you could test the instance locally with `redis-cli`, possibly including more tests on your side:\n```bash\n# port-forward a Redis pod on 6379\nkubectl port-forward deploy/my-redis-deployment 6379:6379 &\nredis-cli -a \"$(kubectl get secret my-redis-secret -o jsonpath='{.data.password}' | base64 --decode)\" PING\n```\n\n## Updating a Redis Instance\n\nIncreasing replicas (e.g. to 3):\n\n```bash\nkubectl patch redis my-redis --type merge -p='{\"spec\":{\"replicas\":3}}'\n```\nYou could also edit the Redis CR and reapply.\n\nChanging CPU limits (e.g. to 1):\n\n```bash\nkubectl patch redis my-redis --type merge -p='{\"spec\":{\"resources\":{\"limits\":{\"cpu\":\"1\"}}}}'\n```\n\n## Operator health watch\n\nIf any Redis pod restarts three or more times the operator emits a Warning event on the Redis CR:\n\n```bash\nkubectl get events --field-selector involvedObject.kind=Redis\n```\n\n## Tests\n\nIf you would like to execute the tests, make sure exactly you already installed the Operator Framework CLI tooling and execute the following:\n```bash\nmake envtest\nexport KUBEBUILDER_ASSETS=\"$(pwd)/bin/k8s/$(go env GOOS)/$(go env GOARCH)\"\nmake test\n```\n\n## Limitations\n\nThis Redis Operator is explicitly developed as a Proof-Of-Concept (PoC) demonstrating Kubernetes Operator patterns. It has limitations as stated:\n\n- Scaling Limitations: It scales by adding/removing independent Redis Pods.\n\n- It does not provision Redis Clusters or implement highly available Redis (no Redis Sentinel or Redis Cluster).\n\n- PVC / persistence, Service, Ingresses, TLS, Autoscaling, Observability is not included in this PoC\n\n- StatefulSet not implemented as it was only a PoC\n\n- Cleanup based in OwnerReference instead of finalizers (if it is removed, the K8s garbage collector will not delete it)\n\n- Verified with Bitnami Redis 6.2, 7.2 and 8.0 images. Other images or major versions should work but are untested.\n\n## Maintainers\n\n[@GeiserX](https://github.com/GeiserX)\n\n## Contributing\n\nFeel free to dive in! [Open an issue](https://github.com/GeiserX/redis-operator/issues/new) or submit PRs. Currently, only the `dev` branch is used for development purposes, and `main` for releases.\n\nRedis Operator (PoC) follows the [Contributor Covenant](http://contributor-covenant.org/version/2/1/) Code of Conduct.\n","has_starred","hub_user","immutable_tags_settings",{"_72":11,"_73":74},"enabled","rules",[75],".*","is_automated","permissions",{"_79":17,"_80":11,"_81":11},"read","write","admin","user","storage_size",469575564,"orgData","recentTags",[88,132],{"_89":40,"_90":91,"_92":93,"_94":95,"_96":97,"_98":99,"_46":121,"_122":91,"_123":29,"_124":53,"_54":125,"_126":127,"_128":106,"_129":121,"_130":63,"_131":17},"content_type","creator",870817,"digest","sha256:c9f23c0a3e8d2b87ce426c85cdf3e8eefbf905107c88b7dd4cad4ba640ca8e0a","full_size",33768360,"id",900755310,"images",[100,115],{"_101":102,"_92":103,"_104":44,"_105":106,"_107":108,"_109":110,"_111":44,"_112":-5,"_113":95,"_60":63,"_114":-5},"architecture","amd64","sha256:562ca7576455e231b4c5f0c3bbdc831d5455cddaa825e8fb15b5e2462b6ad5e7","features","last_pulled","2026-09-21T15:18:08.336509054Z","last_pushed","2026-06-07T19:02:18.78256436Z","os","linux","os_features","os_version","size","variant",{"_101":116,"_92":117,"_104":44,"_105":118,"_107":119,"_109":116,"_111":44,"_112":-5,"_113":120,"_60":63,"_114":-5},"unknown","sha256:391579f09a70daa6b63076086729c08b8518d6716d150dfb5f1be5111e106c94","2026-09-16T15:49:25.931936784Z","2026-06-07T19:02:20.157557237Z",37878,"2026-06-07T19:02:21.355627Z","last_updater","last_updater_username","media_type","latest","repository",27413076,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_89":40,"_90":91,"_92":133,"_94":134,"_96":135,"_98":136,"_46":141,"_122":91,"_123":29,"_124":52,"_54":142,"_126":127,"_128":139,"_129":141,"_130":63,"_131":17},"sha256:884ee47b60e0977007a82773c85da0aca30ab7632b84a88705376ce1f3d902de",29829070,900752125,[137],{"_101":138,"_92":133,"_104":44,"_105":139,"_107":140,"_109":110,"_111":44,"_112":-5,"_113":134,"_60":63,"_114":-5},"arm64","2026-09-20T23:22:26.940082296Z","2025-05-19T19:25:20.619117185Z","2025-05-19T19:25:29.542661Z","0.0.1","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":154,"_161":162,"_150":176,"_177":11},{"_36":155,"_38":156,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":157,"_54":31,"_28":29,"_55":56,"_57":40,"_58":59,"_60":61,"_62":63,"_64":-5,"_65":59,"_66":67,"_68":11,"_69":29,"_70":158,"_76":11,"_77":160,"_82":29,"_83":84},[],[40],[52,53],{"_72":11,"_73":159},[75],{"_79":17,"_80":11,"_81":11},"tags",{"_163":164,"_165":-5,"_166":-5,"_167":168},"count",2,"next","previous","results",[169,173],{"_89":40,"_90":91,"_92":93,"_94":95,"_96":97,"_98":170,"_46":121,"_122":91,"_123":29,"_124":53,"_54":125,"_126":127,"_128":106,"_129":121,"_130":63,"_131":17},[171,172],{"_101":102,"_92":103,"_104":44,"_105":106,"_107":108,"_109":110,"_111":44,"_112":-5,"_113":95,"_60":63,"_114":-5},{"_101":116,"_92":117,"_104":44,"_105":118,"_107":119,"_109":116,"_111":44,"_112":-5,"_113":120,"_60":63,"_114":-5},{"_89":40,"_90":91,"_92":133,"_94":134,"_96":135,"_98":174,"_46":141,"_122":91,"_123":29,"_124":52,"_54":142,"_126":127,"_128":139,"_129":141,"_130":63,"_131":17},[175],{"_101":138,"_92":133,"_104":44,"_105":139,"_107":140,"_109":110,"_111":44,"_112":-5,"_113":134,"_60":63,"_114":-5},[],"canDeleteTags","actionData","errors"]

drumsergio/redis-operator

Tags for drumsergio/redis-operator