Criar instâncias

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

Antes de começar

Conclua as instruções em "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 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ê instalou a CLI gcloud anteriormente, 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 para 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

  • Você precisa ter um destes papéis do IAM no projeto do Google Cloud que está usando:
    • roles/memorystore.admin (o papel predefinido de administrador do Memorystore no IAM)
    • roles/owner (o papel básico Proprietário do IAM)
    • roles/editor (o papel básico de editor do IAM)

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

Console

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

    Memorystore for Valkey

  2. Clique em Criar instância.

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

    • Em Nomeie sua instância, insira um ID de 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.
      • Por exemplo, my-instance-1.
    • Em Escolher região, selecione uma região para a instância.
    • Em Tipo de nó, selecione seu tipo de nó.
    • Em Modo, selecione Modo cluster ativado ou Modo cluster desativado.
    • Em Tamanho da instância, defina o número de fragmentos para a 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 de instância e fragmento.
    • Se 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 "Nenhuma réplica", "1 réplica" e "2 réplicas". O valor padrão é 1 réplica ao usar o console Google Cloud .
    • Em Configurar conexão, selecione a rede desejada. Para mais detalhes sobre redes particulares no 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 Escolher versão, selecione sua versão do Valkey. A versão 7.2 do Valkey é a 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 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 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âncias, consulte Especificação de instância e nó.

  • ENGINE_VERSION é a versão do mecanismo Valkey escolhida. Os valores aceitos 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â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.

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.

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

  • ENGINE_VERSION é a versão do mecanismo Valkey escolhida. Os valores aceitos 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 da instância. 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.

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