Crea una instancia de Memorystore para Redis con gcloud CLI

Crea una instancia de Memorystore para Redis con gcloud CLI

Aprende a crear una instancia nueva de Memorystore para Redis, conectarte a ella y, luego, borrarla.

---

Para seguir la guía paso a paso sobre esta tarea directamente en la Google Cloud consola, haz clic en Guiarme:

Guiarme

---

Antes de comenzar

Accede a tu Google Cloud cuenta de. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

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.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Memorystore for Redis API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Memorystore for Redis API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Si aún no lo hiciste, instala la Google Cloud CLI.

   Cuando se te solicite, elige el proyecto que seleccionaste o creaste.

2. Si ya tienes instalada la Google Cloud CLI, actualízala.

   gcloud components update

Roles obligatorios

Para obtener los permisos que necesitas para crear una instancia de Memorystore para Redis, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

• Administrador de Cloud Memorystore para Redis (roles/redis.admin)
• Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1)
• Usuario de cuenta de servicio (roles/iam.serviceAccountUser)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Crea una instancia de Memorystore para Redis

En esta sección, crearás una instancia de Memorystore para Redis de 2 GB que se encuentra en la región us-central1 y está en el nivel Básico. Para obtener más información sobre los niveles, consulta Capacidades de los niveles de Redis.

1. Abre una ventana de terminal.

2. Para configurar el proyecto en el que deseas crear tu instancia como proyecto predeterminado, ingresa el siguiente comando:

   gcloud config set core/project PROJECT_ID
   

3. Para crear una instancia de Redis de nivel Básico de 2 GiB en la región us-central1, ingresa el siguiente comando:

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

4. Después de crear la instancia, para obtener la dirección IP y el número de puerto de la instancia, ingresa el siguiente comando:

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

   Si puedes acceder a la instancia, el comando muestra este resultado:

   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

5. Toma nota de los valores host y port de tu instancia. Necesitas estos valores para conectarte a la instancia.

Conéctate a la instancia de Memorystore para Redis desde una VM de Compute Engine

Puedes conectarte a la instancia de Memorystore para Redis desde cualquier VM de Compute Engine que use la red autorizada de la instancia con una dirección IP RFC 1918 compatible.

1. Si no tienes una VM de Compute Engine que use la misma red autorizada que tu instancia, crea una y conéctate a ella con SSH. Para ello, sigue los pasos que se indican en Crea una instancia de VM de Linux en Compute Engine.

2. Usa apt-get para instalar telnet:

   sudo apt-get install telnet
   

3. Desde la terminal, ejecuta Telnet a la dirección IP de la instancia. Reemplaza VARIABLES por los valores adecuados.

   telnet INSTANCE_IP_ADDRESS 6379
   

   Si puedes conectarte a la instancia, el comando muestra este resultado:

   Trying INSTANCE_IP_ADDRESS…
   Connected to INSTANCE_IP_ADDRESS
   

4. En la sesión de telnet, ingresa algunos comandos de Redis:

   Ingrese:

   PING
   

   Resultado:

   PONG
   

   Ingresa:

   SET HELLO WORLD
   

   Resultado:

   +OK
   

   Ingrese:

   GET HELLO
   

   Resultado:

   $5
   WORLD
   

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu Google Cloud cuenta de por los recursos que usaste en esta página.

1. Para borrar la instancia, ingresa el siguiente comando:

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

2. Para confirmar la eliminación, ingresa Y:

   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]

   Si puedes borrar la instancia, el comando muestra este resultado:

   Deleted instance [myinstance].

3. Opcional. Si creaste una VM de Compute Engine para esta guía de inicio rápido, entonces bórrala.

¿Qué sigue?

• Conoce más acerca de crear y administrar instancias.
• Conoce más acerca de otras maneras de conectar tu instancia de Redis.
• Conoce más acerca de las características de una instancia de Redis.