Préparatifs pour l'utilisation de l'outil de ligne de commande DLC - Platform For AI

Le client vous permet de gérer les jobs dans DLC. Il offre des fonctionnalités telles que la saisie semi-automatique des commandes, la soumission de jobs d'entraînement et la gestion des jobs. Avant de commencer, téléchargez le client et authentifiez-vous. Cette rubrique explique comment télécharger le client et procéder à l'authentification.

Remarques sur l'utilisation du client

Si une erreur liée aux certificats survient lors de l'exécution, exécutez la commande sudo apt-get update && sudo apt-get install ca-certificates.

Téléchargement du client

Téléchargez le client correspondant à votre système d'exploitation via les liens suivants :

Le client téléchargé ne nécessite aucune installation. Exécutez la commande chmod +x dlc pour attribuer les permissions d'exécution au fichier. Vous pouvez ensuite invoquer les commandes du client depuis la ligne de commande.

Saisie semi-automatique (completion)

Fonctionnalité

La saisie semi-automatique fonctionne comme celle des outils en ligne de commande communautaires Kubectl et Arena. Appuyez deux fois sur la touche Tab dans la ligne de commande pour utiliser la saisie semi-automatique du client DLC. Cette fonctionnalité propose des suggestions pour les commandes incomplètes.
Format
```
./dlc completion <shelltype>
```
Paramètres

<shelltype> spécifie le type de shell pour lequel vous souhaitez générer le script de saisie semi-automatique. Les types pris en charge incluent bash, fish, powershell et zsh.
Exemple
L'exemple suivant illustre l'utilisation de la saisie semi-automatique avec bash :
1. Si le package bash-completion n'est pas installé, exécutez la commande suivante pour l'installer, puis utilisez la commande source pour appliquer les modifications. Si le package est déjà installé, ignorez cette étape.
```
# 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
```
2. Exécutez la commande suivante pour activer la saisie semi-automatique. Cette fonctionnalité dépend du package bash-completion. Une erreur indique que le package bash-completion n'est pas installé dans votre environnement.
```
source <(./dlc completion bash)
```
3. Saisissez ./dlc et appuyez deux fois sur la touche Tab pour afficher les commandes fournies par le client DLC.
```
./dlc 
```
  Le système renvoie les commandes suivantes fournies par le client DLC.
```
completion  config      create      delete      get         help        logs        stop        submit
```
Remarque
Pour les autres types de shell, exécutez la commande dlc completion <zsh | fish | powershell> --help pour obtenir des instructions d'utilisation détaillées.

Authentification utilisateur (config)

Fonctionnalité

Lors de la première utilisation du client DLC pour gérer les données et les jobs, authentifiez-vous à l'aide de l'AccessKey ID et de l'AccessKey Secret de votre compte Alibaba Cloud. Après cette authentification initiale, aucune nouvelle authentification n'est requise.

Format

./dlc config --protocol https --access_id <yourAccessKeyID> --access_key <yourAccessKeySecret> [--endpoint <yourEndpoint>] [--region <yourRegion>]

Paramètres

Paramètres à remplacer

Obligatoire

Description

Type

Oui

L'AccessKey ID de votre compte Alibaba Cloud.

STRING

Oui

L'AccessKey Secret de votre compte Alibaba Cloud.

STRING

Oui

L'endpoint de la région où se trouve le service DLC. Exemple : pai-dlc.cn-shanghai.aliyuncs.com.

STRING

Oui

La région où se trouve le service DLC. Par exemple, l'ID de région pour Chine (Shanghai) est cn-shanghai.

STRING

Exemple

Après l'authentification, la configuration est enregistrée par défaut dans le fichier .dlc/config du répertoire courant. Par exemple, exécutez une commande similaire à la suivante :

./dlc config --protocol https       \
           --access_id <AccessKeyId>       \
           --access_key <AccessKeySecret>  \
           --endpoint 'pai-dlc.cn-shanghai.aliyuncs.com' \
           --region cn-shanghai

Un message similaire au suivant s'affiche :

[OK] Configuration saved to: ~/.dlc/config

Références

Une fois le client authentifié, effectuez des opérations à l'aide des commandes prises en charge. Pour plus d'informations, consultez la section Liste des commandes.
Vous pouvez également soumettre des jobs DLC depuis la console. Pour plus d'informations, consultez la section Créer des tâches dans la console.