Crie instâncias

Esta página fornece instruções para criar instâncias do Memorystore for Valkey.

Antes de começar

Conclua as instruções antes de começar:

1. Na Google Cloud consola, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
   

   Nota: se não planeia manter os recursos que cria neste procedimento, crie um projeto em vez de selecionar um projeto existente. Depois de concluir estes passos, pode eliminar o projeto, removendo todos os recursos associados ao mesmo.

   
   Aceder ao seletor de projetos
2. Certifique-se de que a faturação está ativada para o seu projeto. Saiba como verificar se a faturação está ativada num projeto.

3. Instale e inicialize a CLI Google Cloud.

   Nota: se instalou a CLI gcloud anteriormente, certifique-se de que tem a versão mais recente executando gcloud components update. Precisa, pelo menos, da versão 489.0.0 da CLI gcloud para aceder aos comandos da CLI gcloud do Memorystore for Valkey.

4. Ative 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

• Tem de ter uma destas funções de IAM no Google Cloud projeto que está a usar:
  • roles/memorystore.admin (a função de IAM predefinida de administrador do Memorystore)
  • roles/owner (a função de IAM básica de proprietário)
  • roles/editor (a função de IAM básica de editor)

Configure a rede

Leia a página Redes para determinar se tem de configurar uma política de ligação de serviço.

Se não tiver sido criada uma política de ligação de serviço para a rede com a qual vai criar a instância do Valkey, siga as orientações de Redes para a criar.

Crie uma instância

Importante: antes de seguir estes passos, conclua os passos nas secções Antes de começar e Configure a rede.

Consola

1. Aceda à página Memorystore for Valkey na Google Cloud consola.

   Memorystore for Valkey

2. Clique em Criar instância.

3. Na página Crie uma instância do Valkey, selecione as configurações desejadas para a nova instância.

   • Em Atribua um nome à sua instância, introduza um ID da instância. O ID da instância tem de usar apenas letras minúsculas, números e hífenes. Também tem de começar com uma letra e ser único na respetiva região.
     • Por exemplo: my-instance-1.
   • Em Escolher região, selecione uma região para a sua instância.

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

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

   • Em Modo, selecione Modo de cluster ativado ou Modo de cluster desativado.

   • Em Tamanho da instância, defina o número de fragmentos para a sua 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ó suportam um fragmento. Para mais informações, consulte o artigo Especificação de instâncias e fragmentos.

   • Se quiser criar uma instância com réplicas, introduza o número de réplicas pretendido (por fragmento) em Réplicas. Os valores aceitáveis são No Replica, 1 Replica e 2 Replicas. O valor predefinido é 1 Replica quando usa a Google Cloud consola.

   • Em Configurar ligação, selecione a rede pretendida. Para mais detalhes sobre as redes privadas do Memorystore for Valkey, consulte o artigo Redes.

   • Se quiser ativar a autenticação IAM, selecione Ativar autenticação IAM.

   • Se quiser ativar a encriptação em trânsito, selecione Ativar Transport Layer Security (TLS).

   • Em Escolher versão, selecione a sua versão do Valkey. A versão 7.2 do Valkey é a predefinição.

4. Clique no botão Criar instância.

gcloud

Para criar uma instância do Memorystore for 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 o seguinte:

• INSTANCE é o ID da instância do Memorystore for Valkey que está a criar. O ID da instância tem de ter entre 1 e 63 carateres e usar apenas letras minúsculas, números ou hífenes. Tem de começar com uma letra minúscula e terminar com uma letra minúscula ou um número.

• REGION_ID é a região onde quer colocar a instância.

Nota: só pode criar instâncias nas regiões suportadas para o Memorystore for Valkey.

• PROJECT_ID é o ID do projeto onde quer criar a instância.

• NETWORK_ID é o ID da rede que quer usar para criar a sua instância.

• REPLICA_COUNT é o número desejado de réplicas (por fragmento). Os valores aceites são 0, 1 e 2.

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

  • shared-core-nano
  • standard-small
  • highmem-medium
  • highmem-xlarge
  Aviso: recomendamos que use o tipo de nó shared-core-nano apenas para fins de desenvolvimento ou teste. Se executar o Memorystore for Valkey num ambiente de produção, recomendamos que use os tipos de nós standard-small, highmem-medium ou highmem-xlarge. Para mais informações sobre estes tipos de nós, consulte Escolha um tipo de nó.

• ENGINE_VERSION é a versão do motor Valkey escolhida. Os valores aceites são VALKEY_7_2 e VALKEY_8_0.

• SHARD_COUNT determina o número de fragmentos na sua 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ó suportam um fragmento. Para mais informações, consulte o artigo Especificação de instâncias e nós.

• MODE determina se a instância está no modo de cluster ativado ou no modo de cluster desativado. Se este campo for omitido, a instância é predefinida como Modo de cluster ativado. Para mais informações, consulte o artigo Ative e desative o modo de cluster.

Por 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 predefinição, a encriptação em trânsito está desativada e a rede autorizada é default.

Crie uma instância de zona única

Esta secção fornece instruções sobre como criar uma instância de zona única.

Importante: antes de seguir estes passos, conclua os passos nas secções Antes de começar e Configure a 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 o seguinte:

• INSTANCE é o ID da instância do Memorystore for Valkey que está a criar. O ID da instância tem de ter entre 1 e 63 carateres e usar apenas letras minúsculas, números ou hífenes. Tem de começar com uma letra minúscula e terminar com uma letra minúscula ou um número.

• REGION_ID é a região onde quer colocar a instância.

• PROJECT_ID é o ID do projeto onde quer criar a instância.

• NETWORK_ID é o ID da rede que quer usar para criar a sua instância.

• REPLICA_COUNT é o número escolhido de réplicas (por fragmento). Os valores aceites são 0, 1 e 2.

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

  • shared-core-nano
  • standard-small
  • highmem-medium
  • highmem-xlarge
  Aviso: recomendamos que use o tipo de nó shared-core-nano apenas para fins de desenvolvimento ou teste. Se executar o Memorystore for Valkey num ambiente de produção, recomendamos que use os tipos de nós standard-small, highmem-medium ou highmem-xlarge. Para mais informações sobre estes tipos de nós, consulte Escolha um tipo de nó.

• ENGINE_VERSION é a versão do motor Valkey escolhida. Os valores aceites são VALKEY_7_2 e VALKEY_8_0.

• SHARD_COUNT determina o número de fragmentos na sua instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados de instâncias. Se selecionar o modo Cluster Mode Disabled, só pode especificar um fragmento para a sua instância. Para mais informações, consulte o artigo Especificação de instâncias e nós.

• MODE determina se a instância deve ter o modo de cluster ativado ou desativado. Se omitir este campo, o modo é predefinido como Cluster Mode Enabled. Para mais informações, consulte o artigo Ative e desative o modo de cluster.

• ZONE_DISTRIBUTION_CONFIG_MODE é o modo que lhe permite escolher entre o aprovisionamento de uma instância de zona única ou de várias zonas. A predefinição é várias zonas. Os valores aceites são single-zone e multi-zone.

• ZONE é a zona onde quer aprovisionar os seus nós. Esta flag só é aplicável se --zone-distribution-config-mode= estiver definido como single-zone.