@@ -23,29 +23,130 @@ Cette documentation détaille l'utilisation du client en ligne de
commande (ou **CLI** pour *Command Line Interface*) `openstack` interagissant avec les modules OpenStack pour
utiliser efficacement le service de Cloud Computing IaaS. Une
alternative à l'utilisation de la ligne de commande est d'utiliser
[l'interface Web Horizon](https://lpnhe-cloud028.in2p3.fr/dashboard/).
[l'interface Web Horizon](https://lpnhe-cloud.in2p3.fr/dashboard/).
# CLI: étapes obligatoires
# Client Openstack : installation et conditions d'utilidation
## Définition des variables d'environnement
## Conditions d'utilisation
Pour pouvoir utiliser le service cloud via la CLI (*Command Line Interface*), vous devez soit vous connecter via ssh à une passerelle correspondant soit en installant la CLI directement sur votre poste. Vous devez être, dans les deux cas, connectés sur un des réseaux suivant: IN2P3, Sorbonne-Université, Université de Paris ou ISCPIF.
Pour les membres du LPNHE, l'accès à la passerelle se fait en utilisant le *login/password* de votre compte mail, via:
Pour pouvoir utiliser le service cloud, vous devez au préalable vous connecter via ssh à la passerelle correspondant à votre projet :
``` {.sourceCode .console}
$ ssh username@IP_PROJECT_SSHGATE
$ ssh username@lpncloud-sshint.in2p3.fr
```
Pour les utilisateurs *extérieurs*, l'accès se fait avec les identifiants qui vous ont été communiqués lors de la création
de votre compte, via :
``` {.sourceCode .console}
$ ssh username@lpncloud-sshext.in2p3.fr
```
## Installation
Cette section détaille la procédure d'installation du client en ligne de
commande d'OpenStack.
Le client `openstack` est disponible pour différents systèmes
d'exploitation, soit à travers une installation avec PIP ou par les
gestionnaires de paquets APT ou YUM pour les distributions Linux Debian,
Ubuntu, RedHat ou dérivées. Dans tous les cas, il est nécessaire que le
logiciel [Python](http://www.python.org)(version 2.7 ou ultérieure)
soit installé. Une seule installation est nécessaire, soit avec le
gestionnaire de paquets de votre distribution, soit avec PIP. Nous
recommandons d'utiliser l'installation à l'aide du gestionnaire de
paquets quand c'est possible.
Les différents modes d'installation sont détaillées ci-après. Il faut
éviter d'utiliser deux modes d'installation, en mélangeant par exemple
PIP avec les paquets de la distribution, pour éviter des conflits entre
les différentes versions qui peuvent rendre le client inutilisable.
Installation sur les systèmes Debian et Ubuntu
----------------------------------------------
La version du client `openstack` fournie par défaut dans Ubuntu 16.04
est trop ancienne et présente des bugs. Il faut donc utiliser une
version plus récente disponible dans le dépôt *cloud-archive*. Pour
installer un client `openstack` récent, il faut exécuter en tant que
super-utilisateur (c'est-à-dire avec la commande `sudo` pour Ubuntu) :
``` {.sourceCode .console}
$ sudo add-apt-repository cloud-archive:ocata
$ sudo apt-get update
$ sudo apt-get install python-openstackclient
```
où le champ `IP_PROJECT_SSHGATE` est à remplacer par l'adresse IP qui vous a été communiquée par mail.
Pour les utilisateurs du LPNHE, les *login/password* de connexion à la passerelle sont ceux de votre compte mail. Pour les extérieurs, ils vous sont communiqués à l'issue de la création de votre compte.
Sous Debian 10, il suffit d'exécuter la commande :
> **Remarque**
``` {.sourceCode .console}
$ sudo apt-get install python-openstackclient
```
> **note**
>
> Les IPs des passerelles sont enregistrées dans le serveur DNS. Vous pouvez donc utiliser le nom de domaine d'une passerelle plutôt que son IP,
> en remplaçant `IP_PROJECT_SSHGATE` par `lpncloud-project.in2p3.fr` où *project* est le nom du projet auquel vous appartenez.
Il faut maintenant configurer le client. Pour cela, créez
le fichier `${HOME}/.cloud.env` avec le contenu suivant (les
valeurs *username*, *password* et *projectname* sont à remplacer par celles qui vous
ont été transmises lors de la création de votre compte sur le service) :
> Pour les versions antérieures d'Ubuntu, il est nécessaire d'utiliser
> la méthode d'installation avec PIP.
Installation sur Centos
-----------------------
L'installation en utilisant `yum` avec le système CentOS est réalisée en
quelques étapes suivantes. Le logiciel n'est disponible que pour la
version 7 de CentOS. Si vous souhaitez installer les clients sur une
version antérieure, il est nécessaire de suivre la méthode
Dans le tableau précédent, nous remarquons que deux réseaux sont
disponibles, `uplink_v4` et `project_network`. Le réseau
`uplink_v4` est utilisé pour fournir une adresse IP publique à la passerelle `project_sshgate`. Cette passerelle vous permet de vous connecter depuis le laboratoire aux machines virtuelles que vous créez. Ces dernières ont une adresse IP privée attribuée par le réseau `project_network` et ne sont donc pas accessible directement. Donc lorsque vous créerez vos machines, le réseau que vous devez utiliser est `project_network`.
Dans le tableau précédent, nous remarquons que deux réseaux sont disponibles, `uplink_v4` et `project_network`.
Le réseau `project_network` est un réseau privé et nécessaire à la création des machines virtuelles. Les VMs n'ont
par défaut qu'une IP privée, les rendant inacessibles depuis un autre réseau.
C'est pourquoi le réseau `uplink_v4` existe. Il est utilisé pour fournir une adresse IP publique aux machines virtuelles et de leur permettre de communiquer avec l'exterieur.
> **Remarque**
>
> Le réseau `uplink_v4` peut s'appeler `int_uplimk_v4` ou `ext_uplink_v4`,
> suivant le projet auquel vous appartenez.
Lancement de la machine virtuelle ( VM )
----------------------------------------
...
...
@@ -674,8 +782,7 @@ Enfin, vous pouvez supprimer la VM :
$ openstack server delete MY_VM_NAME
```
Utilisation avancée
===================
# Utilisation avancée
Ce chapitre décrit des possibilités d'utilisation avancée du service de
