managed-memcached module

Table of Contents

• Overview
• Prerequisites
• Installation
  • 1. Enable the Module
  • 2. Verify Installation
  • 3. Create Your First Instance
• Documentation

Overview

The Managed Memcached Operator is a Kubernetes operator that simplifies the deployment and management of Memcached instances in your cluster. It provides:

• Automated Deployment: Deploy Memcached instances with a simple YAML configuration
• High Availability: Support for both standalone (Standalone) and group (Group) deployments
• Configuration Management: Flexible configuration with validation and constraints through MemcachedClass
• Resource Management: Automatic resource allocation and scaling
• Monitoring: Built-in status tracking and health monitoring
• Security: Distroless images and proper RBAC configuration
• Validation: CEL rules for configuration validation

Prerequisites

Before using the Managed Memcached Operator, ensure you have:

• Deckhouse Platform version >= 1.72
• Kubernetes version >= 1.30
• kubectl configured to access your cluster
• Sufficient cluster resources for Memcached instances
• Administrator rights for creating Custom Resources

Installation

1. Enable the Module

# Enable the managed-memcached module:
kubectl -n d8-system exec svc/deckhouse-leader -- deckhouse-controller module enable managed-memcached

2. Verify Installation

# Check if module is enabled and in Ready phase
kubectl get module managed-memcached

# Check module status via yaml description
kubectl get module managed-memcached -o yaml 

# Check default MemcachedClass
kubectl get memcachedclass default

# Check operator status
kubectl get pods -n d8-managed-memcached

3. Create Your First Instance

After successful installation, create a simple Memcached instance:

apiVersion: managed-services.deckhouse.io/v1alpha2
kind: Memcached
metadata:
  name: basic-memcached
  namespace: default
spec:
  memcachedClassName: default
  type: Standalone
  instance:
    memory:
      size: "256Mi"
    cpu:
      cores: 1
      coreFraction: "5%"

If all checks pass successfully, the module is installed and ready to use!

Note: The module uses v1alpha2 API version. The previous v1alpha1 version is still supported through automatic conversion webhooks, so existing resources will continue to work without migration.

Documentation

For detailed information about using and managing the Managed Memcached module, please refer to:

• Administrator Guide — Complete guide for cluster administrators on managing MemcachedClass resources, defining policies, constraints, and validation rules (includes class examples)
• User Guide — Guide for users on creating and configuring Memcached instances (includes instance examples)
• Custom Resources — Reference documentation for Memcached and MemcachedClass CRDs