Criar instâncias

Nesta página, fornecemos instruções para criar instâncias de zona única e multizona no Memorystore para Valkey.

Antes de começar

Conclua as instruções em "Antes de começar":

1. 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 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
2. Verifique se o faturamento foi ativado para o projeto. Saiba como verificar se o faturamento está ativado em um projeto.

3. Instale e inicialize a Google Cloud CLI.

   Observação:se você já instalou a CLI gcloud, execute gcloud components update para verificar se você tem a versão mais recente. É necessário ter pelo menos a versão 489.0.0 da CLI gcloud para acessar os comandos da CLI gcloud do Memorystore para Valkey.

4. Ativar a API Memorystore for Valkey
   Memorystore for Valkey
5. Ative a API Network Connectivity
   API Network Connectivity
6. Ative a API Service Consumer Management.
   API Service Consumer Management

Outros pré-requisitos

• Você precisa ter um destes papéis do IAM no Google Cloud projeto que está sendo usado:
  • roles/memorystore.admin (o papel predefinido do IAM de administrador do Memorystore)
  • roles/owner (o papel básico do IAM de Proprietário)
  • roles/editor (o papel básico do IAM de Editor)

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 de várias zonas

Nesta seção, você encontra instruções para criar uma instância de várias zonas.

Importante: antes de seguir as etapas deste procedimento, conclua as etapas nas seções Antes de começar e Configurar rede.

Se você criar uma instância com réplicas e uma única zona da região em que a instância será criada estiver indisponível, o Memorystore para Valkey criará a instância nas zonas disponíveis da região. Essa alocação zonal é temporária. Quando a zona indisponível fica disponível, o Memorystore for Valkey redistribui os nós da instância para que eles sejam distribuídos uniformemente entre as zonas.

Se você criar uma instância sem réplicas e uma única zona estiver indisponível, o Memorystore para Valkey não vai conseguir criar a instância.

Console

1. Acesse a página Memorystore para Valkey no console Google Cloud .

   Memorystore for Valkey

2. Clique em Criar instância.

3. 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. 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.
   • Em Escolher região, selecione uma região para sua instância.

   • Na seção Tipo de nó, selecione um dos seguintes tipos de nó:

     • Núcleo compartilhado (shared-core-nano)
     • Pequeno (standard-small)
     • Média (highmem-medium)
     • Extragrande (highmem-xlarge)

   • Na seção Modo de cluster, selecione Ativado ou Desativado.

     Observação: depois de criar uma instância com o modo de cluster ativado ou desativado, não é possível mudar a instância para o outro modo. Recomendamos que você selecione Ativado porque esse modo tem melhores características de escalonamento horizontal.

   • 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 aceitam apenas 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 de réplicas (por fragmento) em Réplicas. Os valores aceitáveis são Nenhuma réplica, 1 réplica, 2 réplicas, 3 réplicas, 4 réplicas e 5 réplicas.

     Observação: é possível criar até cinco réplicas para sua instância.

   • Em Configurar conexão, selecione sua rede. Para mais detalhes sobre redes particulares no Memorystore para Valkey, consulte Rede.

   • Se quiser ativar a autenticação do IAM, selecione Ativar autenticação 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. As versões disponíveis são 7.2, 8.0 e 9.0 (pré-lançamento). A versão padrão é a 8.0.

     Importante: se você selecionar 9.0 como a versão da instância, não será possível fazer downgrade para uma versão anterior.

4. 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 que a instância seja colocada.

Observação: só é possível criar instâncias nas regiões compatíveis do Memorystore for Valkey.

• 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 (por fragmento). Os valores aceitos são 0-5.

• NODE_TYPE é o tipo de nó escolhido. Os valores aceitos são:

  • shared-core-nano
  • standard-small
  • highmem-medium
  • highmem-xlarge
  Atenção: recomendamos usar o tipo de nó shared-core-nano apenas para fins de desenvolvimento ou teste porque ele não tem um SLA. Se você executar o Memorystore for Valkey em um ambiente de produção, recomendamos usar os tipos de nós standard-small, highmem-medium ou highmem-xlarge. Para mais informações sobre esses tipos de nó, consulte Escolher um tipo de nó.

• ENGINE_VERSION é a versão da sua instância do Memorystore for Valkey. Os valores aceitos para esse parâmetro são VALKEY_7_2, VALKEY_8_0 e VALKEY_9_0 (prévia). Se você não especificar um valor, VALKEY_8_0 será o padrão.

  Importante: se você especificar VALKEY_9_0 como a versão da instância, não será possível fazer downgrade para uma versão anterior.

• 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 aceitam apenas 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.

  Observação: depois de criar uma instância com o modo de cluster ativado ou desativado, não é possível mudar a instância para o outro modo. Recomendamos que você crie uma instância com o modo de cluster ativado, porque esse tipo de instância tem melhores características de escalonamento.

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.

Importante: antes de seguir estas etapas, conclua as instruções nas seções Antes de começar e Configurar rede.

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 que a instância seja colocada.

• 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 (por fragmento). Os valores aceitos são 0-5.

• NODE_TYPE é o tipo de nó escolhido. Os valores aceitos são:

  • shared-core-nano
  • standard-small
  • highmem-medium
  • highmem-xlarge
  Atenção: recomendamos usar o tipo de nó shared-core-nano apenas para fins de desenvolvimento ou teste porque ele não tem um SLA. Se você executar o Memorystore for Valkey em um ambiente de produção, recomendamos usar os tipos de nós standard-small, highmem-medium ou highmem-xlarge. Para mais informações sobre esses tipos de nó, consulte Escolher um tipo de nó.

• ENGINE_VERSION é a versão da sua instância do Memorystore for Valkey. Os valores aceitos para esse parâmetro são VALKEY_7_2, VALKEY_8_0 e VALKEY_9_0 (prévia). Se você não especificar um valor, VALKEY_8_0 será o padrão.

  Importante: se você especificar VALKEY_9_0 como a versão da instância, não será possível fazer downgrade para uma versão anterior.

• 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. 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.

  Observação: depois de criar uma instância com o modo de cluster ativado ou desativado, não é possível mudar a instância para o outro modo. Recomendamos que você crie uma instância com o modo de cluster ativado, porque esse tipo de instância tem melhores características de escalonamento.

• 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 e multi-zone.

• ZONE é a zona em que você quer provisionar os nós. Essa flag só é aplicável se --zone-distribution-config-mode= estiver definido como single-zone.