Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Atualizado em 2024-09-14 GMT+08:00

Visão geral da CLI do ModelArts

Descrição

A CLI do ModelArts, também chamado de ma-cli, é uma ferramenta de linha de comando de multiplataforma usada para se conectar ao ModelArts e executar comandos de gerenciamento em recursos do ModelArts. Você pode usar o prompt de comando interativo ou script para executar comandos em um terminal. A ma-cli permite que você interaja com serviços de nuvem por meio do notebook do ModelArts e de VMs locais. Você pode executar comandos de ma-cli para autocompletar e autenticação, além de criar imagens, enviar trabalhos de treinamento do ModelArts e do Spark de DLI e copiar dados do OBS.

Cenários de aplicações

  • ma-cli foi integrada ao notebook do ModelArts e pode ser usada diretamente.

    Faça logon no console do ModelArts, escolha DevEnviron > Notebook, crie uma instância de notebook, inicie um terminal e execute comandos de ma-cli.

  • No Windows ou Linux local, instale a ma-cli e use-a em um terminal local. Para mais detalhes, consulte (Opcional) Instalação local de ma-cli.
    • ma-cli não pode ser usada no Git Bash.
    • Terminais como Linux Bash, Zsh, Fish, WSL e PowerShell são recomendados. Para garantir a segurança de suas informações confidenciais, é importante evitar qualquer possível vazamento ao usar os terminais.

Pré-visualização de comandos

$ ma-cli -h
Usage: ma-cli [OPTIONS] COMMAND [ARGS]...

Options:
  -V, -v, --version       1.2.1
  -C, --config-file TEXT  Configure a file path for authorization.
  -D, --debug             Debugging mode, in which the full stack trace will be displayed when an error occurs.
  -P, --profile TEXT      CLI connection profile to be used. The default profile is DEFAULT.
  -h, -H, --help          Show the help information and exit.

Commands:
  configure        Configure authentication and endpoints for the CLI.
  image            Obtain registered images, register or unregister images, debug images, and create images in Notebook.
  obs-copy         Copy files or directories between OBS and a local path.
  ma-job           Submit ModelArts jobs and obtain jod details.
  dli-job          Submit DLI spark jobs and obtain jod details.
  auto-completion  Auto complete ma-cli command in terminal, support "bash(default)/zsh/fish".

Entre os parâmetros anteriores, os parâmetros -C, -D, -P e -h são globalmente opcionais.

  • -C indica que você pode especificar manualmente o arquivo de configuração de autenticação ao executar este comando. Por padrão, o arquivo de configuração ~/.modelarts/ma-cli-profile.yaml é usado.
  • -P indica um grupo de informações de autenticação no arquivo de autenticação. O valor padrão é default.
  • -D indica se deve ativar o modo de depuração (desativado por padrão). Depois que o modo de depuração estiver desativado, as informações de pilha de erros do comando serão impressas. Se esse modo estiver desativado, somente as informações de erro serão impressas.
  • -h indica que as informações de ajuda sobre o comando serão exibidas.

Comandos

Tabela 1 Comandos de ma-cli

Comando

Descrição

configure

Autenticação de ma-cli usando um nome de usuário e senha ou uma AK/SK

image

Criação de imagens do ModelArts, registro e consulta de imagens registradas

obs-copy

Copiar arquivos ou pastas entre um caminho local e o OBS

ma-job

Gerenciamento de trabalhos de treinamento do ModelArts, incluindo envio de trabalhos e consulta de recursos

dli-job

Envio de trabalhos e gestão de recursos do Spark de DLI

auto-completion

Commando de autocompletar