Esta página descreve como usar o console do Google Cloud e a Google Cloud CLI 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
Acesse a página Memorystore para Memcached no console do Google Cloud.
Memorystore para MemcachedClique no botão Criar instância.
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
- Por exemplo,
- 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.
- Insira um Código de instância usando apenas letras minúsculas, números e hifens. Comece com uma letra.
Clique em Criar
gcloud
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
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. 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
ou2-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ó.
- Valores aceitáveis:
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.
- Exclua a sinalização
memcached version é a versão do Memcached desejada para a instância. Os valores aceitáveis são
1.5
e1.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
Siga as instruções em Como criar instâncias do Memcached até chegar à seção Selecionar intervalos de IP (opcional).
Use o menu suspenso Selecionar intervalos de IP para escolher um intervalo alocado para sua rede. 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.
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. 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.
- number-of-nodes é a contagem de nós desejada.
- number-of-cpus é a contagem de vCPUs desejada.
- Valores aceitáveis:
1
ou2-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ó.
- Valores aceitáveis:
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.
- Exclua a sinalização
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 em que o intervalo de IP alocado está localizado. Caso contrário, a operação de criação falhará.range-name(s) é o nome de um ou mais intervalos de acesso a serviços privados alocados. 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
Acesse a página Memorystore para Memcached no console do Google Cloud.
Memorystore para MemcachedClique no código da instância para ver as informações.
gcloud
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
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
Acesse a página Memorystore para Memcached no console do Google Cloud.
Memorystore para MemcachedClique no Código da instância que você quer editar.
Clique no botão Editar.
Na página Editar instância do Memcached, você pode alterar:
- Número de nós: consulte Como escalonar instâncias do Memcached para mais detalhes.
- Display name
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:
Número de nós: consulte Como escalonar instâncias do Memcached para mais detalhes.
Configuração do Memcached: consulte Como configurar instâncias do Memcached para mais detalhes.
Rótulos
Display name
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
Acesse a página Memorystore para Memcached no console do Google Cloud.
Memorystore para MemcachedClique no código da instância.
Clique no botão Excluir.
Confirme que você quer excluir a instância digitando o código da instância e clicando no botão Excluir.
gcloud
Para excluir uma instância, digite o seguinte comando:
gcloud memcache instances delete instance-id --region=region-id