Create a Memorystore for Memcached instance by using the Google Cloud console

Create a Memorystore for Memcached instance by using the Google Cloud console

This quickstart walks you through the steps to create a Memorystore for Memcached instance, connect to the instance, set a value, retrieve a value, and delete the instance.

Caution: You cannot create a Memorystore for Memcached instance without first having a private services access connection established. See Networking for details on the private services access connection that is required for Memorystore for Memcached.

Before you begin

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Service Networking API for your project.
   Enable the Service Networking API
7. Enable the Memorystore for Memcached API for your project.
   Enable the Memorystore for Memcached API

Creating a Memcached instance

1. Go to the Memorystore for Memcached page in the Google Cloud console.
   Memorystore for Memcached
   

2. Click the Create Instance button.

3. Select the configurations for your new instance on the Create a Memcached instance page in the Google Cloud console:

   • Enter an instance ID using only lowercase letters, numbers, and hyphens. Start with a letter.
     • For example, my-memcached-instance-1.
   • Choose us-central1 from the Region dropdown.
   • Choose Automatically distribute from the Zone dropdown.
   • Enter 2 under Nodes to create two nodes.
   • Choose 1 GB of Memory per node.
   • Choose 1 for Cores per node.

   • Select default for the Authorized network.

     Note: If you see the Private service connection required panel, you need to establish a private services access connection.

4. Click Create.

5. After the instance is created, click the instance ID to view the instance details page.

6. Write down the IP address of one of your nodes.

Connecting to your instance from a Compute Engine VM

Note: To connect to a Memcached instance, your client VM must be located in the same region, and must be connected to the same network, as your instance.

To test the connection:

1. Connect to a Linux VM. For steps to connect to a Linux VM, see Quickstart Using a Linux VM. If you used a Debian based image to create your VM instance as described in the quickstart, install telnet using apt-get:

   sudo apt-get install telnet
   

2. From the terminal, telnet to the IP address of one of the Memcached nodes. Replace node-ip-address with the IP address of your node.

   telnet node-ip-address 11211
   

   You should see the following output with the [bracketed-variables] replaced your project's variables:

   Trying [node-ip-address]…
   Connected to [node-ip-address]
   

3. In the telnet session, enter some Memcached commands:

   Enter:

   get greeting
   

   Result:

   END
   

   Enter:

   set greeting 1 0 11
   hello world
   

   Result:

   STORED
   

   Enter:

   get greeting
   

   Result:

   VALUE greeting 1 11
   hello world
   END
   

Memorystore for Memcached supports standard open source Memcached libraries.

Clean up

To avoid incurring charges to your Google Cloud account for the resources used on this page, follow these steps.

1. Go to the Memorystore for Memcached page in the Google Cloud console.
   Memorystore for Memcached
   

2. Click the ID of the instance you want to delete.

3. Click the Delete button.

4. In the prompt that appears, enter the instance's ID.

5. Click the Delete button.

What's next

• Connect to a Memcached instance.

• Use the Auto Discovery service.

• Monitor your Memcached instance.