El cliente permite gestionar trabajos en DLC. Esta herramienta ofrece funciones como autocompletado de línea de comandos, envío de trabajos de entrenamiento y gestión de trabajos. Antes de empezar, debe descargar el cliente y realizar la autenticación de identidad. Este tema describe cómo descargar el cliente y llevar a cabo la autenticación de identidad.
Notas sobre el uso del cliente
Si ocurre un error relacionado con certificados durante la ejecución, ejecute sudo apt-get update && sudo apt-get install ca-certificates.
Descargar el cliente
Descargue el cliente correspondiente a su sistema operativo desde los siguientes enlaces:
El cliente descargado no requiere instalación. Ejecute el comando chmod +x dlc para otorgar permisos de ejecución al archivo. Después podrá invocar los comandos del cliente desde la línea de comandos.
Autocompletado (completion)
-
Función
La función de autocompletado opera de la misma manera que las herramientas de línea de comandos comunitarias Kubectl y Arena. Presione la tecla Tab dos veces en la línea de comandos para utilizar el autocompletado del cliente DLC. Esta función proporciona sugerencias para comandos incompletos.
-
Formato
./dlc completion <shelltype> -
Parámetros
<shelltype> especifica el tipo de shell para el cual desea generar el script de autocompletado. Los tipos compatibles incluyen bash, fish, powershell y zsh.
-
Ejemplo
A continuación se muestra cómo usar el autocompletado en bash:
-
Si el paquete bash-completion no está instalado, ejecute el siguiente comando para instalarlo. Luego, ejecute el comando
sourcepara aplicar los cambios. Si el paquete ya está instalado, omita este paso.# For macOS, run the following command. brew install bash-completion && source /usr/local/etc/bash_completion # For Linux, run the following command. yum install bash-completion && source /etc/profile.d/bash_completion.sh -
Ejecute el siguiente comando para habilitar el autocompletado. Esta función depende del paquete bash-completion. Si ocurre un error, significa que dicho paquete no está instalado en su entorno.
source <(./dlc completion bash) -
Introduzca
./dlcy presione la tecla Tab dos veces para consultar los comandos disponibles en el cliente DLC../dlcEl sistema devuelve los siguientes comandos proporcionados por el cliente DLC.
completion config create delete get help logs stop submit
NotaPara otros tipos de shell, ejecute el comando
dlc completion <zsh | fish | powershell> --helppara obtener instrucciones detalladas de uso. -
Autenticación de usuario (config)
-
Función
La primera vez que utilice el cliente DLC para gestionar datos y trabajos, deberá realizar la autenticación de identidad mediante el AccessKey ID y el AccessKey secret de su cuenta de Alibaba Cloud. Después de la autenticación inicial, no será necesario autenticarse nuevamente.
-
Formato
./dlc config --protocol https --access_id <yourAccessKeyID> --access_key <yourAccessKeySecret> [--endpoint <yourEndpoint>] [--region <yourRegion>] -
Parámetros
Parámetros a reemplazar
Obligatorio
Descripción
Tipo
<yourAccessKeyId>
Sí
El AccessKey ID de su cuenta de Alibaba Cloud.
STRING
<yourAccessKeySecret>
Sí
El AccessKey secret de su cuenta de Alibaba Cloud.
STRING
<yourEndpoint>
Sí
El endpoint de la región donde se encuentra el servicio DLC. Ejemplo: pai-dlc.cn-shanghai.aliyuncs.com.
STRING
<yourRegion>
Sí
La región donde se encuentra el servicio DLC. Por ejemplo, el ID de región para China (Shanghai) es cn-shanghai.
STRING
-
Ejemplo
Una vez realizada la autenticación de identidad, la configuración se guarda de forma predeterminada en el archivo .dlc/config del directorio actual. Por ejemplo, puede ejecutar un comando similar al siguiente:
./dlc config --protocol https \ --access_id <AccessKeyId> \ --access_key <AccessKeySecret> \ --endpoint 'pai-dlc.cn-shanghai.aliyuncs.com' \ --region cn-shanghaiSe devuelve un mensaje similar al siguiente:
[OK] Configuration saved to: ~/.dlc/config
Referencias
Después de autenticar el cliente, podrá realizar operaciones mediante los comandos compatibles. Para más información, consulte Command list.
También puede enviar trabajos de DLC desde la consola. Para más información, consulte Create tasks in the console.