Bases de la CLI de redimensionnement 1.1X

Syntaxe de soumission de base

Une fois l'application Rescale CLI installée, une tâche peut être soumise à l'aide de la commande suivante :

rescale-cli soumettre -p -i

Rescale CLI par défaut sur la plate-forme américaine plateforme.rescale.com. Si vous êtes un utilisateur de l'une des autres plates-formes mondiales (UE, JP, KR, ITAR), veuillez spécifier votre plate-forme régionale à l'aide de l'indicateur -X dans votre commande CLI. Par exemple:

DE VENTECOMMANDE CLI
EUrescale-cli -X https://eu.rescale.com soumettre -p -je
Japonrescale-cli -X https://platform.rescale.jp soumettre -p -je
Coréerescale-cli -X https://kr.rescale.com soumettre -p -je
ITARrescale-cli -X https://itar.rescale.com soumettre -p -je

Le contient les commandes que l'utilisateur peut souhaiter exécuter sur Rescale. Cela peut être n'importe quel genre de .sh script shell qui peut être exécuté à partir de la ligne de commande à l'aide du ./ préfixe. Quel que soit le type de script, l'application tentera de l'analyser pour minimiser les problèmes accidentels liés à la configuration de l'environnement et aux commandes non prises en charge. Le -p L'indicateur est utilisé pour lire le jeton API Rescale que vous avez créé comme indiqué ici.

Pour utiliser les commandes CLI Rescale, la clé API Rescale doit être utilisée à chaque fois. Étant donné que la clé API est une longue combinaison de lettres et de chiffres, il sera utile de créer une variable d'environnement et de l'enregistrer dans votre profil afin que vous puissiez facilement utiliser la variable API plutôt que la clé réelle à chaque fois que vous utilisez les commandes. Comme option alternative, un fichier de configuration peut être créé avec votre profil pour utiliser les commandes CLI sans utiliser la clé API à chaque fois. Vous pouvez suivre les étapes décrites ci-dessous pour créer une variable d'environnement ou créer un fichier de configuration avec votre profil :

Sous Linux

Définition de la variable d'environnement de clé API

  • Sur votre terminal, tapez soit vi ~/.bashrc OR vi ~/.bash_profile et appuyez sur ENTRÉE.
  • Cela ouvre un éditeur de terminal dans lequel vous pouvez taper ce qui suit : export RESCALE_API_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  • Une fois que vous avez fini de taper, appuyez d'abord sur ESC, puis tapez :wq pour enregistrer les modifications.
  • Vous pouvez tester la variable en affichant la variable en utilisant echo $RESCALE_API_KEY. Cela affichera la clé API Rescale sur le terminal.

Utilisation de profils dans un fichier de configuration

  • Par défaut, la CLI recherchera le fichier de profil dans ~/.config/rescale/apiconfig. Dans un premier temps, créez un répertoire Rescale mkdir ~/.config/rescale. Ensuite, créez le fichier de configuration vi ~/.config/rescale/apiconfig et ajoutez le contenu suivant :
[default]
apikey = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

La CLI utilisera le [default] profil automatiquement. Un profil nommé différent peut être spécifié en utilisant le --profile argument de ligne de commande. Il est également possible d'utiliser un chemin de fichier de configuration différent en définissant le RESCALE_CONFIG_FILE variable d'environnement sur le chemin souhaité.

Si un utilisateur utilise plusieurs profils pour différentes plates-formes, il doit spécifier l'URL de ces plates-formes dans l'apiconfig comme suit :

[default]
apibaseurl = https://platform.rescale.com
apikey = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

[UE]

apibaseurl = https://eu.rescale.com apikey = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX


Sur Windows

Définition de la variable d'environnement de clé API

  • Sur votre terminal, saisissez ce qui suit : set RESCALE_API_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  • Vous pouvez vérifier si la clé API a été ajoutée aux variables d'environnement en tapant echo %RESCALE_API_KEY%

Cela devrait afficher la clé API que vous avez ajoutée.

Utilisation de profils dans un fichier de configuration

Par défaut, la CLI recherchera le fichier de profil dans %USERPROFILE%.configrescaleapiconfig. Dans un premier temps, accédez à votre %USERPROFILE% annuaire. Créer un dossier .config , l’aspect économique rescale dossier en dessous. À l'intérieur .configrescale, ouvrez le bloc-notes et ajoutez le contenu suivant :

[default]
apikey = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Lors de l'enregistrement du fichier, tapez le nom du fichier comme "apiconfig" (Avec les guillemets doubles pour l'enregistrer sans aucune extension de fichier) et enregistrez-le sous Tous les fichiers type.

La CLI utilisera le [default] profil automatiquement. Un profil nommé différent peut être spécifié en utilisant le --profile argument de ligne de commande. Il est également possible d'utiliser un chemin de fichier de configuration différent en définissant le RESCALE_CONFIG_FILE variable d'environnement sur le chemin souhaité.

Si un utilisateur utilise plusieurs profils pour différentes plates-formes, il doit spécifier l'URL de ces plates-formes dans l'apiconfig comme suit :

[default]
apibaseurl = https://platform.rescale.com
apikey = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

[UE]

apibaseurl = https://eu.rescale.com apikey = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX  

Regardons un exemple très simple.

Pour lancer un « Hello World ! » travail, à partir d'un terminal shell (comme sous Linux, MacOS ou Cygwin), créez un nouveau répertoire d'exécution. A l'aide de l'éditeur de texte de votre choix, créez un submit.sh script de soumission d'entrée contenant :

#!/bin/bash
#RESCALE_NAME="Hello World"
#RESCALE_CORES=1
#RESCALE_ANALYSIS=user_included
#RESCALE_ANALYSIS_VERSION=0
#RESCALE_CORE_TYPE=Emerald

echo "Hello World!" > hello_world
sleep 120

À noter: Lors de la copie du script ci-dessus, assurez-vous qu'il n'y a pas d'espace après chaque variable d'environnement.

Soumettez le travail en exécutant la commande suivante dans la fenêtre de votre terminal :

rescale-cli submit -i submit.sh

Cela créera un nouveau grappe et soumettez les travaux avec les commandes du script. L'utilisateur peut désormais se connecter à l'interface utilisateur Web de Rescale pour suivre et surveiller le travail. La liste des tâches affichera la tâche comme : "Bonjour le monde"

Travail soumis

La page d'état affichera la progression du travail et les fichiers peuvent être suivis depuis l'interface utilisateur en cliquant sur le fichier :

Travail soumis

Le journal ressemblera à ceci :

2019-08-26 22:17:55,295 - Authenticated as @rescale.com
2019-08-26 22:17:55,304 - Executing Command.
2019-08-26 22:17:55,308 - Parsing Input Files
2019-08-26 22:17:55,308 - No existing files to include
2019-08-26 22:18:03,112 - Found Analysis: user_included
2019-08-26 22:18:04,274 - No project with the specified name was found: null
2019-08-26 22:18:04,274 - Zipping Files
2019-08-26 22:18:04,276 - Creating temporary encrypted zip at /tmp/rescale-cli-work/input.zip
2019-08-26 22:18:07,054 - Finished writing encrypted file
2019-08-26 22:18:07,055 - Uploading Files
2019-08-26 22:18:07,057 - Uploading: /tmp/rescale-cli-work/run.sh
2019-08-26 22:18:07,058 - Uploading run.sh:
2019-08-26 22:18:07,736 - ##############################| 192B / 192B
2019-08-26 22:18:08,069 - Uploading: /tmp/rescale-cli-work/input.zip
2019-08-26 22:18:08,069 - Uploading input.zip:
2019-08-26 22:18:11,532 - ##############################| 86.39MB / 86.39MB
2019-08-26 22:18:11,818 - Job: Saving Job
2019-08-26 22:18:12,568 - Job kREtT: Saved
2019-08-26 22:18:12,568 - Job kREtT: Submitting
2019-08-26 22:18:13,748 - Job kREtT: --end-to-end flag not set, polling should be done manually.