Comment configurer et utiliser l’API OpenStack sur un VPS GandiCloud

Préparer votre environnement pour utiliser le CLI OpenStack

Avant d’accéder à l’API publique, vous devez configurer votre interface de ligne de commande pour accéder à OpenStack.

Installer le client Python OpenStack

pip3 install openstackclient

Créez un fichier de configuration pour le CLI OpenStack, nommé « ma_conf_gandivps.sh » et entrez-y les lignes suivantes, en remplaçant les espaces réservés dans les deux premières lignes par les valeurs adéquates :

#!/usr/bin/env bash

export OS_USERNAME="<your gandiv5 username>"
export OS_PROJECT_NAME="<The name of the Gandi registered organization you wish to manage resources for>"
export OS_USER_DOMAIN_NAME=public
export OS_PROJECT_DOMAIN_NAME=public
export OS_AUTH_URL=https://keystone.sd6.api.gandi.net:5000/v3
export OS_IDENTITY_API_VERSION=3
echo "Please enter your GOStack Password for project $OS_PROJECT_NAME as user $OS_USERNAME: (same password as your gandi v5 account)"
read -sr OS_PASSWORD_INPUT
export OS_PASSWORD="$OS_PASSWORD_INPUT"

Puis sourcez-le dans votre shell actuel (et pour tous les autres shells que vous souhaiteriez utiliser pour le CLI OpenStack).

source ma_conf_gandivps.sh

Il vous sera demandé d’entrer votre mot de passe, qui sera conservé dans la variable d’environnement OS_PASSWORD.

Votre environnement est prêt, vous pouvez commencer à utiliser votre premier serveur.

Créer votre premier Serveur OpenStack

Vous pouvez dorénavant utiliser l’interface en ligne de commande pour créer un serveur, comme expliqué ci-dessous.

Sélectionnez une image pour votre serveur. Une image est un système d’exploitation (OS) préinstallé que votre VM (Machine Virtuelle) utilisera pour démarrer.

$ openstack image list

Sélectionner une « configuration » pour votre serveur. La configuration est la combinaison du CPU et de la RAM pour votre VM.

$ openstack flavor list

Créez une paire de clés. Les paires de clés sont un ensemble de clé publique et de clé privée liées entre elles. Vous ne devrez fournir que votre clé publique. Celle-ci sera installée sur votre VM pour vous permettre de vous y connecter en SSH.

$ openstack keypair create --public-key <your_public_key_file> <keypair_name>

Créez votre serveur. Cette commande va créer un nouveau volume (disque) et l’attacher à votre serveur.

$ openstack server create --flavor <flavor_id_or_name> --image <image_id_or_name> --boot-from-volume <size-in-GB> --network public --key-name <keypair_name> <server_hostname>

Votre serveur sera en état « BUILD » directement après sa création, puis il passera en « ACTIVE » quand il sera prêt.

Vous pouvez vérifier son état en utilisant la commande :

$ openstack server list

Vous pouvez vous connecter par SSH en utilisant votre clé privée. Ou si vous avez configuré un mot de passe, vous pouvez ouvrir l’url de la console dans votre navigateur en utilisant :

openstack console url show <your_server_name_or_id>

Envie d’en faire plus ?

Vous pouvez trouver la documentation utilisateur officielle pour le CLI ici (en anglais) :

https://docs.openstack.org/python-openstackclient/ussuri/

Pour les autres outils ou l’accès direct aux API, le point de terminaison Keystone est disponible sur:

https://keystone.sd6.api.gandi.net:5000/v3

Les Projets sont mappés à une organisation et votre utilisateur est votre identifiant Gandi.