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

Se você usar as ferramentas do SDK do Cloud para implantar o aplicativo, como gcloud app deploy ou plug-ins relacionados ao SDK do Cloud para Maven, Gradle, IntelliJ ou Eclipse, é possível definir os seguintes parâmetros de escalonamento automático no arquivo de configuração appengine-web.xml:

  • min_instances
  • max_instances
  • target_throughput_utilization
  • target_cpu_utilization
No entanto, se você implantar usando a ferramenta appcfg do SDK do App Engine para Java 8, não será possível definir esses parâmetros de escalonamento automático no arquivo de configuração appengine-web.xml. Em vez disso, você precisa omitir esses parâmetros do arquivo de configuração e defini-los diretamente na interface do usuário do APIs Explorer após implantar o aplicativo.

Para usá-lo na definição de um parâmetro de escalonamento automático, siga estas etapas:

  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, autorize a API Explorer seguindo as instruções.

  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.