Comme les VPS GandiCloud sont basés sur OpenStack, vous pouvez utiliser l’API d’OpenStack pour interagir avec votre serveur via une interface en ligne de commande.
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 "Merci d'entrer votre mot de passe VPS GandiCloud pour le projet $OS_PROJECT_NAME comme utilisateur $OS_USERNAME: (même mot de passe que votre compte GandiV5)"
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.
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>
Comment configurer et utiliser l’API OpenStack sur un VPS GandiCloud¶
Préparer votre environnement pour utiliser le CLI OpenStack
Créer votre premier Serveur OpenStack
Envie d’en faire plus ?
Comme les VPS GandiCloud sont basés sur OpenStack, vous pouvez utiliser l’API d’OpenStack pour interagir avec votre serveur via une interface en ligne de commande.
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 openstackclientCré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 :
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.shIl 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 listSélectionner une « configuration » pour votre serveur. La configuration est la combinaison du CPU et de la RAM pour votre VM.
$ openstack flavor listCré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 listVous 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.