更新时间:2024-08-14 GMT+08:00
ModelArts CLI命令功能介绍
功能介绍
ModelArts CLI,即ModelArts命令行工具,是一个跨平台命令行工具,用于连接ModelArts服务并在ModelArts资源上执行管理命令。用户可以使用交互式命令行提示符或脚本通过终端执行命令。为了方便理解,下面将ModelArts CLI统称为ma-cli。ma-cli支持用户在ModelArts Notebook及线下虚拟机中与云端服务交互,使用ma-cli命令可以实现命令自动补全、鉴权、镜像构建、提交ModelArts训练作业、提交DLI Spark作业、OBS数据复制等。
使用场景
- ma-cli已经集成在ModelArts开发环境Notebook中,可以直接使用。
登录ModelArts控制台,在“开发环境 > Notebook”中创建Notebook实例,打开Terminal,使用ma-cli命令。
- ma-cli在本地Windows/Linux环境中需要安装后在本地Terminal中使用。安装步骤具体可参考(可选)本地安装ma-cli。
- ma-cli不支持在git-bash上使用。
- 推荐使用Linux Bash、ZSH、Fish,WSL或PowerShell等Terminal。在使用过程中,注意您的敏感信息数据保护,避免敏感信息泄露。
命令预览
$ ma-cli -h Usage: ma-cli [OPTIONS] COMMAND [ARGS]... Options: -V, -v, --version 1.2.1 -C, --config-file TEXT Configure file path for authorization. -D, --debug Debug Mode. Shows full stack trace when error occurs. -P, --profile TEXT CLI connection profile to use. The default profile is "DEFAULT". -h, -H, --help Show this message and exit. Commands: configure Configures authentication and endpoints info for the CLI. image Support get registered image list、register or unregister image、debug image, build image in Notebook. obs-copy Copy file or directory between OBS and local path. ma-job ModelArts job submission and query job details. dli-job DLI spark job submission and query job details. auto-completion Auto complete ma-cli command in terminal, support "bash(default)/zsh/fish".
其中,-C、-D、-P,-h参数属于全局可选参数。
- -C表示在执行此命令时可以手动指定鉴权配置文件,默认使用~/.modelarts/ma-cli-profile.yaml配置文件;
- -P表示鉴权文件中的某一组鉴权信息,默认是DEFAULT;
- -D表示是否开启debug模式(默认关闭),当开启debug模式后,命令的报错堆栈信息将会打印出来,否则只会打印报错信息;
- -h表示显示命令的帮助提示信息。
命令说明
命令 |
命令详情 |
---|---|
configure |
ma-cli鉴权命令,支持用户名密码、AK/SK |
image |
ModelArts镜像构建、镜像注册、查询已注册镜像信息等 |
obs-copy |
本地和OBS文件/文件夹间的相互复制 |
ma-job |
ModelArts训练作业管理,包含作业提交、资源查询等 |
dli-job |
DLI Spark任务提交及资源管理 |
auto-completion |
命令自动补全 |
父主题: ModelArts CLI命令参考