Criar uma instância do Memorystore para Redis usando a CLI gcloud

Criar uma instância do Memorystore para Redis usando a CLI gcloud

Saiba como criar uma instância do Memorystore para Redis, conectar-se a ela e excluí-la.

---

Para seguir as instruções detalhadas desta tarefa diretamente no console do Google Cloud , clique em Orientação:

Orientações

---

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 este guia estiver usando um projeto atual, verifique se você tem as permissões necessárias para concluir o guia. Se você criou um projeto, já tem as permissõ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 este guia estiver usando um projeto atual, verifique se você tem as permissões necessárias para concluir o guia. Se você criou um projeto, já tem as permissõ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 tiver feito isso, instale a Google Cloud CLI.

   Quando solicitado, escolha o projeto que você selecionou ou criou.

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

   gcloud components update

Funções exigidas

Para receber as permissões necessárias para criar uma instância do Memorystore para Redis, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

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

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Criar uma instância do Memorystore para Redis

Nesta seção, você vai criar uma instância de 2 GB do Memorystore para Redis localizada na região us-central1 e no nível Básico. Para mais informações sobre os níveis, consulte Níveis de recursos do Redis.

1. Abra uma janela do terminal.

2. Para definir o projeto em que você quer criar a instância como o projeto padrão, insira o comando a seguir:

   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, digite 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 receber o endereço IP e o número da porta dela, insira o seguinte comando:

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

   Se você tiver acesso à instância, o comando vai retornar 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. Anote os valores host e port da sua instância. Você precisa desses valores para se conectar à instância.

Conectar-se à instância do Memorystore para Redis de uma VM do Compute Engine

É possível se conectar à instância do Memorystore para Redis de qualquer VM do Compute Engine que use a rede autorizada da instância com um endereço IP RFC 1918 compatível.

1. Se você não tiver uma VM do Compute Engine que use a mesma rede autorizada da sua instância, crie uma e conecte-se a ela usando SSH. Para fazer isso, siga as etapas em Criar uma instância de VM do Linux no Compute Engine.

2. Use apt-get para instalar telnet:

   sudo apt-get install telnet
   

3. No terminal, use o telnet para o endereço IP da instância. Substitua VARIABLES pelos valores adequados.

   telnet INSTANCE_IP_ADDRESS 6379
   

   Se você conseguir se conectar à instância, o comando vai retornar este resultado:

   Trying INSTANCE_IP_ADDRESS…
   Connected to INSTANCE_IP_ADDRESS
   

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

   Insira:

   PING
   

   Result:

   PONG
   

   Enter

   SET HELLO WORLD
   

   Result:

   +OK
   

   Insira o seguinte:

   GET HELLO
   

   Result:

   $5
   WORLD
   

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

1. Para excluir a instância, insira o seguinte comando:

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

2. Para confirmar a exclusão, digite 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 você puder excluir a instância, o comando vai retornar este resultado:

   Deleted instance [myinstance].

3. Opcional. Se você criou uma VM do Compute Engine para este guia de início rápido, exclua ela.

A seguir

• Saiba mais sobre como criar e gerenciar instâncias.
• Conheça outras maneiras de se conectar à sua instância do Redis.
• Saiba mais sobre as características de uma instância do Redis.