您可以通過客戶端工具管理DLC中的任務,包括實現命令行自動補全、提交訓練任務和管理任務等功能。在開始使用之前,您需要下載客戶端工具并完成用戶認證。本文介紹下載客戶端以及進行用戶認證的命令詳情。
客戶端使用注意事項
如果運行時有證書問題相關的報錯,請運行sudo apt-get update && sudo apt-get install ca-certificates
。
下載客戶端工具
您可以通過以下鏈接下載適合的客戶端工具:
下載后的客戶端工具無需安裝,您只需要執行chmod +x dlc
命令,為其添加可執行權限,即可在命令行中調用客戶端工具提供的命令。
自動補全(completion)
功能
自動補全功能和社區的Kubectl、Arena命令行的自動補全功能使用方式相同。在命令行中,您可以通過連續按兩次Tab鍵使用DLC客戶端工具的自動補全功能,從而對尚未完成的命令進行提示。
格式
./dlc completion <shelltype>
參數
<shelltype>表示待生成自動補全腳本的命令行類型。系統支持的命令行種類包括bash、fish、powershell及zsh。
示例
本文以bash類型為例,介紹自動補全的使用方法:
如果沒有安裝bash-completion包,則使用如下命令安裝,并通過
source
命令使之生效。如果已經安裝了bash-completion包,則跳過該步驟。# Mac系統中使用如下命令。 brew install bash-completion && source /usr/local/etc/bash_completion # Linux系統中使用如下命令。 yum install bash-completion && source /etc/profile.d/bash_completion.sh
執行如下命令,使自動補全命令生效。由于自動補全功能依賴于bash-completion包,因此如果執行過程中報錯,則表明您的環境中未安裝bash-completion包。
source <(./dlc completion bash)
在輸入如下
./dlc
后連續按下兩次Tab鍵,即可查看DLC客戶端工具提供的命令。./dlc
系統返回的DLC客戶端工具提供的命令如下所示。
completion config create delete get help logs stop submit
說明針對其他Shell類型,您可以通過
dlc completion <zsh | fish | powershell> --help
命令獲取詳細的使用方法。
用戶認證(config)
功能
首次使用DLC客戶端工具管理數據和任務時,需要先使用阿里云賬號的AccessKey ID和AccessKey Secret進行身份認證。一次認證后,再次使用時無需認證。
格式
./dlc config --protocol https --access_id <yourAccessKeyID> --access_key <yourAccessKeySecret> [--endpoint <yourEndpoint>] [--region <yourRegion>]
參數
需要替換的參數
是否必選
描述
類型
<yourAccessKeyId>
是
阿里云賬號的AccessKey ID。
STRING
<yourAccessKeySecret>
是
阿里云賬號的AccessKey Secret。
STRING
<yourEndpoint>
是
使用的DLC服務所在地域的Endpoint,例如:pai-dlc.cn-shanghai.aliyuncs.com。
STRING
<yourRegion>
是
使用的DLC服務所在地域,例如:華東2(上海)為cn-shanghai。
STRING
示例
進行用戶認證后,系統默認會將配置內容保存至當前目錄的.dlc/config文件中。例如,執行以下類似用戶命令。
./dlc config --protocol https \ --access_id <AccessKeyId> \ --access_key <AccessKeySecret> \ --endpoint 'pai-dlc.cn-shanghai.aliyuncs.com' \ --region cn-shanghai
系統返回如下類似內容。
[OK] Configuration saved to: ~/.dlc/config