人工智能平台 PAI：准备工作

客户端使用注意事项

如果运行时有证书问题相关的报错，请运行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 --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