Platform For AI：準備工作

用戶端使用注意事項

如果運行時有認證問題相關的報錯，請運行sudo apt-get update && sudo apt-get install ca-certificates。

下載用戶端工具

自動補全（completion）

• 功能

  自動補全功能和社區的Kubectl、Arena命令列的自動補全功能使用方式相同。在命令列中，您可以通過連續按兩次Tab鍵使用DLC用戶端工具的自動補全功能，從而對尚未完成的命令進行提示。

• 格式

  ./dlc completion <shelltype>

• 參數

  <shelltype>表示待產生自動補全指令碼的命令列類型。系統支援的命令列種類包括bash、fish、powershell及zsh。

• 樣本

  本文以bash類型為例，介紹自動補全的使用方法：

  1. 如果沒有安裝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

  2. 執行如下命令，使自動補全命令生效。由於自動補全功能依賴於bash-completion包，因此如果執行過程中報錯，則表明您的環境中未安裝bash-completion包。

     source <(./dlc completion bash)

  3. 在輸入如下./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 --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 --access_id <AccessKeyId>       \
             --access_key <AccessKeySecret>  \
             --endpoint 'pai-dlc.cn-shanghai.aliyuncs.com' \
             --region cn-shanghai

  系統返回如下類似內容。

  [OK] Configuration saved to: ~/.dlc/config