全部產品
Search
文件中心

Platform For AI:命令使用說明

更新時間:Jul 13, 2024

通過eascmd,您可以方便地管理您的EAS服務,包括建立服務、更新服務、查看服務詳情以及管理壓測任務等。本文為您提供了每個命令的使用說明和相關樣本,協助您更好地使用eascmd的功能。

操作命令合集

使用eascmd命令列工具管理服務,相關的操作命令如下。

說明

使用eascmd用戶端執行命令時,具體使用的用戶端名稱以實際為準。

類型

功能

操作入口

服務相關

支援以下兩種方式使用eascmd命令列工具:

  • 自行下載eascmd用戶端,詳細請參見下載並認證用戶端

  • DSW的Terminal中,DSW已經內建了eascmd命令列工具。

資源群組相關

建立服務

  • 功能

    通過create命令建立服務。建立服務時,需要提供資源(模型或Processor)的HTTP或OSS地址,您可以將資源上傳至OSS,並擷取上傳後的OSS地址。

  • 命令

    <eascmd64> create <service_desc_json>
  • 參數

    service_desc_json表示描述服務相關資訊(模型儲存位置及資源規格等)的JSON檔案,該檔案的樣本如下。

    {
      "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
      }
    }

    服務相關資訊JSON檔案內的參數說明,詳情請參見服務模型所有相關參數說明

  • 樣本(假設描述服務相關資訊的JSON檔案為pmml.json

    <eascmd64> create pmml.json

    系統輸出如下類似結果。

    [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

修改配置

  • 功能

    對於Instance和CPU等metadata資訊,可以直接使用modify命令的-D參數進行修改。

  • 命令

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

    支援同時配置多個參數,詳情請參見樣本。

  • 參數

    • <service_name>:服務名稱。

    • <attr_name>:參數名稱。

    • <attr_value>:參數取值。

  • 樣本

    將Instance數量配置為10,且每個Instance中的Quota數量為5(5核+20 GB)。

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

    擴縮容時,可以只修改服務的metadata.instance參數。如果指定的Instance數量大於服務當前的Instance數量,則系統啟動新的Instance,以達到要求的Instance數量,原有執行個體的運行不受影響。如果指定的Instance數量小於當前Instance數量,則系統停止部分Instance,以達到要求的Instance數量,其他執行個體的運行不受影響。

    說明

    只修改Instance的更新操作與全量更新不同,前者不會觸發服務的變換。

修改服務配置

  • 功能

    通過modify命令可以對已部署的服務進行配置修改。

  • 命令

    <eascmd64> modify <service_name> -s <service_desc_json>
  • 參數

    • <service_name>:服務名稱。

    • <service_desc_json>:服務描述檔案。

      說明

      在服務描述檔案中,僅寫需要修改的參數即可,其他不必要參數不寫。如果寫了模型檔案資訊及processor資訊,則會被認定為增加一個新的服務版本。

增加服務版本

  • 功能

    通過modify命令可以對已部署的服務增加服務版本。

  • 命令

    <eascmd64> modify <service_name> -s <service_desc_json>
  • 參數

    • <service_name>:服務名稱。

    • <service_desc_json>:服務描述檔案。

      說明

      需要在服務描述檔案中指定模型檔案資訊及processor資訊。

停止服務

  • 功能

    通過stop命令可以停止一個運行中的服務。

  • 命令

    <eascmd64> stop <service_name>
  • 參數

    <service_name>表示待停止的服務名稱。

啟動服務

  • 功能

    通過start命令可以重新啟動一個已停止的服務。

  • 命令

    <eascmd64> start <service_name>
  • 參數

    <service_name>表示待啟動的服務名稱。

刪除服務

  • 功能

    通過delete命令可以刪除服務,但是只能刪除當前地區的服務。

  • 命令

    <eascmd64> delete <service_name>
  • 參數

    <service_name>表示待刪除的服務名稱。

  • 樣本

    假設服務名稱為savedmodel_example,刪除該服務的步驟如下:

    1. 執行刪除服務的命令。

      <eascmd64> delete savedmodel_example

      系統輸出如下類似結果。

      Are you sure to delete the service [savedmodel_example] in [cn-shanghai]? [Y/n]
    2. 輸入Y。系統輸出如下類似結果。

      [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

藍綠髮布

  • 功能

    通過create -r命令可以對一個已存在的服務建立一個關聯服務,再使用release命令根據需求隨時切換流量比例,從而進行藍綠髮布。新服務的資訊描述JSON檔案中的name必須與舊服務同名,其他欄位根據需求自由配置。系統會自動在舊服務名基礎上增加隨機尾碼,從而得到新服務名。

    如果刪除新服務,則流量會全部切換至舊服務。如果刪除舊服務,則全部流量切換至新服務。藍綠髮布之前,最原始服務的Endpoint會成為後續發布迭代的流量入口,無論後續在這個基礎上進行多少次藍綠髮布迭代,該入口的Endpoint始終保持不變(例如下面樣本中的{domain}/api/predict/savedmodel_example),您無須修改用戶端調用代碼。

    說明

    藍綠髮布不適用於網路直連訪問的方式。

  • 命令

    1. 建立關聯服務

      <eascmd64> create <service_desc_json> -r
    2. 對藍綠服務進行切流。

      <eascmd64> release <service_name> -w <weight>
  • 參數

    • <service_desc_json>:服務資訊描述的JSON檔案。

    • <service_name>:建立的新服務名稱。

    • <weight>:新服務承載的流量百分比。

  • 樣本(假設服務資訊描述檔案為pmml.json

    1. 建立關聯服務

      <eascmd64> create pmml.json -r

      系統輸出以下類似資訊。

      [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

      上述輸出表示建立了一個名為savedmodel_example_9c16a222的服務,且兩個服務分別有獨立的流量入口,可以被單獨調用。您對新服務可以進行獨立測試,不會影響已有服務的線上運行,測試完成後,可以對服務進行切流操作。

    2. 對藍綠服務進行流量切換。

      <eascmd64> release savedmodel_example_9c16a222 -w 20

      上述命令表示切換20%的流量到新服務savedmodel_example_9c16a222,其餘80%的流量在舊服務savedmodel_example上。此時,新服務的獨立訪問Endpoint({domain}/api/predict/savedmodel_example_9c16a222)關閉,舊服務Endpoint({domain}/api/predict/savedmodel_example)流量的20%會進入新服務,80%進入舊服務。

      系統輸出如下類似結果。

      Confirmed to release this service at weight [20%]? [Y/n]
    3. 輸入Y,並單擊Enter鍵,系統輸出如下類似結果。

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

切換版本

  • 功能

    您可以先通過desc命令查看服務的最新版本和目前的版本,再通過version命令切換服務至最新版本之前的任意版本。

  • 命令

    <eascmd64> version <service_name> <version_id>
  • 參數

    • <service_name>:服務名稱。

    • <version_id>:待切換服務的版本ID。

查看服務列表

  • 功能

    使用list(或縮寫ls)命令可以查看目前使用者已部署的服務列表。

  • 命令

    <eascmd64> ls
  • 參數

  • 樣本

    <eascmd64> ls

    系統輸出如下類似結果。

    [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 |
    +---------------------------+-------------+----------+---------------------+---------------------+---------+--------+----------------------------------------+

查看服務資訊

  • 功能

    通過desc命令可以查看已部署服務的詳情資訊。

  • 命令

    <eascmd64> desc <service_name>
  • 參數

    <service_name>表示服務名稱。

  • 樣本

    <eascmd64> desc mnist_saved_model_example

    系統輸出如下類似結果。

    +---------------------+--------------------------------------------------------------------------------------------------------------+
    |              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"                                                                                             |
    |                     | }                                                                                                            |
    +---------------------+--------------------------------------------------------------------------------------------------------------+

查看服務進程

  • 功能

    通過showworkers(w)(或縮寫w)命令可以查看服務正在啟動並執行進程狀態。

  • 命令

    <eascmd64> w <service_name>
  • 參數

    <service_name>表示服務名稱。

  • 樣本

    <eascmd64> w mnist_saved_model_example

    系統輸出如下類似結果。

    [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"} |
    +-------------------------------+-------------+--------------+---------------------+----------+---------+-------+--------+----------------------------------------------------------------------------------------------------------+

    返回結果中的參數解釋如下表所示。

    參數

    描述

    INSTANCENAME

    服務執行個體的名稱。

    INNERIP

    執行個體的內網IP。

    HOSTIP

    執行個體所在的節點IP。

    STARTAT

    執行個體的啟動時間。

    RESTARTS

    執行個體的重啟次數。執行個體每次發生OOM或代碼Crash均會自動重啟,RESTARTS取值會加1。

    STATUS

    執行個體的目前狀態。其中Pending時表示在等待資源調度,長時間處於Pending狀態表示資源不足,執行個體無法調度。

    READY

    執行個體中的容器狀態,格式為[當前就緒的容器數/當前執行個體中所有的容器數]

    當READY為[0/1]時,表示容器正在啟動或容器異常健全狀態檢查不通過,此時流量不會進入該執行個體中。

    當一個服務中的所有執行個體Ready均為[0/1]時,表示整個服務不可用,請求服務時會返回5xx

    REASON

    執行個體狀態的簡單描述。

    LASTSTATE

    執行個體上次重啟的狀態。LASTSTATEreason為OOMKIlled時,表示執行個體發生了OOM。

建立壓測任務

  • 功能

    通過bench create命令對已部署的服務建立壓測任務。

  • 命令

    <eascmd64> bench create <bench_desc_json>
  • 參數

    bench_desc_json表示壓測任務相關資訊的JSON檔案,該檔案的樣本如下。

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

    您可以通過path指定多個OSS檔案作為壓測資料,配置樣本如下。如需大量設定多條壓測資料,可以直接將多個請求資料打包成zip包,通過oss://XX.zippath進行配置。

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

    JSON檔案的相關參數說明,詳情請參見建立壓測任務

  • 樣本(假設描述壓測任務相關資訊的JSON檔案為bench.json)

    <eascmd64> bench create bench.json

    系統輸出如下類似結果。

    [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

管理壓測任務

查看壓測工作清單

  • 功能

    通過bench list(或縮寫bench ls)命令查看目前使用者建立的壓測工作清單。

  • 命令

    <eascmd64> bench ls
  • 參數

  • 樣本

    <eascmd64> bench ls

    系統輸出如下類似結果。

    [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 |
    +-------------------------+--------------------------+-------------+----------------+---------+---------------------+

查看壓測任務詳情

  • 功能

    通過bench desc命令查看指定壓測任務的詳細資料。

  • 命令

    <eascmd64> bench desc <benchmark_task_name>
  • 參數

    benchmark_task_name表示壓測任務名稱。

  • 樣本

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

    系統輸出如下類似結果。

    +----------------+------------------------------------------------------------------------------+
    |     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****,                                                         |
    |                |   },                                                                         |
    |                |  ...                                                                         |
    |                | }                                                                            |
    +----------------+------------------------------------------------------------------------------+

啟動壓測任務即時可視化

  • 功能

    通過bench visualize命令啟動壓測任務的即時可視化功能。該命令執行完成後會在本地127.0.0.1啟動一個由webserver提供的即時監控頁面的展示。

  • 命令

    <eascmd64> bench visualize <benchmark_task_name>
  • 參數

    benchmark_task_name表示壓測任務名稱。

  • 樣本

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

    系統輸出如下類似結果。

    [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

    使用瀏覽器開啟連結http://127.0.0.1:18734/eas-benchmark/statsview,即可查看即時資料結果。

停止壓測任務

  • 功能

    通過bench stop命令停止當前正在啟動並執行壓測任務。

  • 命令

    <eascmd64> bench stop <benchmark_task_name>
  • 參數

    benchmark_task_name表示壓測任務名稱。

  • 樣本

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

    系統輸出如下類似結果。

    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

擷取壓測任務報告

  • 功能

    通過bench report命令擷取壓測任務報告。

    說明

    當壓測任務狀態為Stopped狀態時,表示壓測任務結束,壓測報告會儲存到OSS中。

  • 命令

    <eascmd64>  bench report <benchmark_task_name>
  • 參數

    benchmark_task_name表示壓測任務名稱。

  • 樣本

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

    系統輸出如下類似結果。

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

    使用瀏覽器開啟url後的連結,即可查看壓測報告結果。

啟動壓測任務

  • 功能

    通過bench start命令啟動處於停止狀態的壓測任務。

  • 命令

    <eascmd64> bench start <benchmark_task_name>
  • 參數

    benchmark_task_name表示壓測任務名稱。

  • 樣本

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

    系統輸出如下類似結果。

    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

動態修改用戶端執行個體數量和並發數

  • 功能

    當壓測模式為manual時,通過bench update命令動態修改用戶端執行個體數量和並發數。

  • 命令

    <eascmd64> bench update <benchmark_task_name> -Doptional.concurrency=<attr_value> -Doptional.agentCount=<attr_value>
  • 參數

    • benchmark_task_name表示壓測任務名稱。

    • <attr_value>為具體取值。

  • 樣本

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

    系統輸出如下類似結果。

    [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

刪除壓測任務

  • 功能

    通過bench delete命令手動刪除壓測任務。刪除壓測任務後,該壓測任務儲存在OSS的壓測報告同步刪除。

  • 命令

    <eascmd64> bench delete <benchmark_task_name>
  • 參數

    benchmark_task_name表示壓測任務名稱。

  • 樣本

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

    系統輸出如下類似結果。

    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

刪除服務執行個體(重啟執行個體)

  • 功能

    通過deleteworkers(或縮寫dw)命令可以刪除服務的一個或多個執行個體。由於刪除執行個體後,系統會自動啟動新執行個體進行替換,因此該命令也可以作為執行個體重啟操作使用。

  • 命令

    <eascmd64> dw <service_name> <instance_names>
  • 參數

    • <service_name>:表示服務名稱。

    • <instance_names>:表示待刪除的服務執行個體名稱,多個執行個體中間使用半形逗號(,)分隔。

  • 樣本

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

    系統輸出如下類似結果。

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

    輸入Y後,系統輸出如下類似結果。

    [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

Python SDK環境初始化

說明

僅Linux系統支援。

  • 功能

    通過pysdk init命令初始化Python SDK環境。

  • 命令

    <eascmd64> pysdk init ./pysdk_demo
  • 參數

  • 樣本

    1. 輸入以下初始化命令。

      <eascmd64> pysdk init ./pysdk_demo

      系統輸出如下類似結果。

      [PYSDK] Please choose your python version [enter for 3.6]:
    2. 輸入3.6,系統輸出如下類似結果。

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

打包完整環境及代碼

說明

僅Linux系統支援。

  • 功能

    通過pysdk pack命令打包完整環境。

  • 命令

    <eascmd64> pysdk pack ./<demo>
  • 參數

    <demo>:環境或代碼所在目錄。

  • 樣本(假設需要打包的環境或代碼所在目錄為demo)

    <eascmd64> pysdk pack ./demo

    系統輸出如下類似結果。

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

查看資源群組列表

  • 功能

    通過resource list(或縮寫resource ls)命令可以查看當前賬戶下的資源群組列表。

  • 命令

    <eascmd64> resource ls
  • 參數

  • 樣本

    <eascmd64> resource ls

    系統輸出如下類似結果。

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

查看資源群組詳情

  • 功能

    通過resource desc命令可以查看某個資源群組的詳細資料。

  • 命令

    <eascmd64> resource desc <resource_id>
  • 參數

    <resource_id>表示待查看的資源群組ID,即resource list(ls)命令返回結果中的RESOURCENAME欄位。

  • 樣本

    查看資源群組ID為eas-r-lzo32vrdbtukr7te3i的資源群組詳情。

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

    其中-c ~/.eas/shanghai2.conf表示使用其他設定檔,而不是使用預設的設定檔~/.eas/config。系統輸出如下類似結果。

    +---------+-----------------+----------------------------------------------------------+
    |   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  | []                                                       |
    +---------+-----------------+----------------------------------------------------------+

查看資源群組執行個體列表

  • 功能

    通過resource list_instance(或縮寫為resource li)命令可以查看某個資源群組的執行個體列表及每個執行個體的資源使用方式。

  • 命令

    <eascmd64> resource list_instance <resource_id>
  • 參數

    <resource_id>表示待查看的資源群組ID,即resource list(ls)命令返回結果中的RESOURCENAME欄位。

  • 樣本

    <eascmd64> resource li eas-r-lzo32vrdbtukr7te3i

    系統輸出如下類似結果。

    +------------------------------------+--------------+--------+----------------+----------------+-------------------+---------------------+----------------+------------+
    |            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   |
    +------------------------------------+--------------+--------+----------------+----------------+-------------------+---------------------+----------------+------------+

配置資源群組網路

  • 功能

    通過resource network命令可以設定某個資源群組的直連情況,用於連通EAS VPC和使用者VPC之間的網路。一方面可以在使用者VPC內以直連軟負載的方式調用EAS服務,另一方面可以在EAS Processor中反向訪問使用者VPC中的內網資源(例如RDS、Redis等)。

  • 命令

    <eascmd64> resource network <resource_id> -s <network_cfg.json>
  • 參數

    • <resource_id>:表示查看的資源群組ID,即resource list(ls)命令返回結果中的RESOURCENAME欄位。

    • <network_cfg.json>:網路設定檔,該檔案格式如下所示。

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

      各參數的含義如下表所示。

      參數

      描述

      是否必選

      預設值

      Action

      網路設定的操作,取值範圍如下:

      • create:開通直連。

      • delete:關閉直連,此時無需配置其他參數。

      VSwitchId

      待連通的目標主vSwitch ID,EAS會自動在該vSwitch中建立ENI彈性網卡,請不要主動刪除該ENI,否則會導致網路連通性問題。

      SecurityGroupId

      用戶端ECS所在的安全性群組ID。

      說明

      用戶端ECS必須歸屬於該安全性群組中,否則會導致網路連通性問題。

      VSwitchIdList

      待打通的附屬vSwitch列表,必須與主vSwitch在同一個VPC中,這些vSwitch的IP網段會自動被加入到EAS的路由表規則中。

      空數組([])

      DestinationCIDR

      待打通的用戶端目標網段,必須與主vSwitch在同一個VPC中,該網段會被自動加入到EAS的路由表規則中。

      Null 字元串("")

      說明

      VSwitchIdListDestinationCIDR原理相同,均是為了連通EAS叢集與使用者某個網段的網路。如果需要連通多個指定vSwitch,則使用VSwitchIdList。如果需要連通一個大網段(例如整個VPC),則使用DestinationCIDR欄位。建議不要使用10.0.0.0/810.224.0.0/1610.240.0.0/16網段,否則會導致網路衝突問題。如果有其他需求,請聯絡您的商務經理來處理。

相關文檔