Memorystore Memcached (beta)

Memorystore Memcached Instance

Enable API

gcloud services enable
gcloud services enable

Enabling this API may take a few minutes.

Enable Private Service Access

Memorystore Memcached requires Private Services Access to be enabled. See Establishing a private services access connection documentation for more information.

Reserve an IP address range to be used in a VPC, so that the Memcached instance's IP address can be allocated within this range:

gcloud beta compute addresses create reserved-range \
  --global --prefix-length=24 \
  --description=description --network=default \

This is a simplified range creation on the default VPC network. In a production environment, you should verify what the range should be and which VPC network to allocate in.

Establish peering so that Memorystore can allocate the IP address in the reserved range in the VPC.

gcloud services vpc-peerings connect \ \
  --ranges=reserved-range --network=default

Create an Instance

Create an instance and attach it to the default VPC.

gcloud beta memcache instances create orders-cache \
  --node-count=1 --node-cpu=1 --node-memory=1G --region=us-central1

Creating a Memcached instance may take a few minutes.

Get Instance IP Address

gcloud beta memcache instances describe orders-cache \
  --region=us-central1 --format="value("

The IP address is not a static IP address. If you create the instance, the IP address may be different.

Connect to Instance

See Memorystore connectivity options to see how to connect to a Memorystore instance from different computing environments.

Computing Environment

Compute Engine

Kubernetes Engine

App Engine Flexible

App Engine Standard

Cloud Run

Cloud Function

You can test quickly by creating a Compute Engine instance in a zone within the same region:

gcloud compute instances create test-memorystore-vm --zone=us-central1-c

SSH into the machine:

gcloud compute ssh test-memorystore-vm --zone=us-central1-c

Install redis-cli:

sudo apt-get update && sudo apt-get install -y telnet

Connect to the instance:


You can try different Memcached commands, for example, stats:

Trying ...
Connected to
Escape character is '^]'.
STAT pid 1
STAT uptime 1020
STAT time 1594348128
Connection closed by foreign host.

See Memcached commands for more information.

Spring Boot Cache

Spring Boot does not have a built-in Memcached support. However you can use a 3rd party Memcached starter to provide Spring Boot cache support, e.g.:


Add the 3rd party Memcached Spring Boot starter:



Configure the Memcached instance to connect to:

Enable Caching

Turn on caching capability explicitly with the @EnableCaching annotation:

class DemoApplication {


Once you configured the Spring Boot with Redis and enabled caching, you can use the @Cacheable annotation to cache return values.

class OrderService {
  private final OrderRepository orderRepository;
  public OrderService(OrderRepository orderRepository) {
    this.orderRepository = orderRepository;
  public Order getOrder(Long id) {

Last updated