Criar instâncias

Nesta página, fornecemos instruções para criar instâncias do Memorystore para Valkey.

Antes de começar

Siga as instruções 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 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
  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, verifique se tem a versão mais recente executando gcloud components update. É 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. Ative a API Memorystore for Valkey
    Memorystore para Valkey
  5. Ative a API Network Connectivity
    API Network Connectivity
  6. Ative a API Service Consumer Management
    API Service Consumer Management

Outros pré-requisitos

  • É necessário ter uma das seguintes funções do IAM no projeto do Google Cloud que você está usando:
    • roles/memorystore.admin (o papel do IAM predefinido no Memorystore Admin)
    • roles/owner (o papel básico do IAM "Proprietário")
    • roles/editor (o papel básico de Editor do IAM)

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 redes para criá-la.

Criar uma instância

Console

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

    Memorystore para Valkey

  2. Clique em Criar instância.

  3. Na página Criar uma instância do Valkey, selecione a configurações da nova instância.

    • Em Nome da instância, insira um ID. O ID da instância use somente letras minúsculas, números e hifens. Ela também precisa começar com uma letra e ser único na região.
      • Por exemplo, my-instance-1.
    • Em Escolher região, selecione uma região para sua instância.
    • Em Tipo de nó, selecione o tipo de nó escolhido.
    • Em Tamanho da instância, defina o número de fragmentos para a instância. A contagem de fragmentos determina o total de memória capacidade de armazenamento de dados de instância. Para mais detalhes sobre a especificação de instância, consulte Especificação de instância e de shard.
    • Se você 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 "Sem réplica", "1 réplica" e "2 réplicas". O valor padrão é 1 Réplica ao usar o console do Google Cloud.
    • Em Configurar conexão, selecione a rede desejada. Para mais detalhes sobre a rede privada do Memorystore para Valkey, consulte Rede.
    • Se você quiser ativar a autenticação do IAM Selecione Ativar IAM AUTH.
    • Se você quiser ativar a criptografia em trânsito Selecione Ativar Transport Layer Security (TLS).
    • Em Escolher versão, selecione a versão do Valkey escolhida. A versão 7.2 do Valkey é o padrão.
  4. Clique no botão Criar instância.

gcloud

Para criar uma instância do Memorystore para Valkey, execute o comando create:

gcloud beta memorystore instances create INSTANCE \
--location=REGION_ID \
--psc-auto-connections=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

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

  • 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ó 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 aceitáveis são valkey_7_2 e valkey_8_0.

  • SHARD_COUNT determina o número de fragmentos nos seus instância. A contagem de fragmentos determina a capacidade total de memória os dados da instância. Para mais detalhes sobre a especificação da instância, consulte Especificação de instância e de nó.

Exemplo:

gcloud beta memorystore instances create my-instance \
--location=us-central1 \
--psc-auto-connections=network=projects/my-project/global/networks/default,projectId=my-project \
--replica-count=2 \
--node-type=highmem-medium \
--shard-count=8

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.

gcloud

Para criar uma instância de zona única, execute o comando create:

gcloud beta memorystore instances create INSTANCE \
--location=REGION_ID \
--psc-auto-connections=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

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 escolhido de réplicas (por fragmento). Os valores aceitos são 0, 1 e 2.

  • 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ó e configurações de instâncias, consulte Especificação de instância e nó.

  • ENGINE_VERSION é a versão do mecanismo do Valkey escolhida. Aceito os valores são valkey_7_2 e valkey_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ância. Para mais informações sobre a especificação de instância, consulte Especificação de instância e de nó.

  • 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 é multirregião. 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.