Use estas instruções para executar tarefas administrativas de escalonadores automáticos, como criar, descrever, atualizar, interromper e excluir um escalonador automático.
Antes de começar
- Para usar os exemplos de linha de comando deste guia, faça o seguinte:
- Instale a ferramenta de linha de comando gcloud ou atualize-a para a versão mais recente.
- Defina uma região e uma zona padrão.
- Para usar os exemplos de API deste guia, configure o acesso a ela.
- Examine a visão geral sobre escalonamento automático.
Como criar um escalonador automático
Dependendo da política de escalonamento automático utilizada, a criação de um escalonador automático é um pouco diferente. Para instruções sobre como criar um escalonador automático, consulte:
- Como escalonar com base em CPU ou na capacidade de serviço do balanceamento de carga
- Como escalonar com base em métricas do Stackdriver Monitoring
Como receber informações sobre um escalonador automático
Para mais informações sobre um escalonador automático específico ou para confirmar que um escalonador automático foi criado com sucesso, use o subcomando gcloud compute instance-groups managed describe
ou o método get
na API para um recurso de escalonador automático por zona ou por região.
Console
- Acesse a página "Grupos de instâncias" no Console do GCP.
- Clique no nome de um grupo de instâncias na lista para abrir a respectiva página de detalhes.
- Clique em Detalhes para ver os detalhes do grupo, incluindo as configurações de escalonamento automático.
gcloud
Na ferramenta de linha de comando gcloud
, use o subcomando describe
:
gcloud compute instance-groups managed describe GROUP
API
Para recuperar detalhes sobre um recurso de escalonador automático para um grupo de instâncias gerenciadas por zona, use o método get
do escalonador automático. Para um grupo de instâncias gerenciadas por região, use o método get
do regionAutoscaler.
GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler
200 OK { "kind": "compute#autoscaler", "name": "", "target": "https://compute.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://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler" }
Como atualizar um escalonador automático
Para atualizar um escalonador automático, use o console, a ferramenta gcloud
ou a API.
Quando você atualiza um escalonador automático, é possível que leve algum tempo para as alterações se propagarem e alguns minutos até que as novas configurações sejam aplicadas.
Console
- Acesse a página "Grupos de instâncias" no Console do GCP.
- Clique no nome de um grupo de instâncias na lista para abrir a respectiva página de detalhes.
- Clique em Editar grupo para ver e atualizar a configuração atual do grupo, incluindo as configurações de escalonamento automático dele.
- Clique em Salvar quando terminar.
gcloud
Use o subcomando set-autoscaling
.
Defina todas as configurações do escalonador automático 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 serão redefinidas com valores padrão.
gcloud compute instance-groups managed set-autoscaling GROUP \
--max-num-replicas MAX_NUM ...
Para instruções sobre como criar um escalonador automático, consulte Como escalonar com base em métricas do Stackdriver Monitoring ou Como escalonar com base em CPU ou na capacidade de serviço do balanceamento de carga.
API
Para atualizar um recurso do escalonador automático para um grupo de instâncias gerenciadas por zona, use o método patch
do escalonador automático por zona. Para um grupo de instâncias gerenciadas por região, use o método patch
do regionAutoscaler. Forneça um corpo de solicitação que contenha a nova configuração.
PATCH https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler
{
"autoscalingPolicy": {
"maxNumReplicas": 20
}
}
200 OK { "kind": "compute#operation", "id": "4244494732310423322", "name": "operation-1556912627871-58800f8216ed7-74ab1720-7d360603", "zone": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f", "operationType": "compute.autoscalers.patch", "targetLink": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler", "targetId": "340775527929467142", "status": "RUNNING", ... }
Quando você faz solicitações para modificar dados, um recurso zoneOperations é retornado, e é possível consultar a operação para verificar o status da alteração.
Como desativar ou restringir um escalonador automático (Beta)
Desative o escalonador automático para impedir temporariamente o escalonamento do grupo de instâncias, ou restrinja o escalonador automático para que ele só possa escalonar seu grupo de instâncias. Esse recurso é útil quando você quer fazer uma das opções a seguir:
- investigar instâncias sem interferência de redução de escalonamento;
- reconfigurar várias propriedades de seu grupo de instâncias gerenciadas sem que as ações de escalonamento sejam acionadas enquanto seu grupo é apenas parcialmente reconfigurado;
- manter a capacidade do grupo de instâncias para uma rápida reversão durante o redirecionamento de uma carga de trabalho para um novo grupo de instâncias.
Se e quando você reativar o escalonador automático, ele voltará automaticamente para a operação normal.
No console, na ferramenta gcloud
ou na API, defina o mode
do escalonador automático como:
OFF
: desativa temporariamente o escalonamento automático. Use esse modo para evitar alterações automáticas do tamanho do grupo de instâncias. A configuração do escalonamento automático permanece intacta para que você possa reativá-lo mais tarde;ONLY_UP
: restrinja o escalonamento automático apenas para adicionar novas instâncias. Use esse modo para impedir que o grupo seja reduzido e permita que o grupo provisione VMs extras quando a carga aumentar;ON
: ativa todas as operações de escalonamento automático de acordo com a política.
Console
- Acesse a página "Grupos de instâncias" no Console do GCP.
- Clique no nome de um grupo de instâncias na lista para abrir a respectiva página de detalhes.
- Clique em Editar grupo para ver a configuração atual do grupo, incluindo as configurações de escalonamento automático.
- Em Escalonamento automático, defina o Modo de escalonamento automático para desativar ou restringir o escalonamento automático para o grupo ou para ativar o escalonador automático novamente.
gcloud
Use o subcomando set-autoscaling
Beta com a sinalização --mode
para desativar, restringir ou ativar um escalonador automático.
Defina todas as configurações do escalonador automático 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 serão redefinidas com valores padrão.
gcloud beta compute instance-groups managed set-autoscaling GROUP \
--mode [MODE] ...
Em que:
[MODE]
é:OFF
para desativar o escalonador automático, mas manter a configuração;ONLY_UP
para restringir o escalonador automático a adicionar apenas instâncias;ON
para reativar todas as atividades do escalonador automático de acordo com a política.
API
Para atualizar o modo de um recurso de escalonador automático para um grupo de instâncias gerenciadas por zona, use o método patch
do escalonador automático. Para um grupo de instâncias gerenciadas por região, use o método patch
do regionAutoscaler. Forneça um corpo de solicitação que inclua a propriedade autoscalingPolicy.mode
.
PATCH https://www.googleapis.com/compute/beta/projects/my-project/regions/us-central1-f/autoscalers?autoscaler=my-autoscaler
{
"autoscalingPolicy": {
"mode":"[MODE]"
}
}
Em que:
[MODE]
é:OFF
para desativar o escalonador automático, mas manter a configuração;ONLY_UP
para restringir o escalonador automático a adicionar apenas instâncias;ON
para reativar todas as atividades do escalonador automático de acordo com a política.
Como excluir um escalonador automático
É possível excluir permanentemente o recurso do escalonador automático usando o console, a ferramenta gcloud
ou a API. Se você quiser interromper temporariamente o recurso de escalonamento automático e mantê-lo junto com a configuração, desative o escalonador automático.
Console
- Acesse a página "Grupos de instâncias" no Console do GCP.
- Clique no nome de um grupo de instâncias na lista para abrir a respectiva página de detalhes.
- Clique em Editar grupo para ver a configuração atual do grupo, incluindo as configurações de escalonamento automático.
- Em Escalonamento automático, clique em Excluir configuração de escalonamento automático para interromper o escalonador automático e excluir a configuração dele.
gcloud
Use o subcomando stop-autoscaling
para interromper um escalonador automático e excluir a configuração dele.
gcloud compute instance-groups managed stop-autoscaling GROUP
Quando um escalonador automático é interrompido, ele é excluído do grupo de instâncias gerenciadas. Para reiniciar o escalonador automático, recrie-o usando o comando set-autoscaling
.
Se você excluir um grupo de instâncias gerenciadas usando a ferramenta gcloud
, todos os escalonadores automáticos anexados ao grupo de instâncias gerenciadas também serão excluídos.
API
Na API, faça uma solicitação usando o método DELETE
para interromper um escalonador automático e excluir a configuração dele:
DELETE https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/autoscalers/example-autoscaler