Connexion avec le CLI
Pour utiliser OpenStack en ligne de commande il faut installer le client openstack sur votre machine, qui est un programme Python.
Environnement virtuel
L'installation dans un environnement virtuel spécifique est facultative mais recommandée par les bonnes pratiques.
Le module venv est habituellement installé dans les versions récentes de Python. Créez votre environnement virtuel, par exemple gricad-nova-env.
python -m venv gricad-nova-env
Enfin, activez cet environnement virtuel.
source gricad-nova-env/bin/activate
CLI Openstack
Installation du client
Installez le client openstack, documentation du module.
pip install python-openstackclient
Vous pouvez vérifier que le client est fonctionnel .
openstack --version
Authentification
Vous trouverez tous les détails de la configuration du client pour s'authentifier à OpenStack ici.
Pour vous connecter avec le CLI ou via les APIs, deux méthodes existent :
- Variables d'environnement / fichier RC : un fichier RC est téléchargeable sur Horizon (menu utilisateur en haut à droite). Il suffit de le sourcer. Cette méthode est pratique en interactif, mais le fichier RC s'appuie sur l'authentification OIDC de votre compte et n'est pas adapté à un usage non interactif (CI, runner, cron).
- Fichier
clouds.yamlavec une Application Credential : méthode recommandée pour le CLI, les scripts et les runners. Le fichier se place dans~/.config/openstack/clouds.yaml.
Le fichier clouds.yaml téléchargeable depuis le menu utilisateur en haut à droite d'Horizon (profil) n'est pas utilisable directement pour le CLI non interactif : il dépend de la session OIDC et renvoie souvent HTTP 401. Pour le CLI et l'automatisation, utilisez le clouds.yaml généré lors de la création d'une Application Credential (voir ci-dessous).
Créer une Application Credential et récupérer le clouds.yaml
Pour en savoir plus sur les Application Credentials : documentation OpenStack.
Dans Horizon : Identité > Identifiants d'application.
Cliquez sur Créer un identifiant d'application.

Choisissez un nom et le rôle :
memberpour un usage complet (création/suppression de ressources) ;readerpour un usage en lecture seule.

À la création, Horizon propose de télécharger le fichier
clouds.yamlpré-rempli. Téléchargez-le immédiatement : le secret de l'Application Credential n'est affiché qu'une seule fois.
Placez-le dans
~/.config/openstack/clouds.yamlsur la machine où vous exécutez le CLI.Vérifiez le nom du cloud (la clé sous
clouds:) et testez :
openstack --os-cloud <nom_du_cloud> token issue
Si la commande renvoie un token, l'authentification fonctionne. Vous pouvez ensuite lancer vos commandes :
openstack --os-cloud <nom_du_cloud> server list
openstack --os-cloud <nom_du_cloud> floating ip list
En cas de HTTP 401
- Vérifiez que le fichier s'appelle bien
clouds.yaml(et nonclouds.yml) et qu'il est dans~/.config/openstack/. - Vérifiez que vous êtes bien l'utilisateur qui lance la commande : le fichier doit être dans son
$HOME(echo $HOME), pas dans celui d'un autre compte. - Vérifiez qu'il n'y a pas un autre
clouds.yamldans le répertoire courant ou dans/etc/openstack/qui serait chargé à la place. - Vérifiez que
--os-cloud <nom_du_cloud>correspond à la clé sousclouds:dans le fichier. - Vérifiez qu'aucune variable
OS_*ouOS_CLOUDne vient écraser la configuration :env | grep OS_. - Vérifiez que l'Application Credential n'a pas expiré et qu'elle a bien le rôle
member(oureader). - Si le 401 persiste, recréez l'Application Credential et remplacez le
clouds.yaml. - Le
clouds.yamldu profil utilisateur (menu en haut à droite) ne convient pas : utilisez celui de l'Application Credential.
Récupérer le fichier RC (méthode interactive)
Le fichier RC reste utile pour un usage interactif. Cliquez sur votre login en haut à droite de l'interface web, puis téléchargez le fichier RC.

Puis sourcez-le :
source <fichier_rc>.sh
Le fichier RC utilise l'authentification OIDC. Il peut donc demander une authentification interactive et n'est pas adapté aux jobs CI ou aux runners.
Mise à jour de modules
Il faudra de temps en temps mettre à jour les modules de votre environnement car ils ne sont pas gérés par la distribution.
pip install -U MODULE_NAME