全部產品
Search
文件中心

Platform For AI:準備工作

更新時間:Oct 15, 2024

您可以通過用戶端工具管理DLC中的任務,包括實現命令列自動補全、提交訓練任務和管理工作等功能。在開始使用之前,您需要下載用戶端工具並完成使用者認證。本文介紹下載用戶端以及進行使用者認證的命令詳情。

用戶端使用注意事項

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

下載用戶端工具

您可以通過以下連結下載適合的用戶端工具:

下載後的用戶端工具無需安裝,您只需要執行chmod +x dlc命令,為其添加可執行許可權,即可在命令列中調用用戶端工具提供的命令。

自動補全(completion)

  • 功能

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

  • 格式

    ./dlc completion <shelltype>
  • 參數

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

  • 樣本

    本文以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 --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

相關文檔

  • 在完成用戶端工具認證後,您可以參考支援的命令列表來執行相關操作。具體操作,請參見命令列表

  • 您也可以通過控制台提交DLC任務。具體操作,請參見通過控制台建立