Criar instâncias

Esta página contém instruções para criar instâncias do Memorystore para Valkey.

Antes de começar

Conclua 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 predefinido do IAM de administrador do Memorystore)
    • roles/owner (o papel básico do IAM "Proprietário")
    • roles/editor (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 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 as configurações que você quer para a nova instância.

    • Em Nome da 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.
    • Em Tipo de nó, selecione o tipo de nó escolhido.
    • Em Tamanho da instância, defina 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 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 Replica 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 quiser ativar a autenticação do IAM, selecione Ativar AUTH do IAM.
    • Se você quiser ativar a criptografia em trânsito, selecione Ativar segurança da camada de transporte (TLS).
    • Em Choose version, selecione a versão da 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ós e configurações de instância, consulte Especificação de instâncias e nós.

  • ENGINE_VERSION é a versão do mecanismo do 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â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ós e configurações de instância, consulte Especificação de instâncias e nós.

  • ENGINE_VERSION é a versão do mecanismo 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â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.