Criar instâncias

Esta página fornece instruções para criar instâncias de zona única e várias zonas no Memorystore para Valkey.

Antes de começar

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

1. 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 já existente. 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á tiver instalado a CLI gcloud, execute gcloud components update para verificar se você tem a versão mais recente. Você precisa da versão 489.0.0 ou mais recente da CLI gcloud para acessar os comandos da CLI gcloud do Memorystore for Valkey.

4. Ativar a API Memorystore for Valkey
   Memorystore for Valkey
5. Ativar a API Network Connectivity
   API Network Connectivity
6. Ativar 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 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 rede para criá-la.

Criar uma instância de várias zonas

Esta seção fornece instruções sobre como 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 redes.

Se você criar uma instância com réplicas e uma única zona da região onde você quer que a instância seja criada estiver indisponível, o Memorystore para Valkey vai criar a instância nas zonas disponíveis da região. Essa alocação zonal é temporária. Depois que a zona indisponível estiver disponível, o Memorystore para Valkey vai redistribuir 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 criar a instância.

Console

1. No Google Cloud console, acesse a página **Memorystore para Valkey**.

   Memorystore for Valkey

2. Clique em Criar instância.

3. Na seção Nomeie sua instância, insira um ID para a 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.

4. No menu Região, selecione uma região para sua instância.

5. Na seção Disponibilidade por zona, selecione a opção Várias zonas porque você quer criar uma instância de várias zonas.

6. Na seção Modo de cluster, especifique se você quer uma instância com o modo de cluster ativado ou desativado. Para mais informações sobre esses tipos de instâncias, 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ê selecione Ativado porque esse modo tem melhores características de escalonamento horizontal.

7. Na seção Tipo de nó, selecione um tipo de nó.

   Cuidado: recomendamos que você use o shared-core-nano tipo de nó apenas para fins de desenvolvimento ou teste porque esse tipo de nó não tem SLA. Se você executar o Memorystore for Valkey em um ambiente de produção, recomendamos o uso de outro tipo de nó.

8. Na seção Tamanho da instância, insira o número de fragmentos da instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados de instância. Para mais informações sobre as especificações da instância, consulte Especificação da instância e do nó.

9. Se você quiser criar uma instância com réplicas, na seção Réplicas, selecione o número de réplicas (por fragmento). É possível selecionar de 0 a 5 réplicas. O valor padrão é 1 réplica.

10. Na seção Configurar conexão, selecione a rede que seus aplicativos podem usar para se conectar a essa instância. Para mais informações sobre redes particulares para o Memorystore para Valkey, consulte Rede.

11. Se você quiser aumentar a segurança da instância, na seção Segurança, ative a autenticação do IAM marcando a caixa de seleção Ativar autenticação do IAM.

    Observação: Se você marcar essa caixa de seleção, o Memorystore for Valkey vai selecionar automaticamente a caixa de seleção Ativar criptografia em trânsito (TLS) e a seção Gerenciamento de autoridade certificadora será exibida. O Memorystore para Valkey criptografa suas credenciais para que elas sejam confidenciais quando transmitidas da instância para o aplicativo.

12. Na seção Gerenciamento de autoridade certificadora, selecione a opção AC por instância, AC gerenciada pelo cliente ou AC compartilhada. Essas opções representam os modos de autoridade certificadora (AC) da sua instância. O modo de AC determina qual hierarquia de AC é usada para emitir os certificados digitais da instância.

    Se você selecionar a opção AC gerenciada pelo cliente, adicione um pool de ACs. Um pool de ACs é uma coleção de várias ACs com uma política de emissão de certificados e uma política do Identity and Access Management (IAM) comuns. Um pool de ACs facilita o gerenciamento da rotação de ACs e permite que você alcance um total maior de consultas eficazes por segundo (QPS).

    Para adicionar um pool de ACs, siga um destes procedimentos:

    1. Para adicionar um pool de ACs de outro Google Cloud projeto, marque a caixa de seleção Adicionar AC de outro projeto e insira o ID do recurso para o pool no campo de texto.

    2. Para adicionar um pool de ACs localizado no mesmo Google Cloud projeto que o projeto que você está usando para criar a instância, selecione o pool no menu Pool de ACs.

13. Na seção Criptografia, selecione uma das seguintes opções:

    • Chave de criptografia gerenciada pelo Google: você quer que o Google use uma chave para criptografar os dados na instância. Essa é a criptografia padrão do Google.

    • Chave do Cloud KMS: você quer gerenciar a criptografia dos seus dados usando chaves de criptografia gerenciadas pelo cliente (CMEKs) no Cloud Key Management Service (Cloud KMS) com serviços integrados a CMEKs, como o Memorystore para Valkey.

      Se você selecionar essa opção, faça o seguinte:

      1. No menu Tipo de gerenciamento de chaves, selecione Cloud KMS.
      2. No menu Selecionar uma chave do Cloud KMS, selecione uma CMEK.

14. Na seção Estratégia de persistência de dados, especifique como você quer que o Memorystore para Valkey persista os dados na instância. Os valores aceitáveis são Sem persistência, persistência de arquivo somente de anexação (AOF), e persistência de snapshot de memória.

15. Se você quiser ativar backups automatizados para sua instância, faça o seguinte:

    1. Marque a caixa de seleção Backups diários automatizados.
    2. No campo Dias para reter backups, insira o número de dias que você quer que o Memorystore para Valkey mantenha os backups antes que eles sejam excluídos automaticamente. É possível especificar de 1 a 365 dias. O valor padrão é 35 dias.
    3. No menu Janela de tempo, selecione um horário para o backup diário.

16. Na seção Manutenção, selecione uma das seguintes opções:

    • Padrão: o Memorystore para Valkey atualiza sua instância rotineiramente para garantir que o serviço seja confiável, eficiente, seguro e atualizado.
    • Personalizado: você quer personalizar a programação de manutenção da sua instância para se alinhar às necessidades do aplicativo e minimizar interrupções. Se você selecionar essa opção, especifique o dia em que quer que a manutenção ocorra e a hora em que quer que a janela de manutenção seja iniciada.

17. Na seção Escolher versão, selecione a versão do Valkey. As versões disponíveis são 7.2, 8.0 e 9.0. A versão padrão é a 9.0.

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

18. Clique em 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 com o 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 sua 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ó que você quer usar para a instância.

  Cuidado: recomendamos que você use o shared-core-nano tipo de nó apenas para fins de desenvolvimento ou teste porque esse tipo de nó não tem SLA. Se você executar o Memorystore for Valkey em um ambiente de produção, recomendamos o uso de outro tipo de nó.

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

  Importante:se você especificar como a versão da instância, não será possível fazer o downgrade da instância para uma versão anterior.
  VALKEY_9_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. 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 você está criando uma instância com o modo de cluster ativado ou desativado. Se esse campo for omitido, a instância será definida como o 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.

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

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

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

Console

1. No Google Cloud console, acesse a página **Memorystore para Valkey**.

   Memorystore for Valkey

2. Clique em Criar instância.

3. Na seção Nomeie sua instância, insira um ID para a 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.

4. No menu Região, selecione uma região para sua instância.

5. Na seção Disponibilidade por zona, faça o seguinte:

   1. Selecione a opção Zona única.

   2. No menu Zona, selecione a zona em que você quer que o Memorystore para Valkey crie a instância.

6. Na seção Modo de cluster, especifique se você quer uma instância com o modo de cluster ativado ou desativado. Para mais informações sobre esses tipos de instâncias, 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ê selecione Ativado porque esse modo tem melhores características de escalonamento horizontal.

7. Na seção Tipo de nó, selecione um tipo de nó.

   Cuidado: recomendamos que você use o shared-core-nano tipo de nó apenas para fins de desenvolvimento ou teste porque esse tipo de nó não tem SLA. Se você executar o Memorystore for Valkey em um ambiente de produção, recomendamos o uso de outro tipo de nó.

8. Na seção Tamanho da instância, insira o número de fragmentos da instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados de instância. Para mais informações sobre as especificações da instância, consulte Especificação da instância e do nó.

9. Se você quiser criar uma instância com réplicas, na seção Réplicas, selecione o número de réplicas (por fragmento). É possível selecionar de 0 a 5 réplicas. O valor padrão é 1 réplica.

10. Na seção Configurar conexão, selecione a rede que seus aplicativos podem usar para se conectar a essa instância. Para mais informações sobre redes particulares para o Memorystore para Valkey, consulte Rede.

11. Se você quiser aumentar a segurança da instância, então na seção Segurança, ative a autenticação do IAM marcando a caixa de seleção Ativar autenticação do IAM.

    Observação: Se você marcar essa caixa de seleção, o Memorystore for Valkey vai selecionar automaticamente a caixa de seleção Ativar criptografia em trânsito (TLS) e a seção Gerenciamento de autoridade certificadora será exibida. O Memorystore para Valkey criptografa suas credenciais para que elas sejam confidenciais quando transmitidas da instância para o aplicativo.

12. Na seção Gerenciamento de autoridade certificadora, selecione a opção AC por instância, AC gerenciada pelo cliente ou AC compartilhada. Essas opções representam os modos de autoridade certificadora (AC) da sua instância. O modo de AC determina qual hierarquia de AC é usada para emitir os certificados digitais da instância.

    Se você selecionar a opção AC gerenciada pelo cliente, adicione um pool de ACs. Um pool de ACs é uma coleção de várias ACs com uma política de emissão de certificados e uma política do Identity and Access Management (IAM) comuns. Um pool de ACs facilita o gerenciamento da rotação de ACs e permite que você alcance um total maior de consultas eficazes por segundo (QPS).

    Para adicionar um pool de ACs, siga um destes procedimentos:

    1. Para adicionar um pool de ACs de outro Google Cloud projeto, marque a caixa de seleção Adicionar AC de outro projeto e insira o ID do recurso do pool no campo de texto.

    2. Para adicionar um pool de ACs localizado no mesmo Google Cloud projeto que o projeto que você está usando para criar a instância, selecione o pool no menu Pool de ACs.

13. Na seção Criptografia, selecione uma das seguintes opções:

    • Chave de criptografia gerenciada pelo Google: você quer que o Google use uma chave para criptografar os dados na instância. Essa é a criptografia padrão do Google.

    • Chave do Cloud KMS: você quer gerenciar a criptografia dos seus dados usando chaves de criptografia gerenciadas pelo cliente (CMEKs) no Cloud Key Management Service (Cloud KMS) com serviços integrados a CMEKs, como o Memorystore para Valkey.

      Se você selecionar essa opção, faça o seguinte:

      1. No menu Tipo de gerenciamento de chaves, selecione Cloud KMS.
      2. No menu Selecionar uma chave do Cloud KMS, selecione uma CMEK.

14. Na seção Estratégia de persistência de dados, especifique como você quer que o Memorystore para Valkey persista os dados na instância. Os valores aceitáveis são Sem persistência, persistência de arquivo somente de anexação (AOF), e persistência de snapshot de memória.

15. Se você quiser ativar backups automatizados para sua instância, faça o seguinte:

    1. Marque a caixa de seleção Backups diários automatizados.
    2. No campo Dias para reter backups, insira o número de dias que você quer que o Memorystore para Valkey mantenha os backups antes que eles sejam excluídos automaticamente. É possível especificar de 1 a 365 dias. O valor padrão é 35 dias.
    3. No menu Janela de tempo, selecione um horário para o backup diário.

16. Na seção Manutenção, selecione uma das seguintes opções:

    • Padrão: o Memorystore para Valkey atualiza sua instância rotineiramente para garantir que o serviço seja confiável, eficiente, seguro e atualizado.
    • Personalizado: você quer personalizar a programação de manutenção da sua instância para se alinhar às necessidades do aplicativo e minimizar interrupções. Se você selecionar essa opção, especifique o dia em que quer que a manutenção ocorra e a hora em que quer que a janela de manutenção seja iniciada.

17. Na seção Escolher versão, selecione a versão do Valkey. As versões disponíveis são 7.2, 8.0 e 9.0. A versão padrão é a 9.0.

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

18. Clique em Criar instância.

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 sua 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ó que você quer usar para a instância.

  Cuidado: recomendamos que você use o shared-core-nano tipo de nó apenas para fins de desenvolvimento ou teste porque esse tipo de nó não tem SLA. Se você executar o Memorystore for Valkey em um ambiente de produção, recomendamos o uso de outro tipo de nó.

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

  Importante:se você especificar como a versão da instância, não será possível fazer o downgrade da instância para uma versão anterior.
  VALKEY_9_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. Se o modo selecionado for o modo de cluster desativado, você poderá especificar apenas um fragmento para a instância. Para mais informações, consulte Especificação da instância e do nó.

• MODE determina se você está criando uma instância com o modo de cluster ativado ou desativado. Se você omitir esse campo, o modo será definido como o 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 uma instância de várias zonas. O padrão é multi-zone. Os valores aceitos são single-zone e multi-zone.

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