Todos os produtos
Search
Central de documentação

Platform For AI:Referência de comandos do EASCMD

Última atualização: Jun 27, 2026

Use a CLI EASCMD para gerenciar serviços do EAS: crie, atualize, exclua e monitore serviços, gerencie grupos de recursos e execute testes de estresse. Cada comando inclui sintaxe, parâmetros e exemplos.

Comandos operacionais

A tabela a seguir lista os comandos disponíveis do EASCMD.

Nota

O nome do executável para executar os comandos pode variar conforme o arquivo de cliente.

Tipo

Operação

Descrição

Serviços

Você pode usar a CLI EASCMD das seguintes formas:

Grupos de recursos

Fazer upload de arquivos

  • Descrição

    O EAS fornece um repositório OSS para cada usuário. Use o comando upload para enviar modelos ou Processors e obter o caminho do OSS.

  • Sintaxe

    eascmd upload <filename> [--keep]
  • Parâmetros

    • <filename>: Nome do arquivo a ser enviado.

    • [--keep]: Preserva a estrutura de diretórios do arquivo de origem.

  • Exemplo

    No DSW, envie o arquivo SavedModel compactado savedmodel_example/savedmodel_example.tar.gz para o OSS.

    eascmd upload savedmodel_example/savedmodel_example.tar.gz --keep

    O sistema retorna uma resposta semelhante à seguinte.

    [OK] oss endpoint:    [http://oss-cn-shanghai.aliyuncs.com]
    [OK] oss target path: [oss://eas-model-shanghai/182848887922****/savedmodel_example/savedmodel_example.tar.gz]
    Succeed: Total num: 1, size: 33,013. OK num: 1(upload 1 files).

    Use o caminho do OSS oss://eas-model-shanghai/182848887922****/savedmodel_example/savedmodel_example.tar.gz para implantar o serviço.

Crie um serviço

  • Descrição

    Execute o comando create para criar um serviço. Forneça a URL HTTP ou OSS de um recurso (pacote de modelo ou processor). Envie o recurso para o OSS para obter a URL.

  • Sintaxe

    <eascmd64> create <service_desc_json>
  • Parâmetros

    service_desc_json: Arquivo JSON que descreve o serviço, incluindo o local de armazenamento do modelo e as especificações de recursos. Exemplo de conteúdo do arquivo:

    {
      "name": "mnist_saved_model_example",
      "model_path": "http://eas-data.oss-cn-shanghai.aliyuncs.com/models%2Fmnist_saved_model.tar.gz",
      "processor": "tensorflow_cpu_1.12",
      "metadata": {
        "instance": 1,
        "cpu": 1
      }
    }

    Para obter mais informações sobre os parâmetros de serviço no arquivo JSON, consulte Implantação JSON.

  • Exemplo (O arquivo JSON chama-se pmml.json.)

    <eascmd64> create pmml.json

    O sistema retorna uma resposta semelhante à seguinte.

    [RequestId]: 1651567F-8F8D-4A2B-933D-F8D3E2DD****
    +-------------------+----------------------------------------------------------------------------+
    | Intranet Endpoint | http://pai-eas-vpc.cn-shanghai.aliyuncs.com/api/predict/savedmodel_example |
    |             Token | YjQxZDYzZTBiZTZjMzQ5ZmE0MzczZjIxMGZiNzZmMDBkY2VjMDg4****                   |
    +-------------------+----------------------------------------------------------------------------+
    [OK] Creating api gateway
    [OK] Building image [registry-vpc.cn-shanghai.aliyuncs.com/eas/savedmodel_example_cn-shanghai:v0.0.1-20190224001315]
    [OK] Pushing image [registry-vpc.cn-shanghai.aliyuncs.com/eas/savedmodel_example_cn-shanghai:v0.0.1-20190224001315]
    [OK] Waiting [Total: 1, Pending: 1, Running: 0]
    [OK] Waiting [Total: 1, Pending: 1, Running: 0]
    [OK] Service is running

Modifique configurações de serviço

  • Descrição

    Use a opção -D com o comando modify para alterar metadata, como a contagem de Instance e a alocação de CPU.

  • Sintaxe

    <eascmd64> modify <service_name> -Dmetadata.<attr_name>=<attr_value>

    Configure vários parâmetros simultaneamente.

  • Parâmetros

    • <service_name>: Nome do serviço.

    • <attr_name>: Nome do parâmetro.

    • <attr_value>: Valor do parâmetro.

  • Exemplo

    Define o número de instâncias como 10 e aloca 5 núcleos de CPU para cada instância.

    <eascmd64> modify service_test -Dmetadata.instance=10 -Dmetadata.cpu=5

    Para dimensionar um serviço, modifique apenas o parâmetro metadata.instance. Aumentar a contagem inicia novas instâncias sem afetar as existentes. Diminuir a contagem interrompe as instâncias excedentes.

    Nota

    Diferentemente de uma atualização completa, uma atualização que modifica apenas a contagem de Instance não aciona uma atualização contínua do serviço.

Modifique um serviço

  • Descrição

    Use o comando modify para alterar a configuração de um serviço implantado.

  • Sintaxe

    <eascmd64> modify <service_name> -s <service_desc_json>
  • Parâmetros

    • <service_name>: Nome do serviço.

    • <service_desc_json>: Arquivo de descrição do serviço.

      Nota

      Inclua no arquivo de descrição do serviço apenas os parâmetros que precisam de modificação. Se você incluir o arquivo de modelo e as informações do processor, o sistema tratará isso como a adição de uma nova versão do serviço.

Adicionar uma versão a um serviço

  • Descrição

    Use o comando modify para adicionar uma nova versão a um serviço implantado.

  • Sintaxe

    <eascmd64> modify <service_name> -s <service_desc_json>
  • Parâmetros

    • <service_name>: Nome do serviço.

    • <service_desc_json>: Arquivo de descrição do serviço.

      Nota

      Especifique o arquivo de modelo e as informações do processor no arquivo de descrição do serviço.

Parar um serviço

  • Descrição

    Use o comando stop para parar um serviço em execução.

  • Sintaxe

    <eascmd64> stop <service_name>
  • Parâmetros

    <service_name>: Nome do serviço a ser parado.

Iniciar um serviço

  • Descrição

    Use o comando start para reiniciar um serviço parado.

  • Sintaxe

    <eascmd64> start <service_name>
  • Parâmetros

    <service_name>: Nome do serviço a ser iniciado.

Exclua um serviço

  • Descrição

    Use o comando delete para excluir um serviço. Apenas serviços na região atual podem ser excluídos.

  • Sintaxe

    <eascmd64> delete <service_name>
  • Parâmetros

    <service_name>: Nome do serviço a ser excluído.

  • Exemplo

    Para excluir o serviço chamado savedmodel_example:

    1. Execute o comando delete.

      <eascmd64> delete savedmodel_example

      O sistema retorna um prompt de confirmação.

      Are you sure to delete the service [savedmodel_example] in [cn-shanghai]? [Y/n]
    2. Insira Y. O sistema retorna uma resposta semelhante à seguinte.

      [RequestId]: 1651567F-8F8D-4A2B-933D-F8D3E2DD****
      [OK] Service [savedmodel_example] in region [cn-shanghai] is terminating
      [OK] Service is terminating
      [OK] Service is terminating
      [OK] Service was deleted successfully

Implementar uma liberação blue-green

  • Descrição

    Execute o comando create -r para criar um serviço associado a um serviço existente e, em seguida, execute o comando release para ajustar a distribuição de tráfego. O parâmetro name no arquivo JSON deve corresponder ao nome do serviço existente. O sistema adiciona automaticamente um sufixo aleatório para gerar o nome do novo serviço.

    Excluir o novo serviço direciona todo o tráfego para o serviço existente. Excluir o serviço existente direciona todo o tráfego para o novo serviço. O endpoint original (por exemplo, {domain}/api/predict/savedmodel_example) permanece como a entrada de tráfego em todas as iterações blue-green — nenhuma alteração é necessária no lado do cliente.

    Nota

    A liberação blue-green não é suportada para conexões diretas.

  • Sintaxe

    1. Crie um serviço associado.

      <eascmd64> create <service_desc_json> -r
    2. Ajuste a proporção de tráfego dos serviços em uma liberação blue-green.

      <eascmd64> release <service_name> -w <weight>
  • Parâmetros

    • <service_desc_json>: Arquivo JSON que descreve as informações sobre o novo serviço.

    • <service_name>: Nome do novo serviço.

    • <weight>: Proporção de tráfego destinada ao novo serviço.

  • Exemplo (O arquivo JSON chama-se pmml.json.)

    1. Crie um serviço associado.

      <eascmd64> create pmml.json -r

      O sistema retorna informações semelhantes às seguintes:

      [RequestId]: 1651567F-8F8D-4A2B-933D-F8D3E2DD****
      +-------------------+----------------------------------------------------------------------------+
      | Intranet Endpoint | http://xxx.cn-shanghai.pai-eas.aliyuncs.com/api/predict/savedmodel_example_9c16a222 |
      |             Token | YjQxZDYzZTBiZTZjMzQ5ZmE0MzczZjIxMGZiNzZmMDBkY2VjMDg4****                   |
      +-------------------+----------------------------------------------------------------------------+
      [OK] Building image [registry-vpc.cn-shanghai.aliyuncs.com/eas/savedmodel_example_9c16a222_cn-shanghai:v0.0.1-20190224001315]
      [OK] Pushing image [registry-vpc.cn-shanghai.aliyuncs.com/eas/savedmodel_example_9c16a222_cn-shanghai:v0.0.1-20190224001315]
      [OK] Waiting [Total: 1, Pending: 1, Running: 0]
      [OK] Waiting [Total: 1, Pending: 1, Running: 0]
      [OK] Service is running

      Um serviço chamado savedmodel_example_9c16a222 é criado. Os serviços novo e existente possuem endpoints independentes e podem ser testados separadamente. Após os testes, ajuste a distribuição de tráfego.

    2. Ajuste a proporção de tráfego dos serviços em uma liberação blue-green.

      <eascmd64> release savedmodel_example_9c16a222 -w 20

      Isso direciona 20% do tráfego para savedmodel_example_9c16a222 e 80% para savedmodel_example. O endpoint independente {domain}/api/predict/savedmodel_example_9c16a222 é desativado. Todo o tráfego entra pelo endpoint original {domain}/api/predict/savedmodel_example e é dividido adequadamente.

      O sistema retorna informações semelhantes às seguintes:

      Confirmed to release this service at weight [20%]? [Y/n]
    3. Pressione a tecla Y e depois a tecla Enter. O sistema retorna informações semelhantes à seguinte saída:

      [RequestId]: 9258EEDE-6F99-4C3B-841B-B6E9774F****
      [OK] Service [savedmodel_example_9c16a222] is weighted to 20% now

Alternar entre versões de serviço

  • Descrição

    Use o comando desc para visualizar as versões disponíveis de um serviço. Em seguida, use o comando version para alternar o serviço para uma versão diferente.

  • Sintaxe

    <eascmd64> version <service_name> <version_id>
  • Parâmetros

    • <service_name>: Nome do serviço.

    • <version_id>: ID da versão para a qual você deseja alternar.

Visualize a lista de serviços

  • Descrição

    Use o comando list (ou ls) para listar os serviços implantados pelo usuário atual.

  • Sintaxe

    <eascmd64> ls
  • Parâmetros

    N/A

  • Exemplo

    <eascmd64> ls

    O sistema retorna uma resposta semelhante à seguinte.

    [RequestId]: 83945D4E-ED3E-4D35-A989-831E36BB****
    +---------------------------+-------------+----------+---------------------+---------------------+---------+--------+----------------------------------------+
    |        SERVICENAME        |   REGION    | INSTANCE |     CREATETIME      |     UPDATETIME      | STATUS  | WEIGHT |              SERVICEPATH               |
    +---------------------------+-------------+----------+---------------------+---------------------+---------+--------+----------------------------------------+
    | mnist_saved_model_example | cn-shanghai |        1 | 2019-02-21 16:35:41 | 2019-02-21 16:35:41 | Running |      0 | /api/predict/mnist_saved_model_example |
    +---------------------------+-------------+----------+---------------------+---------------------+---------+--------+----------------------------------------+

Visualize detalhes de um serviço

  • Descrição

    Use o comando desc para visualizar informações detalhadas sobre um serviço implantado.

  • Sintaxe

    <eascmd64> desc <service_name>
  • Parâmetros

    <service_name>: Nome do serviço.

  • Exemplo

    <eascmd64> desc mnist_saved_model_example

    O sistema retorna uma resposta semelhante à seguinte.

    +---------------------+--------------------------------------------------------------------------------------------------------------+
    |              Status | Running                                                                                                      |
    |         ServiceName | mnist_saved_model_example                                                                                    |
    |              Region | cn-shanghai                                                                                                  |
    |          CreateTime | 2019-02-21 16:35:41                                                                                          |
    |          UpdateTime | 2019-02-21 16:35:41                                                                                          |
    |         AccessToken |                                                                                                              |
    |        PrivateToken | ZWNjMTNkNDExMmExNjZkYTM4YWQ5YTY0YmFjNjk3YWYzZTRjM2Y2****                                                     |
    |       TotalInstance | 1                                                                                                            |
    |     RunningInstance | 1                                                                                                            |
    |     PendingInstance | 0                                                                                                            |
    |                 CPU | 1                                                                                                            |
    |                 GPU | 0                                                                                                            |
    |              Memory | 1000M                                                                                                        |
    |               Image | registry-vpc.cn-shanghai.aliyuncs.com/eas/mnist_saved_model_example_cn-shanghai:v0.0.1-20190221163541        |
    |              Weight | 0                                                                                                            |
    |       LatestVersion | 1                                                                                                            |
    |      CurrentVersion | 1                                                                                                            |
    |             Message | Service start successfully                                                                                   |
    |       APIGatewayUrl | 1c3b37ea83c047efa0dc6df0cacb****-cn-shanghai.alicloudapi.com/EAPI_182848887922****_mnist_saved_model_example |
    |    APIGatewayAppKey | 2564****                                                                                                     |
    | APIGatewayAppSecret | 12562a7b8858bbba2c2e9c4517ff****                                                                             |
    |    IntranetEndpoint | http://pai-eas-vpc.cn-shanghai.aliyuncs.com/api/predict/mnist_saved_model_example                            |
    |       ServiceConfig | {                                                                                                            |
    |                     |   "generate_token": "false",                                                                                 |
    |                     |   "metadata": {                                                                                              |
    |                     |     "cpu": 1,                                                                                                |
    |                     |     "instance": 1,                                                                                           |                                                                                  |
    |                     |     "region": "cn-shanghai"                                                                                  |
    |                     |   },                                                                                                         |
    |                     |   "model_path":                                                                                              |
    |                     | "http://eas-data.oss-cn-shanghai.aliyuncs.com/models%2Fmnist_saved_model.tar.gz",                            |
    |                     |   "name":                                                                                                    |
    |                     | "mnist_saved_model_example",                                                                                 |
    |                     |   "processor":                                                                                               |
    |                     | "tensorflow_cpu"                                                                                             |
    |                     | }                                                                                                            |
    +---------------------+--------------------------------------------------------------------------------------------------------------+

Visualize processos do serviço

  • Descrição

    Use o comando showworkers (ou w) para visualizar o status dos processos em execução de um serviço.

  • Sintaxe

    <eascmd64> w <service_name>
  • Parâmetros

    <service_name>: Nome do serviço.

  • Exemplo

    <eascmd64> w mnist_saved_model_example

    O sistema retorna uma resposta semelhante à seguinte.

    [RequestId]: B23BA8AC-CDEC-5704-935F-3CEC6606****
    +-------------------------------+-------------+--------------+---------------------+----------+---------+-------+--------+----------------------------------------------------------------------------------------------------------+
    |         INSTANCENAME          |   INNERIP   |    HOSTIP    |       STARTAT       | RESTARTS | STATUS  | READY | REASON |                                                LASTSTATE                                                 |
    +-------------------------------+-------------+--------------+---------------------+----------+---------+-------+--------+----------------------------------------------------------------------------------------------------------+
    | network-test-69cf5dd6c7-5**** | 10.240.XX.XX | 10.224.XX.XX | 2021-09-27 15:04:22 |        1 | Running | [1/1] |        | {"exitCode":247,"finishedAt":"2021-09-27T07:04:21Z","reason":"Error","startedAt":"2021-09-27T05:36:56Z"} |
    +-------------------------------+-------------+--------------+---------------------+----------+---------+-------+--------+----------------------------------------------------------------------------------------------------------+

    A tabela a seguir descreve os parâmetros na resposta.

    Parâmetro

    Descrição

    INSTANCENAME

    Nome da instância do serviço.

    INNERIP

    Endereço IP interno da instância.

    HOSTIP

    Endereço IP do nó onde a instância está localizada.

    STARTAT

    Hora de início da instância.

    RESTARTS

    Número de vezes que a instância foi reiniciada. Reinicializações ocorrem após eventos OOM ou falhas de código.

    STATUS

    Status atual da instância. Pending indica que a instância aguarda agendamento de recursos. Um estado prolongado de Pending indica recursos insuficientes.

    READY

    Status dos contêineres na instância, no formato [Número de contêineres prontos/Número total de contêineres].

    Um status [0/1] indica que o contêiner está iniciando ou falhou na verificação de integridade. Nesse caso, nenhum tráfego é roteado para esta instância.

    Se todas as instâncias em um serviço tiverem um status pronto de [0/1], o serviço inteiro fica indisponível e as solicitações ao serviço retornarão um erro 5xx.

    REASON

    Breve descrição do status da instância.

    LASTSTATE

    Estado da instância em sua última reinicialização. Se o reason em LASTSTATE for OOMKilled, isso indica que a instância sofreu um evento OOM.

Crie uma tarefa de teste de estresse

  • Descrição

    Use o comando bench create para criar uma tarefa de teste de estresse para um serviço implantado.

  • Sintaxe

    <eascmd64> bench create <bench_desc_json>
  • Parâmetros

    bench_desc_json: Arquivo JSON que descreve a tarefa de teste de estresse. A seguir, um exemplo do conteúdo do arquivo.

    {
        "service": {
            "serviceName": "servicename_example"
        },
        "data": {
            "content": "W1sxLDAsMCwwLDEsMSwwLDEsMCwxLDEsMCwwLDEsMCwxLDAsMSwwLDAsMSwxLDEsMCwxLDEsMCwwLDAsMSwxLDEsMCwxLDEsMSwxLDAsMSwxLDEsMCwxLDAsMCwwLDEsMSwwLDAsMCwxLDAsMSwwLDEsMCwwLDEsMCwwLDEsMCwxLDAsMCwxLDAsMCwwLDAsMSwwLDEsMCwxLDAsMCwxLDEsMSwwLDAsMSwwLDAsMCwwLDEsMSwxLDAsMSwxLDAsMCwxLDAsMSwwLDEsMSwxLDEsMCwxLDAsMCwxLDEsMSwxLDAsMCwwLDEsMSwwXV0K"
        }
    }
                    

    Use path para especificar vários arquivos OSS como dados de teste de estresse. A seguir, um exemplo de configuração. Para configurar entradas de dados de teste em massa, compacte os dados da solicitação em um arquivo zip e defina o path como oss://XX.zip.

    {
        "service": {
            "serviceName": "servicename_example"
        },
        "data": {
            "path": "oss://examplebucket/test1.bin,oss://examplebucket/test2.bin"
        }
    }
                    

    Para obter uma descrição detalhada dos parâmetros, consulte Criar uma tarefa de teste de estresse.

  • Exemplo

    Suponha que o arquivo JSON que descreve a tarefa de teste de estresse seja bench.json.

    <eascmd64> bench create bench.json

    O sistema retorna uma resposta semelhante à seguinte.

    [RequestId]: DE240637-4976-59AF-A28C-BAA55C0A****
    [OK] Task [benchmark-servicename-example-b514] is creating
    [OK] [Agnet: 0/1]: Succeed to start benchmark master
    [OK] [Agnet: 0/1]: Succeed to start benchmark master
    [OK] [Agnet: 1/1]: Benchmark task is Running
    [OK] Benchmark task is Running
    [OK] Click the link http://127.0.0.1:18222/eas-benchmark/statsview to observe realtime visualization details, you can turn it off with CTRL+C.
    Turning off will not interrupt the benchmark test task, and you can reopen it by the visualize command:
    eascmd -c [config_file] bench visualize benchmark-servicename-example-b514

Gerencie tarefas de teste de estresse

Visualize tarefas de teste de estresse

  • Descrição

    Use o comando bench list (ou bench ls) para listar as tarefas de teste de estresse criadas pelo usuário atual.

  • Sintaxe

    <eascmd64> bench ls
  • Parâmetros

    N/A

  • Exemplo

    <eascmd64> bench ls

    O sistema retorna uma resposta semelhante à seguinte.

    [RequestId]: 7F953F8E-8897-5785-808A-CA648302****
    +-------------------------+--------------------------+-------------+----------------+---------+---------------------+
    |        TASKNAME         |          TASKID          |   REGION    | AVAILABLEAGENT | STATUS  |     CREATETIME      |
    +-------------------------+--------------------------+-------------+----------------+---------+---------------------+
    | benchmark-xgb-test-7846 | eas-b-ql470xog6qeh25**** | cn-shanghai |              0 | Stopped | 2022-06-17 17:58:01 |
    | benchmark-xgb-test-b514 | eas-b-bdnzvwq0z0h3xq**** | cn-shanghai |              2 | Running | 2022-06-20 12:18:54 |
    +-------------------------+--------------------------+-------------+----------------+---------+---------------------+

Visualize detalhes de uma tarefa de teste de estresse

  • Descrição

    Use o comando bench desc para visualizar informações detalhadas sobre uma tarefa específica de teste de estresse.

  • Sintaxe

    <eascmd64> bench desc <benchmark_task_name>
  • Parâmetros

    benchmark_task_name: Nome da tarefa de teste de estresse.

  • Exemplo

    <eascmd64> bench desc benchmark-demo-test-c7eb

    O sistema retorna uma resposta semelhante à seguinte.

    +----------------+------------------------------------------------------------------------------+
    |     TaskName   | benchmark-xgb-test-b514                                                      |
    |     TaskId     | eas-b-bdnzvwq0z0h3xq****                                                     |
    |    ServiceName | xgb_test                                                                     |
    |         Region | cn-shanghai                                                                  |
    |   DesiredAgent | 2                                                                            |
    | AvailableAgent | 2                                                                            |
    |         Status | Running                                                                      |
    |        Message | Benchmark task is running                                                    |
    |     CreateTime | 2021-10-20 12:38:35                                                          |
    |     UpdateTime | 2021-10-20 12:38:45                                                          |
    |         Config | {                                                                            |
    |                |   "base": {                                                                  |
    |                |     "agentCount": 2,                                                         |
    |                |     "concurrency": 40,                                                       |
    |                |     "duration": 1200,                                                        |
    |                |     "requestCount":                                                          |
    |                | 922337203685477****,                                                         |
    |                |   },                                                                         |
    |                |  ...                                                                         |
    |                | }                                                                            |
    +----------------+------------------------------------------------------------------------------+

Ative visualização em tempo real para uma tarefa de teste de estresse

  • Descrição

    Use o comando bench visualize para ativar a visualização em tempo real de uma tarefa de teste de estresse. Este comando inicia um servidor web em 127.0.0.1 que exibe uma página de monitoramento em tempo real.

  • Sintaxe

    <eascmd64> bench visualize <benchmark_task_name>
  • Parâmetros

    benchmark_task_name: Nome da tarefa de teste de estresse.

  • Exemplo

    <eascmd64> bench visualize benchmark-xgb-test-b514

    O sistema retorna uma resposta semelhante à seguinte.

    [OK] Click the link http://127.0.0.1:18734/eas-benchmark/statsview to observe realtime visualization details, you can turn it off with CTRL+C.
    Turning off will not interrupt the benchmark test task, and you can reopen it by the visualize command:
    eascmd -c [config_file] bench visualize benchmark-xgb-test-b514

    Abra o link http://127.0.0.1:18734/eas-benchmark/statsview no navegador para visualizar os resultados em tempo real.

Parar uma tarefa de teste de estresse

  • Descrição

    Use o comando bench stop para parar uma tarefa de teste de estresse em execução.

  • Sintaxe

    <eascmd64> bench stop <benchmark_task_name>
  • Parâmetros

    benchmark_task_name: Nome da tarefa de teste de estresse.

  • Exemplo

    <eascmd64> bench stop benchmark-xgb-test-b514

    O sistema retorna uma resposta semelhante à seguinte.

    Are you sure to stop the benchmark task [benchmark-xgb-test-b514] in [cn-shanghai]? [Y/n]
    [OK] Task [benchmark-xgb-test-b514] is stopping
    [OK] [Agnet: 0/1]: Benchmark task is Running
    [OK] [Agnet: 0/1]: Benchmark task is Stopped
    [OK] Benchmark task is stopped

Obter um relatório de teste de estresse

  • Descrição

    Use o comando bench report para recuperar o relatório de uma tarefa de teste de estresse.

    Nota

    Um relatório é gerado e salvo no OSS após o status da tarefa mudar para Stopped.

  • Sintaxe

    <eascmd64>  bench report <benchmark_task_name>
  • Parâmetros

    benchmark_task_name: Nome da tarefa de teste de estresse.

  • Exemplo

    <eascmd64> bench report benchmark-xgb-test-b514

    O sistema retorna uma resposta semelhante à seguinte.

    [OK] Benchmark task benchmark-demo-test-c7eb report url: http://eas-benchmark.oss-cn-chengdu.aliyuncs.com/summary/benchmark-demo-test-c7eb-10004.html

    Abra a URL no navegador para visualizar o relatório do teste de estresse.

Iniciar uma tarefa de teste de estresse

  • Descrição

    Use o comando bench start para iniciar uma tarefa de teste de estresse parada.

  • Sintaxe

    <eascmd64> bench start <benchmark_task_name>
  • Parâmetros

    benchmark_task_name: Nome da tarefa de teste de estresse.

  • Exemplo

    <eascmd64> bench start benchmark-xgb-test-b514

    O sistema retorna uma resposta semelhante à seguinte.

    Are you sure to start the benchmark task [benchmark-xgb-test-b514] in [cn-shanghai]? [Y/n]
    [OK] Task [benchmark-xgb-test-b514] is starting
    [OK] [Agnet: 0/1]: Succeed to start benchmark master
    [OK] [Agnet: 1/1]: Benchmark task is Running
    [OK] Benchmark task is Running
    [OK] Click the link http://127.0.0.1:18947/eas-benchmark/statsview to observe realtime visualization details, you can turn it off with CTRL+C.
    Turning off will not interrupt the benchmark test task, and you can reopen it by the visualize command:
    eascmd -c [config_file] bench visualize benchmark-xgb-test-b514

Modifique dinamicamente o número de workers do agente e a concorrência

  • Descrição

    Quando o modo de teste de estresse for manual, use o comando bench update para modificar dinamicamente o número de workers do agente e o nível de concorrência.

  • Sintaxe

    <eascmd64> bench update <benchmark_task_name> -Doptional.concurrency=<attr_value> -Doptional.agentCount=<attr_value>
  • Parâmetros

    • benchmark_task_name: Nome da tarefa de teste de estresse.

    • <attr_value>: Valor específico a ser definido.

  • Exemplo

    <eascmd64> bench update benchmark-demo-b99c -Doptional.concurrency=2 -Doptional.agentCount=1

    O sistema retorna uma resposta semelhante à seguinte.

    [RequestId]: 9920C672-4D41-5CC4-8EC0-C690F76E****
    [OK] Running [TaskName: benchmark-demo-b99c, DesiredAgent:1, AvailableAgent: 1, Message: Benchmark task is Updating]
    [OK] Benchmark task benchmark-demo-b99c was updated successfully

Exclua uma tarefa de teste de estresse

  • Descrição

    Use o comando bench delete para excluir manualmente uma tarefa de teste de estresse. A exclusão de uma tarefa também remove seu relatório de teste correspondente do OSS.

  • Sintaxe

    <eascmd64> bench delete <benchmark_task_name>
  • Parâmetros

    benchmark_task_name: Nome da tarefa de teste de estresse.

  • Exemplo

    <eascmd64> bench delete benchmark-xgb-test-b514

    O sistema retorna uma resposta semelhante à seguinte.

    Are you sure to delete the benchmark task [benchmark-xgb-test-b514] in [cn-shanghai]? [Y/n]
    [OK] Benchmark task benchmark-xgb-test-b514 is Deleting
    [OK] Benchmark task was deleted successfully

Exclua ou reiniciar instâncias

  • Descrição

    Use o comando deleteworkers (ou seu alias dw) para excluir uma ou mais instâncias de um serviço. Após a exclusão, o sistema inicia automaticamente novas instâncias para substituí-las. Este comando efetivamente reinicia as instâncias especificadas.

  • Sintaxe

    <eascmd64> dw <service_name> <instance_names>
  • Parâmetros

    • <service_name>: Nome do serviço.

    • <instance_names>: Nomes das instâncias de serviço a serem excluídas, separados por vírgulas (,).

  • Exemplo

    <eascmd64> dw mnist_saved_model_example mnist-saved-model-example-69cf5dd6c7-5****

    O sistema retorna um prompt de confirmação.

    Are you sure to delete the instances [mnist-saved-model-example-69cf5dd6c7-5****] of service [mnist_saved_model_example] in [cn-shenzhen]? [Y/n]

    Após inserir Y, o sistema retorna uma resposta semelhante à seguinte.

    [RequestId]: 564C8F56-D97A-555E-9E0B-22BE140A****
    [OK] Instance(s) [mnist-saved-model-example-69cf5dd6c7-5****] for service [mnist_saved_model_example] in region [cn-shenzhen] was deleted successfully

Inicializar o ambiente do SDK Python

Nota

Este recurso é suportado apenas no Linux.

  • Descrição

    Use o comando pysdk init para inicializar o ambiente do SDK Python.

  • Sintaxe

    <eascmd64> pysdk init ./pysdk_demo
  • Parâmetros

    N/A

  • Exemplo

    1. Execute o comando de inicialização:

      <eascmd64> pysdk init ./pysdk_demo

      O sistema retorna um prompt.

      [PYSDK] Please choose your python version [enter for 3.6]:
    2. Insira 3.6. O sistema retorna uma resposta semelhante à seguinte:

      Collecting package metadata (current_repodata.json): done
      Solving environment: done
      ...
      [PYSDK] Installing python processor example app.py
      [PYSDK] Installing python service example app.json

Compactar ambiente e código completos

Nota

Este recurso é suportado apenas no Linux.

  • Descrição

    Use o comando pysdk pack para empacotar o ambiente completo.

  • Sintaxe

    <eascmd64> pysdk pack ./<demo>
  • Parâmetros

    <demo>: Diretório onde o ambiente ou código está localizado.

  • Exemplo

    Suponha que o diretório a ser empacotado seja demo.

    <eascmd64> pysdk pack ./demo

    O sistema retorna uma resposta semelhante à seguinte.

    [PYSDK] Creating package: /mnt/workspace/demo.tar.gz

Visualize grupos de recursos

  • Descrição

    Use o comando resource list (ou resource ls) para listar os grupos de recursos da conta atual.

  • Sintaxe

    <eascmd64> resource ls
  • Parâmetros

    N/A

  • Exemplo

    <eascmd64> resource ls

    O sistema retorna uma resposta semelhante à seguinte.

    +--------------------------+-------------+---------------+----------+----------+------------------+---------------------+---------------+
    |       RESOURCENAME       |  CLUSTERID  | INSTANCECOUNT | GPUCOUNT | CPUCOUNT |     OWNERUID     |     CREATETIME      |    STATUS     |
    +--------------------------+-------------+---------------+----------+----------+------------------+---------------------+---------------+
    | eas-r-lzo32vrdbtukr7te3i | cn-shanghai |             1 |        0 |       16 | 182848887922**** | 2020-03-18 13:09:24 | ResourceReady |
    +--------------------------+-------------+---------------+----------+----------+------------------+---------------------+---------------+

Visualize detalhes de um grupo de recursos

  • Descrição

    Use o comando resource desc para visualizar informações detalhadas sobre um grupo de recursos.

  • Sintaxe

    <eascmd64> resource desc <resource_id>
  • Parâmetros

    <resource_id>: ID do grupo de recursos a ser visualizado. Isso corresponde ao campo RESOURCENAME na saída do comando resource list(ls).

  • Exemplo

    Visualize os detalhes do grupo de recursos com o ID eas-r-lzo32vrdbtukr7te3i.

    <eascmd64> -c ~/.eas/shanghai2.conf resource desc eas-r-lzo32vrdbtukr7te3i

    O parâmetro -c ~/.eas/shanghai2.conf especifica um arquivo de configuração diferente do padrão ~/.eas/config. O sistema retorna uma resposta semelhante à seguinte.

    +---------+-----------------+----------------------------------------------------------+
    |   Basic | ResourceName    | eas-r-lzo32vrdbtukr7te3i                                 |
    |         | Region          | cn-shanghai                                              |
    |         | CpuCount        | 16                                                       |
    |         | GpuCount        | 0                                                        |
    |         | instanceCount   | 1                                                        |
    |         | CreateTime      | 2020-03-18 13:09:24                                      |
    |         | LastStatus      | ResourceReady                                            |
    |         | Message         | Resource is ready                                        |
    |         | RoleArn         | acs:ram::xxx:role/AliyunPAIAccessingENIRole              |
    | Network | VpcId           | vpc-uf6s9pv47nu03srne****                                |
    |         | VSwitchId       | vsw-uf6voq53e893k56ws****                                |
    |         | SecurityGroupId | sg-uf6c5twkfar8l06c****                                  |
    |         | DestinationCIDR |                                                          |
    |         | AuxVSwitchList  | []                                                       |
    +---------+-----------------+----------------------------------------------------------+

Visualize instâncias em um grupo de recursos

  • Descrição

    Use o comando resource list_instance (ou resource li) para listar as instâncias em um grupo de recursos e seu uso de recursos.

  • Sintaxe

    <eascmd64> resource list_instance <resource_id>
  • Parâmetros

    <resource_id>: ID do grupo de recursos a ser visualizado. Isso corresponde ao campo RESOURCENAME na saída do comando resource list (ls).

  • Exemplo

    <eascmd64> resource li eas-r-lzo32vrdbtukr7te3i

    O sistema retorna uma resposta semelhante à seguinte.

    +------------------------------------+--------------+--------+----------------+----------------+-------------------+---------------------+----------------+------------+
    |            INSTANCENAME            |  INSTANCEIP  | STATUS | TOTAL/USED CPU | TOTAL/USED GPU | TOTAL/USED MEMORY |     CREATETIME      |  INSTANCETYPE  | CHARGETYPE |
    +------------------------------------+--------------+--------+----------------+----------------+-------------------+---------------------+----------------+------------+
    | cn-shanghai.i-uf6dj71ir6mh3gjmaz3a | 10.224.XX.XX | Ready  | 16/6           | 0/0            | 62240M/4200M      | 2020-03-18 13:09:34 | ecs.g6.4xlarge | PostPaid   |
    +------------------------------------+--------------+--------+----------------+----------------+-------------------+---------------------+----------------+------------+

Ative conexão direta para um grupo de recursos

  • Descrição

    Use o comando resource network para conectar um grupo de recursos à sua VPC. Isso permite chamadas de conexão direta com um balanceador de carga via software dentro da sua VPC e possibilita que os Processors do EAS acessem recursos privados, como RDS e Redis.

  • Sintaxe

    <eascmd64> resource network <resource_id> -s <network_cfg.json>
  • Parâmetros

    • <resource_id>: ID do grupo de recursos a ser visualizado. Isso corresponde ao campo RESOURCENAME na saída do comando resource list (ls)

    • <network_cfg.json>: Arquivo de configuração de rede. O formato do arquivo é o seguinte.

      {
        "Action":"create",
        "VSwitchId": "vsw-8vbsunr5bkcbyxh94****",
        "SecurityGroupId": "sg-8vbhwowdxzx5fjcx****",
        "VSwitchIdList": ["vsw-8xbsunr5abcbyqh93****", "vsw-8xbs1y7gu6cxbvqzw****"],
        "DestinationCIDR": "192.XX.XX.XX/16"
      }

      A tabela a seguir descreve os parâmetros.

      Parâmetro

      Descrição

      Obrigatório

      Valor padrão

      Action

      Operação de configuração de rede. Valores válidos:

      • create: Ativa a configuração de VPC.

      • delete: Desativa a configuração de VPC. Nenhum outro parâmetro é necessário.

      Sim

      N/A

      VSwitchId

      ID do vSwitch alvo primário a ser integrado. O EAS cria automaticamente uma Elastic Network Interface (ENI) neste vSwitch. A exclusão desta ENI causa problemas de conectividade de rede.

      Sim

      N/A

      SecurityGroupId

      ID do grupo de segurança ao qual o ECS cliente pertence.

      Nota

      Para evitar problemas de conectividade de rede, o ECS cliente deve estar neste grupo de segurança.

      Sim

      N/A

      VSwitchIdList

      Lista de vSwitches secundários a serem integrados. Eles devem estar na mesma VPC que o vSwitch primário. Os intervalos de endereços IP desses vSwitches são adicionados automaticamente à tabela de rotas do EAS.

      Não

      Array vazio ([])

      DestinationCIDR

      Bloco CIDR alvo do cliente, que deve estar na mesma VPC que o vSwitch primário. Este bloco CIDR é adicionado automaticamente à tabela de rotas do EAS.

      Não

      String vazia ("")

      Nota

      VSwitchIdList e DestinationCIDR servem ao mesmo propósito: conectar o cluster EAS ao seu segmento de rede. Use VSwitchIdList para se conectar a vários vSwitches. Use o campo DestinationCIDR para se conectar a um segmento de rede grande, como uma VPC inteira. Não utilize os segmentos de rede 10.0.0.0/8, 10.224.0.0/16 ou 10.240.0.0/16. Caso contrário, ocorrerão conflitos de rede. Se tiver outros requisitos, entre em contato com seu gerente de negócios para obter assistência.

Referências