Como definir parâmetros de escalonamento automático com a API Explorer

Ao usar as ferramentas da CLI gcloud para implantar o aplicativo, como gcloud app deploy, é possível definir os seguintes parâmetros de escalonamento automático no arquivo de configuração app.yaml:

  • min_instances
  • max_instances
  • target_throughput_utilization
  • target_cpu_utilization

Use também a interface do usuário do API Explorer para definir um parâmetro de escalonamento automático:

  1. Abra a página API Explorer.

  2. No painel à direita, abaixo do rótulo Teste esta API, localize a caixa de texto nome e insira a string de nome do aplicativo no formato a seguir:

       apps/<YOUR-PROJECT-ID>/services/default/versions/<YOUR-VERSION-ID>
    

    Substitua YOUR-PROJECT-ID pelo ID do projeto do aplicativo e <YOUR-VERSION-ID> pela versão do aplicativo ao qual você está enviando a solicitação. Use o restante da string da maneira mostrada.

  3. Na caixa de texto updateMask, insira o nome completo do caminho do objeto .json do parâmetro que você está configurando, usando nomes updateMask da tabela abaixo:

    Nome updateMask
    automatic_scaling.standard_scheduler_settings.max_instances
    automatic_scaling.standard_scheduler_settings.min_instances
    automatic_scaling.standard_scheduler_settings.target_cpu_utilization
    automatic_scaling.standard_scheduler_settings.target_throughput_utilization

    Se você estiver configurando mais de um parâmetro em uma solicitação, insira o nome da máscara para cada parâmetro, separado por uma vírgula. Por exemplo, se você estiver definindo as instâncias mínima e máxima e a utilização da CPU, use a updateMask a seguir:

        automatic_scaling.standard_scheduler_settings.max_instances,
        automatic_scaling.standard_scheduler_settings.min_instances,
        automatic_scaling.standard_scheduler_settings.target_cpu_utilization
    
  4. Na caixa Corpo da solicitação, clique em Adicionar parâmetros do corpo da solicitação.

  5. Selecione automaticScaling.

  6. Clique no balão de dica (o ícone +) e, em seguida, selecione standardSchedulerSettings.

  7. Clique no balão de dica, selecione o parâmetro do programador de escalonamento automático que você quer e insira o valor pretendido.

  8. Para fornecer outro parâmetro do programador de escalonamento automático, clique no balão de dica novamente, selecione o parâmetro e informe o respectivo valor.

    No exemplo a seguir, apresentamos uma amostra de corpo de solicitação preenchido:

       {
         "automaticScaling": {
            "standardSchedulerSettings": {
              "maxInstances": 100,
              "minInstances": 1,
              "targetCpuUtilization": 0.75
            }
         }
       }
    
  9. Clique em Executar. Talvez você tenha que autorizar a API Explorer na primeira vez que executar esse comando. Se necessário, siga as instruções para autorizar a API Explorer.

  10. Confirme se as configurações corretas foram aplicadas abrindo a página de versões do App Engine para seu projeto e clicando em Visualizar na coluna Config. Você verá os valores que acabou de definir.