Create a Memorystore for Redis instance by using the gcloud CLI

Learn how to create a new Memorystore for Redis instance, connect to it, and then delete it.

To follow step-by-step guidance for this task directly in the Google Cloud console, click Guide me :

Before you begin

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.

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

Roles required to select or create a project

Select a project : Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project : To create a project, you need the Project Creator role ( roles/resourcemanager.projectCreator ), which contains the resourcemanager.projects.create permission. Learn how to grant roles .

Go to project selector

Verify that billing is enabled for your Google Cloud project .

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

Roles required to select or create a project

Select a project : Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project : To create a project, you need the Project Creator role ( roles/resourcemanager.projectCreator ), which contains the resourcemanager.projects.create permission. Learn how to grant roles .

Go to project selector

Verify that billing is enabled for your Google Cloud project .

If you haven't already, install the Google Cloud CLI .
When prompted, choose the project that you selected or created above.
If you already have the Google Cloud CLI installed, update it.
```
gcloud components update
```

Creating a Memorystore for Redis instance

To create a Memorystore for Redis instance:

Open a terminal window.
Set the project you'd like to create your instance in as the default project in gcloud by entering the following command:
```
gcloud config set core/project PROJECT_ID 
```

Enter the following command to create a 2 GiB Basic Tier Redis instance in the us-central1 region:

gcloud redis instances create myinstance --size=2 --region=us-central1 \
    --redis-version=redis_6_x

After the instance is created, enter the describe command to get the IP address and port of the instance:

gcloud redis instances describe myinstance --region=us-central1

If successful, gcloud returns the following:

authorizedNetwork: projects/my-project/global/networks/default
createTime: '2018-04-09T21:47:56.824081Z'
currentLocationId: us-central1-a
host: 10.0.0.27
locationId: us-central1-a
memorySizeGb: 2
name: projects/my-project/locations/us-central1/instances/myinstance
networkThroughputGbps: 2
port: 6379
redisVersion: REDIS_6_X
reservedIpRange: 10.0.0.24/29
state: READY
tier: BASIC

You'll use the host and port values to connect to the instance.

Connecting to the Redis instance from a Compute Engine VM

You can connect to the Redis instance from any Compute Engine VM that uses the Redis instance's authorized network with a supported RFC 1918 IP address .

If you don't already have a Compute Engine VM that uses that same authorized network as your Redis instance, create one and connect to it by following Quickstart using a Linux VM .
Install telnet using apt-get :
```
 sudo apt-get install telnet 
```
From the terminal, telnet to the IP address of the Redis instance, replacing variables with appropriate values.
```
telnet instance-ip-address 
6379
```
If successful, the command will return this result:
```
Trying instance-ip-address 
…
Connected to instance-ip-address 
```
In the telnet session, enter some Redis commands:

Enter:
```
PING
```
Result:
```
PONG
```
Enter
```
SET HELLO WORLD
```
Result:
```
+OK
```
Enter:
```
GET HELLO
```
Result:
```
$5
WORLD
```

Clean up

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

To avoid incurring charges to your Google Cloud account for the resources used in this quickstart, delete the instance by entering the following command:
```
gcloud redis instances delete myinstance --region=us-central1
```

Enter Y to confirm the instance to delete:

You are about to delete instance [myinstance] in [us-central1].
Any associated data will be lost.
Do you want to continue (Y/n)? Y
Delete request issued for: [myinstance]

If successful, gcloud returns the following response:

Deleted instance [myinstance].

What's next

Learn more about creating and managing instances .
Learn about other ways to connect to your Redis instance .
Learn about the characteristics of a Redis instance .