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 um destes papéis do IAM no projeto 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 rede 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 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ó e configurações de instância, consulte Especificação de instância e de nó.

  • 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âncias e nós.

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

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