Wiki-Tech.io/Openstack/Environnement.html

<!--
title: Configurer son environnement
description: 
published: true
date: 2021-04-30T13:36:26.908Z
tags: 
editor: ckeditor
dateCreated: 2021-04-29T13:23:07.364Z
-->

<h1>Configurer son environnement</h1>
<p>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.</p>
<p>Afin d'éviter de définir ces variables d'environnement manuellement, vous pouvez récupérer le fichier directement depuis le dashboard.</p>
<p>&nbsp;</p>
<h2>Téléchargement depuis le dashboard</h2>
<p>Accédez au tableau de bord OpenStack, connectez-vous et vous pourrez télécharger un fichier openrc comme cela :</p>
<ul>
  <li>Sélectionez "Project" dans le menu de gauche (juste en dessous du logo "openstack")</li>
  <li>Rendez-vous dans l'onglet “API Access”</li>
  <li>Cliquez sur le bouton "Download OpenStack RC File" sur la droitet et cliquez sur “OpenStack RC File”</li>
</ul>
<p>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 :</p>
<p>Avec Bash :</p>
<pre><code class="language-plaintext">. openrc.sh</code></pre>
<p>Avec Zsh :</p>
<pre><code class="language-plaintext">sh . openrc.sh</code></pre>
<p>&nbsp;</p>
<blockquote class="is-info">
  <p><strong>Remarque :</strong> 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é.</p>
</blockquote>
<p>Pour “décharger” ces variables d'environnements, vous pouvez soit fermer votre invite de commande, soit les “décharger” avec cette commande :</p>
<pre><code class="language-plaintext"> unset OS_PASSWORD</code></pre>
<p>&nbsp;</p>
<h2>Gestion des projets</h2>
<p>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.</p>
<h3>Lister les projets</h3>
<p>Lister tous les projets avec leur ID, leur nom et s'ils sont activés ou désactivés avec <code>openstack project list </code>:</p>
<pre><code class="language-plaintext">openstack project list
+----------------------------------+--------------------+
| ID                               | Name               |
+----------------------------------+--------------------+
| f7ac731cc11f40efbc03a9f9e1d1d21f | admin              |
| c150ab41f0d9443f8874e32e725a4cc8 | alt_demo           |
| a9debfe41a6d4d09a677da737b907d5e | demo               |
| 9208739195a34c628c58c95d157917d7 | invisible_to_admin |
| 3943a53dc92a49b2827fae94363851e1 | service            |
| 80cab5e1f02045abad92a2864cfd76cb | test_project       |
+----------------------------------+--------------------+</code></pre>
<h3>Créer un projet</h3>
<p>Créer un projet “new-project” avec <code>openstack project create</code> :</p>
<pre><code class="language-plaintext">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 |
+-------------+----------------------------------+</code></pre>
<h3>Mettre à jour un projet</h3>
<p>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 <code>openstack project set</code> :</p>
<ul>
  <li>Désactiver temporairement un projet :</li>
</ul>
<pre><code class="language-plaintext">openstack project set PROJECT_ID --disable</code></pre>
<p>&nbsp;</p>
<ul>
  <li>Activé un projet désactivé :</li>
</ul>
<pre><code class="language-plaintext">openstack project set PROJECT_ID --enable</code></pre>
<p>&nbsp;</p>
<ul>
  <li>Changer le nom d'un projet :</li>
</ul>
<pre><code class="language-plaintext">openstack project set PROJECT_ID --name project-new</code></pre>
<h3>Voir les informations d'un projet :</h3>
<p>Pour lister les informations ou voir les changements effectués avec <code>openstack project show</code> :</p>
<pre><code class="language-plaintext">openstack project show PROJECT_ID
+-------------+----------------------------------+
| Field       | Value                            |
+-------------+----------------------------------+
| description | mon nouveau projet               |
| enabled     | True                             |
| id          | 0b0b995694234521bf93c792ed44247f |
| name        | new-project                      |
| properties  |                                  |
+-------------+----------------------------------+</code></pre>
<h3>Supprimer un projet</h3>
<p>Il faut utiliser l'ID avec la commande <code>openstack project delete</code> :</p>
<pre><code class="language-plaintext">openstack project delete PROJECT_ID</code></pre>
<p>&nbsp;</p>
<h2>Gestion des utilisateurs</h2>
<h3>Lister les utilisateurs</h3>
<p>La commande pour lister les utilisateurs est simplement : <code>openstack user list</code></p>
<pre><code class="language-plaintext">openstack user list
+----------------------------------+----------+
| ID                               | Name     |
+----------------------------------+----------+
| 352b37f5c89144d4ad0534139266d51f | admin    |
| 86c0de739bcb4802b8dc786921355813 | demo     |
| 32ec34aae8ea432e8af560a1cec0e881 | glance   |
| 7047fcb7908e420cb36e13bbd72c972c | nova     |
+----------------------------------+----------+</code></pre>
<h3>Créer un utilisateur</h3>
<p>Pour créer un utilisateur, vous devez spécifier un nom avec la commande <code>openstack user create</code>. Vous pouvez éventuellement spécifier un ID de projet, un mot de passe et une adresse e-mail.&nbsp;</p>
<blockquote class="is-warning">
  <p><strong>Attention : </strong>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.</p>
</blockquote>
<pre><code class="language-plaintext">openstack user create --project new-project --password PASSWORD papamica
+------------+----------------------------------+
| Field      | Value                            |
+------------+----------------------------------+
| email      | None                             |
| enabled    | True                             |
| id         | 6322872d9c7e445dbbb49c1f9ca28adc |
| name       | papamica                         |
| project_id | 0b0b995694234521bf93c792ed44247f |
| username   | papamica                         |
+------------+----------------------------------+</code></pre>
<p>Modifier un utilisateur</p>
<p>Vous pouvez mettre à jour le nom, l'adresse e-mail et l'état d'activation d'un utilisateur avec<code> openstack user set</code>:</p>
<ul>
  <li>Pour désactiver temporairement un utilisateur :</li>
</ul>
<pre><code class="language-plaintext">openstack user set USER_NAME --disable</code></pre>
<p>&nbsp;</p>
<blockquote class="is-info">
  <p><strong>Remarque : </strong>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.</p>
</blockquote>
<ul>
  <li>Pour réactiver un utilisateur :</li>
</ul>
<pre><code class="language-plaintext">openstack user set USER_NAME --enable</code></pre>
<p>&nbsp;</p>
<ul>
  <li>Pour changer le nom, la description ou encore l'email d'un utilisateur :</li>
</ul>
<pre><code class="language-plaintext">openstack user set USER_NAME --name user-new --email new-user@example.com
User has been updated.</code></pre>
<h3>Supprimer un utilisateur</h3>
<p>Rien de plus compliqué et toujours avec la même logique de commande : <code>openstack user delete</code></p>
<pre><code class="language-plaintext">openstack user delete USER_NAME</code></pre>
<p>&nbsp;</p>
<h2>Gestion des rôles</h2>
<h3>Lister les rôles</h3>
<p><code>openstack role list</code> permet de lister les rôles déjà disponibles :</p>
<pre><code class="language-plaintext">openstack role list
+----------------------------------+---------------+
| ID                               | Name          |
+----------------------------------+---------------+
| 71ccc37d41c8491c975ae72676db687f | Member        |
| 149f50a1fe684bfa88dae76a48d26ef7 | ResellerAdmin |
| 9fe2ff9ee4384b1894a90878d3e92bab | _member_      |
| 6ecf391421604da985db2f141e46a7c8 | admin         |
| deb4fffd123c4d02a907c2c74559dccf | anotherrole   |
+----------------------------------+---------------+</code></pre>
<h3>Créer un rôle</h3>
<blockquote class="is-info">
  <p><strong>Remarque : </strong>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.</p>
</blockquote>
<p>Pour créer un nouveau rôle “test” avec <code>openstack role create</code> :</p>
<pre><code class="language-plaintext">openstack role create test
+-----------+----------------------------------+
| Field     | Value                            |
+-----------+----------------------------------+
| domain_id | None                             |
| id        | a34425c884c74c8881496dc2c2e84ffc |
| name      | test                             |
+-----------+----------------------------------+</code></pre>
<h3>Assigner un rôle</h3>
<blockquote class="is-info">
  <p><strong>Remarque : </strong>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.</p>
</blockquote>
<p>Il va donc falloir récupérer les info suivante :</p>
<ul>
  <li>ID de l'utilisateur : <code>openstack user list</code></li>
  <li>ID du rôles : <code>openstack role list</code></li>
  <li>ID du projet : <code>openstack project list</code></li>
</ul>
<p>Ajouter le rôle <i>admin</i> à l'utilisateur <i>papamica</i> et son projet <i>new-project</i> avec <code>openstack role add</code> :</p>
<pre><code class="language-plaintext">openstack role add --user papamica --project new-project admin</code></pre>
<p>Pour vérifier que le rôle a bien été affecté :</p>
<pre><code class="language-plaintext">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 |
+----------------------------------+-------------+----------------+----------+</code></pre>
<h3>Voir les détails d'un rôle</h3>
<p>Vous pouvez lister tous les détails d'un rôle spécifique avec <code>openstack role show</code> :</p>
<pre><code class="language-plaintext">openstack role show test
+-----------+----------------------------------+
| Field     | Value                            |
+-----------+----------------------------------+
| domain_id | None                             |
| id        | a34425c884c74c8881496dc2c2e84ffc |
| name      | test                             |
+-----------+----------------------------------+</code></pre>
<h3>Enlever un rôle</h3>
<p>La commande reste <code>openstack role remove</code> avec l'utilisateur et le projet :</p>
<pre><code class="language-plaintext">openstack role remove --user papamica --project new-project test</code></pre>
<p>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.</p>