Installer et configurer OSC CLI

Vous pouvez gérer vos ressources du Cloud OUTSCALE avec OSC CLI, une interface en ligne de commande (CLI) développée par 3DS OUTSCALE.

OSC CLI est compatible avec l’API OUTSCALE et toutes nos API AWS-compliant.

Vous pouvez utiliser aussi Cockpit ou AWS CLI. Pour en savoir plus, voir À propos de Cockpit et Utiliser et configurer AWS CLI.

Installer OSC CLI

Installer OSC CLI sur Linux

Avant de commencer : Assurez-vous que Python 3.6 ou ultérieur et pip3 sont installés sur votre machine.

(optionnel) Il est recommandé d’installer OSC CLI et ses dépendances dans un environnement virtuel Python (virtualenv), plutôt que directement sur votre système. Pour créer un virtualenv, lancez les commandes suivantes :
```
$ python3 -m venv .venv
$ source .venv/bin/activate
```
Pour installer OSC CLI depuis le paquet PyPI, lancez la commande suivante :
```
$ pip install osc-sdk
```
Pour quitter le virtualenv, tapez deactivate dans votre terminal.

Installer OSC CLI sur macOS

Avant de commencer : Installez Homebrew sur votre machine.

Pour installer OSC CLI depuis le paquet Homebrew, lancez la commande suivante dans votre terminal :
```
$ brew install osc-cli
```
Mettez à jour la variable d’environnement PATH de votre terminal avec la commande suivante (remplacez PRENOM.NOM par la valeur adéquate, et 3.9 par votre numéro de version de Python) :
```
$ export PATH=$PATH:/Users/PRENOM.NOM/Library/Python/3.9/bin/
```

Installer OSC CLI sur Windows

Installez Python 3 sur votre machine :
1. Téléchargez et lancez le installateur Python le plus récent.
2. Cochez la case Add Python 3.x to PATH.
3. Cliquez sur Install Now.
4. Cliquez sur Disable path length limit.
Dans une invite de commande, tapez la commande suivante :
```
$ pip install --upgrade pip
$ pip install osc-sdk
```
OSC CLI est maintenant installé.

Configurer OSC CLI

Dans votre répertoire home, créez un répertoire .osc.

Dans .osc, créez un fichier nommé config.json avec le contenu suivant :

{
    "default": {
        "access_key": "ACCESSKEY",
        "secret_key": "SECRETKEY",
        "host": "outscale.com",
        "https": true,
        "method": "POST",
        "region_name": "eu-west-2"
    }
}

Si nécessaire, remplacez eu-west-2 par la Région de votre compte.

Remplacez également ACCESSKEY et SECRETKEY par l’ID d’access key et la secret key correspondante de votre compte.

Avec Cockpit, vous pouvez trouvez l’ID de votre access key et la secret key correspondante en suivant les étapes suivantes :

Placez le curseur de la souris sur votre nom.
Cliquez sur Profil & access keys > Access keys.
Tapez votre mot de passe.

Si vous n’avez pas accès à Cockpit, vous pouvez les obtenir en suivant les étapes suivantes :

Enregistrez le fichier ci-dessus.
Lancez la commande suivante, en remplaçant EMAIL et PASSWORD par l’email et le mot de passe de votre compte OUTSCALE :
Exemple de requête
```
$ osc-cli icu ListAccessKeys --authentication-method "password" --login "EMAIL" --password '"PASSWORD"'
```

Vous pouvez maintenant exécuter des requêtes d’API avec OSC CLI.

Pour des options de configuration plus avancées, voir le dépôt GitHub d’OSC SCLI.

Utiliser OSC CLI

Pour envoyer une requête avec OSC CLI, spécifiez dans votre commande :

Une des API supportées (api pour l’API OUTSCALE, ou fcu, lbu, eim, icu ou directlink).
La requête que vous demandez.
Tout autre attribut attendu par la commande.

Exemple de requête

$ osc-cli api CreateVolume \
   --SubregionName eu-west-2a \
   --Size 10

Si vous voulez spécifier un nombre en tant que chaîne de texte et non en tant qu’entier, vous devez l’entourer de deux paires de guillemets ('"12345678"').
Si vous voulez spécifier une chaîne de texte contenant un croisillon (#), vous devez aussi l’entourer de deux paires de guillemets ('"exam#ple"').

Pages connexes

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.