Les clients OpenStack trouvent les services à utiliser à l’aide de variables d’environnement. Ceux-ci sont généralement stockés dans un fichier shell appelé openrc. Les variables seront différentes selon le projet que vous utilisez. Les détails de ces variables d’environnement se trouvent dans la documentation d’OpenStack.
Afin d’éviter de définir ces variables d’environnement manuellement, vous pouvez récupérer le fichier directement depuis le dashboard.
Accédez au tableau de bord OpenStack, connectez-vous et vous pourrez télécharger un fichier openrc comme cela :
Cela téléchargera un fichier .sh via votre navigateur qui peut être utilisé pour l’authentification. Le script doit être chargé de la manière suivante à partir d’un terminal Linux :
Avec Bash :
. openrc.sh
Avec Zsh :
source openrc.sh
Si vous souhaitez télécharger un fichier openrc pour un autre projet, vous devez basculer le projet de la liste déroulante juste à droite vers le logo « openstack » afin de « l’activer » dans l’interface Web et ainsi télécharger le bon fichier pour le projet souhaité.
Pour “décharger” ces variables d’environnements, vous pouvez soit fermer votre invite de commande, soit les “décharger” avec cette commande :
unset OS_PASSWORD
Un projet est un groupe de zéro ou plusieurs utilisateurs. Dans Compute, un projet possède des machines virtuelles. Dans Object Storage, un projet possède des conteneurs. Les utilisateurs peuvent être associés à plusieurs projets. Chaque association projet et utilisateur peut être associée à un rôle.
Lister tous les projets avec leur ID, leur nom et s’ils sont activés ou désactivés avec openstack project list
:
openstack project list
+----------------------------------+--------------------+
| ID | Name |
+----------------------------------+--------------------+
| f7ac731cc11f40efbc03a9f9e1d1d21f | admin |
| c150ab41f0d9443f8874e32e725a4cc8 | alt_demo |
| a9debfe41a6d4d09a677da737b907d5e | demo |
| 9208739195a34c628c58c95d157917d7 | invisible_to_admin |
| 3943a53dc92a49b2827fae94363851e1 | service |
| 80cab5e1f02045abad92a2864cfd76cb | test_project |
+----------------------------------+--------------------+
Créer un projet “new-project” avec openstack project create
:
openstack project create --description 'mon nouveau projet' new-project --domain default
+-------------+----------------------------------+
| Field | Value |
+-------------+----------------------------------+
| description | mon nouveau projet |
| domain_id | e601210181f54843b51b3edff41d4980 |
| enabled | True |
| id | 1a4a0618b306462c9830f876b0bd6af2 |
| is_domain | False |
| name | new-project |
| parent_id | e601210181f54843b51b3edff41d4980 |
+-------------+----------------------------------+
Spécifiez l’ID de projet pour mettre à jour un projet. Vous pouvez mettre à jour le nom, la description et l’état d’activation d’un projet avec openstack project set
:
openstack project set PROJECT_ID --disable
openstack project set PROJECT_ID --enable
openstack project set PROJECT_ID --name project-new
Pour lister les informations ou voir les changements effectués avec openstack project show
:
openstack project show PROJECT_ID
+-------------+----------------------------------+
| Field | Value |
+-------------+----------------------------------+
| description | mon nouveau projet |
| enabled | True |
| id | 0b0b995694234521bf93c792ed44247f |
| name | new-project |
| properties | |
+-------------+----------------------------------+
Il faut utiliser l’ID avec la commande openstack project delete
:
openstack project delete PROJECT_ID
La commande pour lister les utilisateurs est simplement : openstack user list
openstack user list
+----------------------------------+----------+
| ID | Name |
+----------------------------------+----------+
| 352b37f5c89144d4ad0534139266d51f | admin |
| 86c0de739bcb4802b8dc786921355813 | demo |
| 32ec34aae8ea432e8af560a1cec0e881 | glance |
| 7047fcb7908e420cb36e13bbd72c972c | nova |
+----------------------------------+----------+
Pour créer un utilisateur, vous devez spécifier un nom avec la commande openstack user create
. Vous pouvez éventuellement spécifier un ID de projet, un mot de passe et une adresse e-mail.
Attention : Il est recommandé d’inclure l’ID de projet et le mot de passe car l’utilisateur ne peut pas se connecter au tableau de bord sans ces informations.
openstack user create --project new-project --password PASSWORD papamica
+------------+----------------------------------+
| Field | Value |
+------------+----------------------------------+
| email | None |
| enabled | True |
| id | 6322872d9c7e445dbbb49c1f9ca28adc |
| name | papamica |
| project_id | 0b0b995694234521bf93c792ed44247f |
| username | papamica |
+------------+----------------------------------+
Modifier un utilisateur
Vous pouvez mettre à jour le nom, l’adresse e-mail et l’état d’activation d’un utilisateur avec openstack user set
:
openstack user set USER_NAME --disable
Remarque : Si vous désactivez un compte utilisateur, l’utilisateur ne peut pas se connecter au tableau de bord. Cependant, les données du compte utilisateur sont conservées, vous pouvez donc réactiver l’utilisateur à tout moment.
openstack user set USER_NAME --enable
openstack user set USER_NAME --name user-new --email new-user@example.com
User has been updated.
Rien de plus compliqué et toujours avec la même logique de commande : openstack user delete
openstack user delete USER_NAME
openstack role list
permet de lister les rôles déjà disponibles :
openstack role list
+----------------------------------+---------------+
| ID | Name |
+----------------------------------+---------------+
| 71ccc37d41c8491c975ae72676db687f | Member |
| 149f50a1fe684bfa88dae76a48d26ef7 | ResellerAdmin |
| 9fe2ff9ee4384b1894a90878d3e92bab | _member_ |
| 6ecf391421604da985db2f141e46a7c8 | admin |
| deb4fffd123c4d02a907c2c74559dccf | anotherrole |
+----------------------------------+---------------+
Les utilisateurs peuvent être membres de plusieurs projets. Pour affecter des utilisateurs à plusieurs projets, définissez un rôle et attribuez ce rôle à des projets.
Pour créer un nouveau rôle “test” avec openstack role create
:
openstack role create test
+-----------+----------------------------------+
| Field | Value |
+-----------+----------------------------------+
| domain_id | None |
| id | a34425c884c74c8881496dc2c2e84ffc |
| name | test |
+-----------+----------------------------------+
Pour affecter un utilisateur à un projet, vous devez attribuer le rôle à une paire utilisateur-projet. Pour ce faire, vous avez besoin des ID d’utilisateur, de rôle et de projet.
Il va donc falloir récupérer les info suivante :
openstack user list
openstack role list
openstack project list
Ajouter le rôle admin à l’utilisateur papamica et son projet new-project avec openstack role add
:
openstack role add --user papamica --project new-project admin
Pour vérifier que le rôle a bien été affecté :
openstack role assignment list --user papamica --project new-project --names
+----------------------------------+-------------+----------------+----------+
| ID | Name | Project | User |
+----------------------------------+-------------+----------------+----------+
| a34425c884c74c8881496dc2c2e84ffc | admin | new-project | papamica |
| 04a7e3192c0745a2b1e3d2baf5a3ee0f | Member | new-project | papamica |
| 62bcf3e27eef4f648eb72d1f9920f6e5 | anotherrole | new-project | papamica |
+----------------------------------+-------------+----------------+----------+
Vous pouvez lister tous les détails d’un rôle spécifique avec openstack role show
:
openstack role show test
+-----------+----------------------------------+
| Field | Value |
+-----------+----------------------------------+
| domain_id | None |
| id | a34425c884c74c8881496dc2c2e84ffc |
| name | test |
+-----------+----------------------------------+
La commande reste openstack role remove
avec l’utilisateur et le projet :
openstack role remove --user papamica --project new-project test
Pour vérifier que le rôle a bien été enlevé, il suffit de lister les rôles de cet utilisateur/projet et constater qu’il n’est plus présent.