Installez python-openstackclient sur Linux et Mac OS

Gestion à distance

Le panneau de configuration cloud n'est pas le seul moyen de gérer les serveurs cloud. Si vous exécutez un script ou un programme, vous pouvez utiliser l'API Cloud Servers, mais cela implique un certain effort de codage.

Si vous souhaitez gérer vos serveurs depuis la ligne de commande sans traiter directement avec l'API, vous pouvez utiliser une application client open-source appelée python-openstackclient .

Remarque :Rackspace ne maintient pas le openstackclient , et il n'est pas garanti de fonctionner avec Rackspace Cloud.

Prérequis

Pour exécuter python-openstackclient , vous devez installer Python® 2.7 ou version ultérieure sur votre système. Vous pouvez exécuter le client à partir d'un ordinateur de bureau ou d'un système distant, comme un serveur cloud. Vous avez également besoin de pip , qui est un gestionnaire de packages Python.

Installer le package

Pour installer le client, exécutez la commande suivante :

pip install python-openstackclient

Définir les variables d'environnement

Maintenant que vous avez installé openstackclient , configurez les variables d'environnement qui lui permettent de se connecter à votre compte Rackspace Cloud.

Pour définir certaines variables d'environnement, exécutez la commande suivante pour ouvrir votre .bash_profile fichier à éditer :

nano ~/.bash_profile

Ajoutez ensuite les lignes suivantes dans la section du centre de données, en modifiant les valeurs en fonction de vos besoins. Portez une attention particulière au nom d'utilisateur, au mot de passe et au nom du locataire ou au numéro de compte. Vous pouvez trouver votre numéro de compte dans le coin supérieur droit du panneau de configuration du cloud après vous être connecté.

Utilisez le format suivant :

OS_USERNAME=username
OS_TENANT_NAME=accountnumber
OS_AUTH_SYSTEM=rackspace
OS_PASSWORD=password
OS_AUTH_URL=https://identity.api.rackspacecloud.com/v2.0/
OS_REGION_NAME=DFW
OS_NO_CACHE=1
export OS_USERNAME OS_TENANT_NAME OS_AUTH_SYSTEM OS_PASSWORD OS_AUTH_URL OS_REGION_NAME OS_NO_CACHE

Autorisations

Après avoir défini les variables d'environnement, enregistrez le fichier. Puisqu'il inclut un mot de passe, exécutez la commande suivante pour définir des autorisations sur le fichier afin que d'autres personnes ne puissent pas le lire :

chmod 600 ~/.bash_profile

Explications des variables d'environnement

Le tableau suivant répertorie les explications pour chaque variable d'environnement et propose des valeurs suggérées :

Nom de la variable	Type de valeur	Description
OS_USERNAME	nom d'utilisateur	Définissez cette valeur sur le nom d'utilisateur de votre compte Rackspace Cloud.
OS_TENANT_NAME	numéro de compte	Définissez cette valeur sur votre numéro de compte Rackspace Cloud, visible dans le coin supérieur droit du panneau de contrôle du Cloud lorsque vous êtes connecté.
OS_AUTH_SYSTEM	espace rack	Définissez cette valeur sur rackspace pour se connecter au Rackspace Cloud.
OS_PASSWORD	mot de passe	Définissez cette valeur sur le mot de passe de votre compte Rackspace Cloud.
OS_AUTH_URL	point de terminaison d'identité	Définissez cette valeur sur le point de terminaison du service d'identité que le client utilise pour s'authentifier pour les opérations d'API, https://identity.api.rackspacecloud.com/v2.0 .
OS_REGION_NAME	région du centre de données	Le code de la région du centre de données contenant les serveurs que vous souhaitez manipuler. Vous pouvez vérifier le centre de données de votre serveur en vérifiant ses détails l'écran dans le panneau de configuration du cloud. Le code du centre de données se compose uniquement des trois premières lettres de l'identifiant du centre de données, telles que DFW, IAD, ORD, HKG, SYD, or LON. Vous pouvez remplacer le paramètre de région par le --os-region-name option de ligne de commande.
OS_NO_CACHE	0 ou 1	Sur les nouvelles versions du système d'exploitation Ubuntu®, le openstackclient essaie d'utiliser un trousseau de clés système qui n'est pas configuré sur les serveurs. Définir cette valeur sur 1 aborde le problème. Cela ne devrait pas être nécessaire sur d'autres systèmes, et cela ne devrait pas non plus interférer avec les opérations du client. Vous pouvez remplacer le os_no_cache réglage avec le --no-cache option de ligne de commande.

Charger les variables d'environnement

Pour appliquer ces variables d'environnement à votre shell actuel, exécutez la commande suivante :

source ~/.bash_profile

Tester le client

Ensuite, exécutez une requête rapide pour vous assurer que le openstackclient est prêt à fonctionner. Pour voir si vous pouvez parler au serveur d'API, exécutez la commande suivante :

openstack image list

Si la commande réussit, le système affiche une liste des images disponibles lors de la création d'un serveur.

Message de mot de passe du trousseau

Si vous exécutez le client sur le système d'exploitation Ubuntu® et qu'il demande un mot de passe de trousseau, exécutez le client avec le --no-cache option, comme illustré dans l'exemple suivant :

openstack --no-cache image-list

Ou vous pouvez définir la variable d'environnement OS_NO_CACHE=1 comme indiqué dans l'exemple de configuration précédent.

Afficher la liste des commandes

Vous pouvez obtenir une liste complète des commandes en utilisant la commande suivante :

openstack help

Remarque :Vous ne pouvez pas utiliser toutes les commandes répertoriées. Le openstackclient utilise des versions de développement récentes d'OpenStack®, il inclut donc la prise en charge de certaines fonctionnalités que Rackspace n'a pas implémentées dans le Rackspace Cloud.

Vous pouvez obtenir plus d'aide pour une sous-commande en exécutant la commande suivante :

openstack help network

Dépannage

Utilisez le --debug flag pour afficher à la fois la requête complète de openstackclient et toutes les réponses des API Rackspace Cloud. Ces informations peuvent vous aider lorsque vous remplissez un rapport de bogue ou ouvrez un ticket d'assistance.

Un problème courant est la saisie incorrecte du nom d'utilisateur, du nom du locataire ou du mot de passe. Assurez-vous donc de revérifier ces paramètres.

N'oubliez pas que si vous modifiez des variables d'environnement, vous devez soit vous déconnecter et vous reconnecter, soit dire à votre shell de réappliquer le .bash_profile à nouveau en utilisant la commande suivante :

source ~/.bash_profile

Vous pouvez également utiliser les options répertoriées dans l'openstack help outputpour remplacer certains paramètres de variables d'environnement. Si vous n'êtes pas sûr de la région, par exemple, vous pouvez la remplacer par le --os-region-name comme indiqué dans l'exemple suivant :

openstack --os-region-name ORD image list

Avantages par rapport au panneau de configuration cloud

Le openstackclient prend en charge les fonctionnalités de l'API Cloud Servers mais que le panneau de configuration Cloud n'expose pas. Par exemple, la commande suivante crée un serveur avec le lecteur de configuration OpenStack et les données utilisateur pour cloud-init :

openstack server create --image "Ubuntu 16.04 LTS (Xenial Xerus) (PVHVM)" --flavor general1-1 --config-drive=True --user-data=rack-ubuntu.yml openstack-server

Utilisez l'onglet Commentaires pour faire des commentaires ou poser des questions. Vous pouvez également entamer une conversation avec nous.