Quickstart using the 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.

Before you begin

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

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

    Go to the project selector page

  3. Make sure that billing is enabled for your Google Cloud project. Learn how to confirm billing is enabled for your project.

  4. Enable the Service Networking API for your project.
    Enable the Service Networking API
  5. 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 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 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.

  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

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:

    Get greeting
    END
    Set greeting 1 0 11
    hello world
    STORED
    Get greeting
    VALUE greeting 1 11
    hello world
    END
    

Memorystore for Memcached supports standard open source Memcached libraries.

Clean up

  1. Go to the Memorystore for Memcached page in the 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