Crie uma instância do Memorystore for Redis através da CLI gcloud

Crie uma instância do Memorystore for Redis através da CLI gcloud

Saiba como criar uma instância do Memorystore for Redis, estabelecer ligação à mesma e, em seguida, eliminá-la.

---

Para seguir orientações passo a passo para esta tarefa diretamente na Google Cloud consola, clique em Orientar-me:

Visita guiada

---

Antes de começar

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.

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

Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

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

Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

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. Se ainda não o fez, instale a CLI Google Cloud.

   Quando lhe for pedido, escolha o projeto que selecionou ou criou.

2. Se já tiver a CLI do Google Cloud instalada, atualize-a.

   gcloud components update

Funções necessárias

Para receber as autorizações de que precisa para criar uma instância do Memorystore para Redis, peça ao seu administrador que lhe conceda as seguintes funções do IAM no projeto:

• Administrador do Cloud Memorystore Redis (roles/redis.admin)
• Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1)
• Utilizador da conta de serviço (roles/iam.serviceAccountUser)

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Crie uma instância do Memorystore for Redis

Nesta secção, cria uma instância do Memorystore para Redis de 2 GB localizada na região us-central1 e no nível básico. Para mais informações sobre os níveis, consulte o artigo Capacidades dos níveis do Redis.

1. Abra uma janela de terminal.

2. Para definir o projeto no qual quer criar a instância como o projeto predefinido, introduza o seguinte comando:

   gcloud config set core/project PROJECT_ID
   

3. Para criar uma instância do Redis de nível básico de 2 GiB na região us-central1, introduza o seguinte comando:

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

4. Depois de criar a instância, para obter o endereço IP e o número da porta da instância, introduza o seguinte comando:

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

   Se conseguir aceder à instância, o comando devolve 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. Tome nota dos valores host e port da sua instância. Precisa destes valores para se ligar à instância.

Estabeleça ligação à instância do Memorystore for Redis a partir de uma VM do Compute Engine

Pode estabelecer ligação à instância do Memorystore for Redis a partir de qualquer VM do Compute Engine que use a rede autorizada da instância com um endereço IP RFC 1918 suportado.

1. Se não tiver uma VM do Compute Engine que use a mesma rede autorizada que a sua instância, crie uma e ligue-se à VM através do SSH. Para o fazer, siga os passos em Crie uma instância de VM Linux no Compute Engine.

2. Use o apt-get para instalar o telnet:

   sudo apt-get install telnet
   

3. A partir do terminal, use o telnet para aceder ao endereço IP da instância. Substitua VARIABLES pelos valores adequados.

   telnet INSTANCE_IP_ADDRESS 6379
   

   Se conseguir estabelecer ligação à instância, o comando devolve este resultado:

   Trying INSTANCE_IP_ADDRESS…
   Connected to INSTANCE_IP_ADDRESS
   

4. Na sessão do telnet, introduza alguns comandos do Redis:

   Introduza:

   PING
   

   Resultado:

   PONG
   

   Enter

   SET HELLO WORLD
   

   Resultado:

   +OK
   

   Introduza:

   GET HELLO
   

   Resultado:

   $5
   WORLD
   

Limpar

Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

1. Para eliminar a instância, introduza o seguinte comando:

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

2. Para confirmar a eliminação, introduza 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]

   Se puder eliminar a instância, o comando devolve este resultado:

   Deleted instance [myinstance].

3. Opcional. Se criou uma VM do Compute Engine para este início rápido, elimine-a.

O que se segue?

• Saiba mais acerca de como criar e gerir instâncias.
• Saiba mais sobre outras formas de estabelecer ligação à sua instância do Redis.
• Saiba mais sobre as caraterísticas de uma instância do Redis.