Como gerenciar autoescaladores

Com estas instruções, execute as tarefas administrativas dos autoescaladores como criar, listar, receber informações, atualizar e excluir um autoescalador.

Antes de começar

• Para usar os exemplos de linha de comando deste guia, siga estas etapas:
  1. Instale ou atualize a ferramenta de linha de comando gcloud para a versão mais recente.
  2. Defina uma região e uma zona padrão.
• Para usar os exemplos de API deste guia, configure o acesso à API.
• Leia a documentação de Escalonamento automático.

Criar um autoescalador

Dependendo da política de escalonamento automático utilizada, a criação de um autoescalador é um pouco diferente. Para instruções sobre como criar um autoescalador, consulte:

• Escalonamento com base na capacidade de serviço da CPU ou do balanceamento de carga
• Escalonamento com base em métricas do Stackdriver Monitoring

Receber informações sobre um autoescalador

Para mais informações sobre um autoescalador específico ou para confirmar que um autoescalador foi criado com sucesso, use o subcomando instance-groups managed describe ou o método get() na API.

gcloud

Na ferramenta gcloud, use o subcomando describe:

gcloud compute instance-groups managed describe GROUP

API

NA API, faça uma solicitação GET:

GET https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler

200 OK

{

 "kind": "compute#autoscaler",
 "name": "",
 "target": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instanceGroupManagers/test-managed-group",
 "autoscalingPolicy": {
  "minNumReplicas": 2,
  "maxNumReplicas": 10,
  "coolDownPeriodSec": 60,
  "cpuUtilization": {
   "utilizationTarget": 0.8
  }
 },
 "id": "14869149674555507326",
 "creationTimestamp": "2015-03-25T01:56:56.084711335+00:00",
 "selfLink": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler"
}

Atualizar um autoescalador

Atualize um autoescalador usando o comando set-autoscaling na ferramenta de linha de comando gcloud ou o método PUT na API.

Ao atualizar um autoescalador, defina todas as configurações dele em sua solicitação, como se ele estivesse sendo criado pela primeira vez. Caso contrário, as configurações não definidas explicitamente na solicitação são redefinidas como valores padrão.

Por exemplo, se você atualiza os números máximo e mínimo de réplicas com um novo valor, mas não define explicitamente os outros parâmetros de configuração — como a utilização de CPU pretendida, o período de resfriamento, entre outros — os parâmetros não definidos são redefinidos com os valores padrão.

Quando você atualiza um autoescalador, é possível que leve algum tempo para as alterações se propagarem e alguns minutos até que as novas configurações sejam aplicadas.

gcloud

Os campos obrigatórios para criar um autoescalador também são obrigatórios para todas as solicitações de atualização:

gcloud compute instance-groups managed set-autoscaling GROUP \
    --max-num-replicas MAX_NUM ...

Para instruções sobre como criar um autoescalador, consulte Como escalonar com base em métricas do Stackdriver Monitoring ou Como escalonar com base na CPU ou no balanceamento de carga.

API

Para atualizar o autoescalador, forneça um corpo de solicitação de atualização usando o método PUT:

PUT https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler

{
 "name": "example-autoscaler",
 "autoscalingPolicy": {
  "cpuUtilization": {
   "utilizationTarget": 0.5
  },
  "maxNumReplicas": 20
 },
 "target": "https://www.googleapis.com/replicapool/v1beta2/projects/myproject/zones/us-central1-f/instanceGroupManagers/test-managed-group"
}

200 OK

{
 "kind": "autoscaler#operation",
 "name": "example-autoscaler",
 "operationType": "update",
 "targetLink": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler",
 "targetId": "2335397567958752451",
 "status": "DONE",
 "progress": 100
}

Quando você faz solicitações para modificar dados, um recurso de Operação de zona é retornado, e é possível consultar a operação para verificar o status da alteração.

Parar um autoescalador

gcloud

Para interromper um autoescalador, use o subcomando stop-autoscaling.

gcloud compute instance-groups managed stop-autoscaling GROUP

Quando um autoescalador é parado, ele é excluído do grupo de instâncias gerenciadas. Se você quiser reiniciá-lo, recrie o autoescalador com o comando set-autoscaling.

Se você exclui um grupo de instâncias gerenciadas com a ferramenta gcloud, todos os autoescaladores vinculados a esse grupo também são excluídos.

API

Na API, faça uma solicitação usando o método DELETE para excluir um autoescalador:

 DELETE https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler