文档

准备工作

更新时间:

您可以通过客户端工具管理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 --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

相关文档

  • 在完成客户端工具认证后,您可以参考支持的命令列表来执行相关操作。具体操作,请参见命令列表

  • 您也可以通过控制台提交DLC任务。具体操作,请参见通过控制台创建