客戶端使用注意事項(xiàng)

如果運(yùn)行時(shí)有證書問題相關(guān)的報(bào)錯(cuò)，請(qǐng)運(yùn)行sudo apt-get update && sudo apt-get install ca-certificates。

下載客戶端工具

自動(dòng)補(bǔ)全（completion）

• 功能

  自動(dòng)補(bǔ)全功能和社區(qū)的Kubectl、Arena命令行的自動(dòng)補(bǔ)全功能使用方式相同。在命令行中，您可以通過連續(xù)按兩次Tab鍵使用DLC客戶端工具的自動(dòng)補(bǔ)全功能，從而對(duì)尚未完成的命令進(jìn)行提示。

• 格式

  ./dlc completion <shelltype>

• 參數(shù)

  <shelltype>表示待生成自動(dòng)補(bǔ)全腳本的命令行類型。系統(tǒng)支持的命令行種類包括bash、fish、powershell及zsh。

• 示例

  本文以bash類型為例，介紹自動(dòng)補(bǔ)全的使用方法：

  1. 如果沒有安裝bash-completion包，則使用如下命令安裝，并通過source命令使之生效。如果已經(jīng)安裝了bash-completion包，則跳過該步驟。

     # Mac系統(tǒng)中使用如下命令。
     brew install bash-completion && source /usr/local/etc/bash_completion
     # Linux系統(tǒng)中使用如下命令。
     yum install bash-completion && source /etc/profile.d/bash_completion.sh

  2. 執(zhí)行如下命令，使自動(dòng)補(bǔ)全命令生效。由于自動(dòng)補(bǔ)全功能依賴于bash-completion包，因此如果執(zhí)行過程中報(bào)錯(cuò)，則表明您的環(huán)境中未安裝bash-completion包。

     source <(./dlc completion bash)

  3. 在輸入如下./dlc后連續(xù)按下兩次Tab鍵，即可查看DLC客戶端工具提供的命令。

     ./dlc 

     系統(tǒng)返回的DLC客戶端工具提供的命令如下所示。

     completion  config      create      delete      get         help        logs        stop        submit

  說明

  針對(duì)其他Shell類型，您可以通過dlc completion <zsh | fish | powershell> --help命令獲取詳細(xì)的使用方法。

用戶認(rèn)證（config）

• 功能

  首次使用DLC客戶端工具管理數(shù)據(jù)和任務(wù)時(shí)，需要先使用阿里云賬號(hào)的AccessKey ID和AccessKey Secret進(jìn)行身份認(rèn)證。一次認(rèn)證后，再次使用時(shí)無需認(rèn)證。

• 格式

  ./dlc config --protocol https --access_id <yourAccessKeyID> --access_key <yourAccessKeySecret> [--endpoint <yourEndpoint>] [--region <yourRegion>]

• 參數(shù)

  需要替換的參數(shù)	是否必選	描述	類型
  <yourAccessKeyId>	是	阿里云賬號(hào)的AccessKey ID。	STRING
  <yourAccessKeySecret>	是	阿里云賬號(hào)的AccessKey Secret。	STRING
  <yourEndpoint>	是	使用的DLC服務(wù)所在地域的Endpoint，例如：pai-dlc.cn-shanghai.aliyuncs.com。	STRING
  <yourRegion>	是	使用的DLC服務(wù)所在地域，例如：華東2（上海）為cn-shanghai。	STRING

• 示例

  進(jìn)行用戶認(rèn)證后，系統(tǒng)默認(rèn)會(huì)將配置內(nèi)容保存至當(dāng)前目錄的.dlc/config文件中。例如，執(zhí)行以下類似用戶命令。

  ./dlc config --protocol https       \
             --access_id <AccessKeyId>       \
             --access_key <AccessKeySecret>  \
             --endpoint 'pai-dlc.cn-shanghai.aliyuncs.com' \
             --region cn-shanghai

  系統(tǒng)返回如下類似內(nèi)容。

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