Nesta página, fornecemos instruções para criar instâncias do Memorystore para Valkey.
Antes de começar
Conclua as instruções em "Antes de começar":
- No Google Cloud console, 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ê instalou a CLI gcloud anteriormente, 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 para 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
- Você precisa ter um destes papéis do IAM no projeto do Google Cloud que está usando:
roles/memorystore.admin
(o papel predefinido de administrador do Memorystore no IAM)roles/owner
(o papel básico Proprietário do IAM)roles/editor
(o papel básico de editor do IAM)
Configurar redes
Leia a página Redes 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 em que você vai criar a instância do Valkey, siga as orientações de Redes para criar uma.
Criar uma instância
Console
Acesse a página Memorystore para Valkey no console Google Cloud .
Clique em Criar instância.
Na página Criar uma instância do Valkey, selecione as configurações pretendidas para a nova instância.
- Em Nomeie sua instância, insira um ID de instância. O ID da instância
precisa usar apenas letras minúsculas, números e hifens. Ele também precisa começar com uma letra e ser exclusivo na região.
- Por exemplo,
my-instance-1
.
- Por exemplo,
- Em Escolher região, selecione uma região para a instância.
- Em Tipo de nó, selecione seu tipo de nó.
- Em Modo, selecione Modo cluster ativado ou Modo cluster desativado.
- Em Tamanho da instância, defina o número de fragmentos para a instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados de instâncias. As instâncias com o modo de cluster desativado só aceitam um fragmento. Para mais informações, consulte Especificação de instância e fragmento.
- Se 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 "Nenhuma réplica", "1 réplica" e "2 réplicas". O valor padrão é 1 réplica ao usar o console Google Cloud .
- Em Configurar conexão, selecione a rede desejada. Para mais detalhes sobre redes particulares no Memorystore para Valkey, consulte Rede.
- Se quiser ativar a autenticação do IAM, selecione Ativar AUTH do IAM.
- Se você quiser ativar a criptografia em trânsito, selecione Ativar segurança da camada de transporte (TLS).
- Em Escolher versão, selecione sua versão do Valkey. A versão 7.2 do Valkey é a padrão.
- Em Nomeie sua instância, insira um ID de instância. O ID da instância
precisa usar apenas letras minúsculas, números e hifens. Ele também precisa começar com uma letra e ser exclusivo 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 memorystore instances create INSTANCE \ --location=REGION_ID \ --endpoints='[{"connections": [{"pscAutoConnection": {"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 \ --mode=MODE
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ós 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 aceitos 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âncias. As instâncias com o modo de cluster desativado só aceitam um fragmento. Para mais informações, consulte Especificação da instância e do nó.
MODE determina se a instância está com o modo de cluster ativado ou desativado. Se esse campo for omitido, a instância vai usar o modo de cluster ativado por padrão. Para mais informações, consulte Ativar e desativar o modo de cluster.
Exemplo:
Exemplo de modo de cluster ativado
gcloud memorystore instances create my-instance \ --location=us-central1 \ --endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \ --replica-count=2 \ --node-type=highmem-medium \ --shard-count=8 \ --mode=cluster
Exemplo de modo de cluster desativado
gcloud memorystore instances create my-instance \ --location=us-central1 \ --endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \ --shard-count=1 \ --replica-count=2 \ --node-type=highmem-medium \ --mode=cluster-disabled
Por padrão, a criptografia em trânsito
está desativada, e a rede autorizada é default
.
Criar uma instância de zona única
Nesta seção, você encontra instruções para criar uma instância de zona única.
gcloud
Para criar uma instância de zona única, execute o comando create
:
gcloud memorystore instances create INSTANCE \ --location=REGION_ID \ --endpoints='[{"connections": [{"pscAutoConnection": {"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 \ --mode=MODE
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 de réplicas escolhido (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ós 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 aceitos 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 da instância. Se o modo selecionado for "Modo de cluster desativado", você poderá especificar apenas um fragmento para sua instância. Para mais informações, consulte Especificação da instância e do nó.
MODE determina se a instância deve estar com o modo de cluster ativado ou desativado. Se você omitir esse campo, o modo padrão será "Modo de cluster ativado". Para mais informações, consulte Ativar e desativar o modo de cluster.
ZONE_DISTRIBUTION_CONFIG_MODE é o modo que permite escolher entre provisionar uma instância de zona única ou multizona. O padrão é multizona. 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
.