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 neste 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. No console Google Cloud , 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 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)

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

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

9. Se 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 é uma 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 no Memorystore for Valkey, consulte Rede.

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

    Observação: se você marcar essa caixa de seleção, o Memorystore para Valkey vai marcar automaticamente a caixa Ativar criptografia em trânsito (TLS). Como resultado, o Memorystore for Valkey criptografa suas credenciais para que elas sejam confidenciais quando transmitidas da instância para o aplicativo.

12. Na seção Estratégia de persistência de dados, especifique como você quer que o Memorystore for Valkey persista os dados na sua 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.

13. Opcional. Se você quiser ativar os backups automáticos 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, digite o número de dias que você quer que o Memorystore for Valkey mantenha os backups antes que eles sejam excluídos automaticamente. É possível especificar de 1 a 365 dias. O valor padrão é de 35 dias.
    3. No menu Período, selecione um horário para o backup diário.

14. Na seção 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.

15. 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 for 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.

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

  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 seções Antes de começar e Configurar rede.

Console

1. No console Google Cloud , 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 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)

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

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

9. Se 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 é uma 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 no Memorystore for Valkey, consulte Rede.

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

    Observação: se você marcar essa caixa de seleção, o Memorystore para Valkey vai marcar automaticamente a caixa Ativar criptografia em trânsito (TLS). Como resultado, o Memorystore for Valkey criptografa suas credenciais para que elas sejam confidenciais quando transmitidas da instância para o aplicativo.

12. Na seção Estratégia de persistência de dados, especifique como você quer que o Memorystore for Valkey persista os dados na sua 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.

13. Opcional. Se você quiser ativar os backups automáticos 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, digite o número de dias que você quer que o Memorystore for Valkey mantenha os backups antes que eles sejam excluídos automaticamente. É possível especificar de 1 a 365 dias. O valor padrão é de 35 dias.
    3. No menu Período, selecione um horário para o backup diário.

14. Na seção 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.

15. 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 for 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 (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.