Nesta página, fornecemos instruções para criar instâncias do Memorystore para Valkey.
Antes de começar
Siga as instruções antes de começar:
- No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.
Acessar o seletor de projetos - Verifique se o faturamento foi ativado para o projeto. Saiba como verificar se o faturamento está ativado em um projeto.
Instale e inicialize a Google Cloud CLI.
Observação: se você já instalou a CLI gcloud, verifique se tem a versão mais recente executando
gcloud components update
. É necessário ter pelo menos a versão489.0.0
da CLI gcloud para acessar os comandos da CLI gcloud do Memorystore para Valkey.-
Ative a API Memorystore for Valkey
Memorystore para Valkey -
Ative a API Network Connectivity
API Network Connectivity -
Ative a API Service Consumer Management
API Service Consumer Management
Outros pré-requisitos
- É necessário ter uma das seguintes funções do IAM no projeto do Google Cloud que você está usando:
roles/memorystore.admin
(o papel do IAM predefinido no Memorystore Admin)roles/owner
(o papel básico do IAM "Proprietário")roles/editor
(o papel básico de Editor do IAM)
Configurar redes
Leia a página Rede para determinar se você precisa configurar uma política de conexão de serviço.
Se uma política de conexão de serviço não tiver sido criada para a rede com que você vai criar a instância do Valkey, siga as orientações de redes para criá-la.
Criar uma instância
Console
Acesse a página Memorystore para Valkey no console do Google Cloud.
Clique em Criar instância.
Na página Criar uma instância do Valkey, selecione a configurações da nova instância.
- Em Nome da instância, insira um ID. O ID da instância
use somente letras minúsculas, números e hifens. Ela também precisa
começar com uma letra e ser único na região.
- Por exemplo,
my-instance-1
.
- Por exemplo,
- Em Escolher região, selecione uma região para sua instância.
- Em Tipo de nó, selecione o tipo de nó escolhido.
- Em Tamanho da instância, defina o número de fragmentos para a instância. A contagem de fragmentos determina o total de memória capacidade de armazenamento de dados de instância. Para mais detalhes sobre a especificação de instância, consulte Especificação de instância e de shard.
- Se você quiser criar uma instância com réplicas, insira o número desejado de réplicas (por fragmento) em Réplicas. Os valores aceitáveis são "Sem réplica", "1 réplica" e "2 réplicas". O valor padrão é 1 Réplica ao usar o console do Google Cloud.
- Em Configurar conexão, selecione a rede desejada. Para mais detalhes sobre a rede privada do Memorystore para Valkey, consulte Rede.
- Se você quiser ativar a autenticação do IAM Selecione Ativar IAM AUTH.
- Se você quiser ativar a criptografia em trânsito Selecione Ativar Transport Layer Security (TLS).
- Em Escolher versão, selecione a versão do Valkey escolhida. A versão 7.2 do Valkey é o padrão.
- Em Nome da instância, insira um ID. O ID da instância
use somente letras minúsculas, números e hifens. Ela também precisa
começar com uma letra e ser único na região.
Clique no botão Criar instância.
gcloud
Para criar uma instância do Memorystore para Valkey, execute o comando create
:
gcloud beta memorystore instances create INSTANCE \ --location=REGION_ID \ --psc-auto-connections=network=projects/PROJECT_ID/global/networks/NETWORK_ID,projectId=PROJECT_ID \ --replica-count=REPLICA_COUNT \ --node-type=NODE_TYPE \ --engine-version=ENGINE_VERSION \ --shard-count=SHARD_COUNT
Substitua:
INSTANCE é o ID da instância do Memorystore para Valkey que você está criando. O ID da instância precisa ter de 1 a 63 caracteres e usar apenas letras minúsculas, números ou hifens. Ele precisa começar com uma letra minúscula. e terminar com uma letra minúscula ou um número.
REGION_ID é a região em que você quer colocar a instância.
PROJECT_ID é o ID do projeto em que você quer criar. a instância.
NETWORK_ID é o ID da rede que você quer usar para criar a instância.
REPLICA_COUNT é o número desejado de réplicas (por fragmento). Os valores aceitos são
0
,1
e2
.NODE_TYPE é o tipo de nó escolhido. Os valores aceitos são:
shared-core-nano
standard-small
highmem-medium
highmem-xlarge
Para mais detalhes sobre tipos de nó e configurações de instâncias, consulte Especificação de instância e nó.
ENGINE_VERSION é a versão do mecanismo Valkey escolhida. Os valores aceitáveis são
valkey_7_2
evalkey_8_0
.SHARD_COUNT determina o número de fragmentos nos seus instância. A contagem de fragmentos determina a capacidade total de memória os dados da instância. Para mais detalhes sobre a especificação da instância, consulte Especificação de instância e de nó.
Exemplo:
gcloud beta memorystore instances create my-instance \ --location=us-central1 \ --psc-auto-connections=network=projects/my-project/global/networks/default,projectId=my-project \ --replica-count=2 \ --node-type=highmem-medium \ --shard-count=8
Por padrão, a criptografia em trânsito
está desativada, e a rede autorizada é default
.
Criar uma instância de zona única
Esta seção fornece instruções sobre como criar uma instância de zona única.
gcloud
Para criar uma instância de zona única, execute o comando create
:
gcloud beta memorystore instances create INSTANCE \ --location=REGION_ID \ --psc-auto-connections=network=projects/PROJECT_ID/global/networks/NETWORK_ID,projectId=PROJECT_ID \ --replica-count=REPLICA_COUNT \ --node-type=NODE_TYPE \ --engine-version=ENGINE_VERSION \ --shard-count=SHARD_COUNT \ --zone-distribution-config-mode=ZONE_DISTRIBUTION_CONFIG_MODE \ --zone-distribution-config=ZONE
Substitua:
INSTANCE é o ID da instância do Memorystore para Valkey que você está criando. O ID da instância precisa ter de 1 a 63 caracteres e usar apenas letras minúsculas, números ou hifens. Ele precisa começar com uma letra minúscula e terminar com uma letra minúscula ou um número.
REGION_ID é a região em que você quer colocar a instância.
PROJECT_ID é o ID do projeto em que você quer criar a instância.
NETWORK_ID é o ID da rede que você quer usar para criar. a instância.
REPLICA_COUNT é o número escolhido de réplicas (por fragmento). Os valores aceitos são
0
,1
e2
.NODE_TYPE é o tipo de nó escolhido. Os valores aceitos são:
shared-core-nano
standard-small
highmem-medium
highmem-xlarge
Para mais detalhes sobre tipos de nó e configurações de instâncias, consulte Especificação de instância e nó.
ENGINE_VERSION é a versão do mecanismo do Valkey escolhida. Aceito os valores são
valkey_7_2
evalkey_8_0
.SHARD_COUNT determina o número de fragmentos na instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados de instância. Para mais informações sobre a especificação de instância, consulte Especificação de instância e de nó.
ZONE_DISTRIBUTION_CONFIG_MODE é o modo que permite escolher entre provisionar uma instância de zona única ou uma instância de várias zonas. O padrão é multirregião. Os valores aceitos são
single-zone
emulti-zone
.ZONE é a zona em que você quer provisionar os nós. Essa flag só é aplicável se
--zone-distribution-config-mode=
estiver definido comosingle-zone
.