您可以通过客户端工具管理PAI-DLC中的数据和任务。在使用客户端工具之前,您需要下载客户端并进行用户认证。本文介绍下载客户端及进行用户认证的命令详情。

背景信息

手册使用客户端工具管理数据和任务之前,您需要按照如下流程完成准备工作:
  1. 下载客户端工具
  2. 执行自动补全命令,查看客户端工具提供的命令集,详情请参见自动补全(completion)
  3. 用户认证(config)

下载客户端工具

您可以通过以下链接下载适合的客户端工具: 下载后的客户端工具无需安装,您只需要执行chmod +x dlc命令,为其添加可执行权限,即可在命令行中调用客户端工具提供的命令。

自动补全(completion)

  • 功能

    自动补全功能和社区的Kubectl、Arena命令行的自动补全功能使用方式相同。在命令行中,您可以通过连续按两次Tab键使用PAI-DLC客户端工具的自动补全功能,从而对尚未完成的命令进行提示。

  • 格式
    dlc completion <shelltype>
  • 参数

    <shelltype>表示待生成自动补全脚本的命令行类型。系统支持的命令行种类包括bashfishpowershellzsh

  • 示例
    本文以bash类型为例,介绍自动补全的使用方法:
    1. 执行如下命令,使自动补全命令生效。由于自动补全功能依赖于bash-completion包,因此如果执行过程中报错,则表明您的环境中未安装bash-completion包。
      source<(dlc completion bash)
    2. 如果没有安装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
    3. 在如下dlc后连续按下两次Tab键,即可查看PAI-DLC客户端工具提供的命令。
      dlc
      系统返回的PAI-DLC客户端工具提供的命令如下所示。
      completion  config      create      delete      get         help        logs        stop        submit
    说明 针对其他Shell类型,您可以通过dlc completion <zsh | fish | powershell> --help命令获取详细的使用方法。

用户认证(config)

  • 功能

    首次使用PAI-DLC客户端工具管理数据和任务时,需要先使用阿里云账号的AccessKey ID和AccessKey Secret进行身份认证。一次认证后,再次使用时无需认证。

  • 格式
    dlc config --access_id <yourAccessKeyId> --access_key <yourAccessKeySecret> [--endpoint <yourEndpoint>] [--region <yourRegion>]
  • 参数
    需要替换的参数 是否必选 描述 类型
    <yourAccessKeyId> 阿里云账号的AccessKey ID。 STRNG
    <yourAccessKeySecret> 阿里云账号的AccessKey Secret。 STRNG
    <yourEndpoint> 使用的PAI-DLC服务所在地域的Endpoint,默认为pai-dlc.cn-shanghai.aliyuncs.com STRNG
    <yourRegion> 使用的PAI-DLC服务所在地域,默认为cn-shanghai STRNG
  • 示例
    进行用户认证后,系统默认会将配置内容保存至家目录的.dlc/config文件中。例如,执行以下类似用户命令。
    dlc config -access_id <yourAccessKeyId> -access_key <yourAccessKeySecret>
    系统返回如下类似内容。
    Configuration saved to: ~/.dlc/config