Criar e gerenciar instâncias do Memcached

Esta página descreve como usar o console do Google Cloud e a CLI do Google Cloud para criar e gerenciar instâncias do Memorystore para Memcached.

Consulte Práticas recomendadas para provisionar instâncias do Memcached para orientações sobre a criação de instâncias.

Para ver uma lista das permissões necessárias para criar e gerenciar instâncias do Memcached, consulte Controle de acesso e permissões.

Como criar instâncias do Memcached

Para criar uma instância do Memcached:

Console

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

  2. Clique no botão Criar instância.

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

    • Insira um Código de instância usando apenas letras minúsculas, números e hifens. Comece com uma letra.
      • Por exemplo, my-memcached-instance-1
    • Opcionalmente, insira um Nome de exibição para a instância.
    • Escolha uma região na lista suspensa Região.
    • Escolha Automatically distribute ou uma zona preferida na lista suspensa Zona.
    • Escolha o número pretendido de nós.
    • Escolha a memória por nó que você quer.
    • Escolha os núcleos por nó pretendidos.
    • Escolha a versão desejada.

    • Selecione a Rede autorizada pretendida.

  4. Clique em Criar

gcloud

  1. Defina o projeto padrão no qual criar uma instância do Memcached. Digite o seguinte comando, substituindo highlighted-variables pelos valores apropriados:

    gcloud config set core/project project-id

  2. Crie uma instância do Memcached:

    gcloud memcache instances create instance-id --node-count=number-of-nodes --node-cpu=number-of-cpus --node-memory=memory-per-node --region=region --zones=zone(s) --memcached-version=memcached-version

    Em que:

    • instance-id é o ID atribuído à instância. O ID da instância precisa ter de 1 a 63 caracteres e usar apenas letras minúsculas, números ou hifens. Precisa começar com uma letra minúscula e terminar com uma letra minúscula ou um número.
    • number-of-nodes é a contagem de nós desejada.
    • number-of-cpus é a contagem de vCPUs desejada.
      • Valores aceitáveis: 1 ou 2-32 (somente valores pares).
      • Cada vCPU requer 0,9 GB de memória do nó e é compatível com até 8 GB de memória do nó.

    • memory-per-node é a memória desejada para cada nó.

      • Mínimo: 1 GB ou (0,9 GB * vCPUs por nó), o que for maior.
      • Máximo: 256 GB.

    • region é a região em que os nós serão criados.

    • zone(s) são as zonas em que os nós serão criados.

      • Exclua a sinalização --zones para distribuir automaticamente os nós entre as zonas.

    • memcached version é a versão do Memcached desejada para a instância. Os valores aceitáveis são 1.5 e 1.6.15.

    Exemplo:

    gcloud memcache instances create myinstance --node-count=3 --node-cpu=2 --node-memory=2GB --region=us-central1 --zones=us-central1-a,us-central1-b,us-central1-c --memcached-version=1.6.15

Como criar uma instância do Memcached que usa um intervalo de endereços IP específico

Console

  1. Siga as instruções em Como criar instâncias do Memcached até chegar à seção Selecionar intervalos de IP (opcional).

  2. Use o menu suspenso Selecionar intervalos de IP para escolher um intervalo alocado existente para sua rede. Para Para aprender a criar e listar alocações de intervalos de IP para acesso a serviços particulares, consulte Criar uma alocação de IP e Listar intervalos de endereços IP alocados.

gcloud

Crie uma instância do Memcached:

gcloud memcache instances create instance-id --node-count=number-of-nodes --node-cpu=number-of-cpus --node-memory=memory-per-node --region=region --zones=zone(s) --authorized-network=network --reserved-ip-range-id=range-name(s)

Substitua:

  • instance-id é o ID atribuído à instância. Seu o ID da instância precisa ter de 1 a 63 caracteres e usar apenas letras minúsculas letras, números ou hifens. Ele precisa começar com uma letra minúscula e terminar com uma letra minúscula ou um número.
  • number-of-nodes é a contagem de nós desejada.
  • number-of-cpus é a contagem de vCPUs desejada.
    • Valores aceitáveis: 1 ou 2-32 (somente valores pares).
    • Cada vCPU requer 0,9 GB de memória do nó e é compatível com até 8 GB de memória do nó.

  • memory-per-node é a memória desejada para cada nó.

    • Mínimo: 1 GB ou (0,9 GB * vCPUs por nó), o que for maior.
    • Máximo: 256 GB.

  • region é a região em que os nós serão criados.

  • zone(s) são as zonas em que os nós serão criados.

    • Exclua a sinalização --zones para distribuir automaticamente os nós entre as zonas.

  • network é a rede usada para criar a instância. Ele usa o formato projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID. O ID de rede usado aqui precisa corresponder ao ID de rede e o intervalo de IP local. Caso contrário, a operação de criação falhará.

  • range-name(s) é o nome de um ou mais atributos particulares alocados e intervalos de acesso a serviços do Google. Para instruções sobre como criar e listar alocações de intervalos de IP para acesso a serviços particulares, consulte Criar uma alocação de IP e Listar intervalos de endereços IP alocados.

Exemplo:

gcloud memcache instances create myinstance --node-count=3 --node-cpu=2 --node-memory=2GB --region=us-central1 --zones=us-central1-a,us-central1-b,us-central1-c --authorized-network=projects/my-project-335118/global/networks/default --reserved-ip-range-id=myrange1,myrange2

Como visualizar informações da instância

Para visualizar as informações de uma instância:

Console

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

  2. Clique no código da instância para ver as informações.

gcloud

  1. Para ver a lista de todas as instâncias do Memcached em uma região, digite o seguinte comando:

    gcloud memcache instances list --region=region-id

  2. Para visualizar os detalhes de uma instância, insira o seguinte comando:

    gcloud memcache instances describe instance_id --region=region_id

Como editar instâncias

Para editar uma instância:

Console

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

  2. Clique no Código da instância que você quer editar.

  3. Clique no botão Editar.

    1. Na página Editar instância do Memcached, você pode alterar:

  4. Clique no botão Save.

Enquanto as atualizações estão sendo feitas, um círculo de roda dentada aparece ao lado da instância na página inicial do Memorystore para Memcached. Quando as atualizações terminam, o círculo se torna uma marca de seleção verde.

gcloud

Depois de criar uma instância, é possível atualizar as seguintes propriedades:

Por exemplo, digite o seguinte comando para atualizar o nome de exibição e os rótulos de uma instância, substituindo variables pelos valores apropriados:

gcloud memcache instances update instance-id --region=region-id --display-name=name --labels=key=value

Excluir instâncias

Para excluir uma instância:

Console

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

  2. Clique no código da instância.

  3. Clique no botão Excluir.

  4. Confirme que você quer excluir a instância digitando o código da instância e clicando no botão Excluir.

gcloud

  1. Para excluir uma instância, digite o seguinte comando:

    gcloud memcache instances delete instance-id --region=region-id

A seguir