|
| 1 | +# Exercice 1 - Exploration de l'environnement de laboratoire |
| 2 | + |
| 3 | +**Lisez ceci dans d'autres langues** :  [English](README.md),  [日本語](README.ja.md),  [Español](README.es.md),  [Français](README.fr.md). |
| 4 | + |
| 5 | +## Table des matières |
| 6 | + |
| 7 | +- [Exercice 1 - Exploration de l'environnement de laboratoire](#exercice-1---exploration-de-lenvironnement-de-laboratoire) |
| 8 | + - [Table des matières](#table-des-matières) |
| 9 | + - [Objectif](#objectif) |
| 10 | + - [Diagramme](#diagramme) |
| 11 | + - [Guide](#guide) |
| 12 | + - [Étape 1 - Connexion via VS Code](#étape-1---connexion-via-vs-code) |
| 13 | + - [Étape 2 - Utilisation du terminal](#étape-2---utilisation-du-terminal) |
| 14 | + - [Étape 3 - Examen des environnements d'exécution](#étape-3---examen-des-environnements-dexécution) |
| 15 | + - [Étape 4 - Examen de la configuration d'ansible-navigator](#étape-4---examen-de-la-configuration-dansible-navigator) |
| 16 | + - [Étape 5 - Examen de l'inventaire](#étape-5---examen-de-linventaire) |
| 17 | + - [Étape 6 - Compréhension de l'inventaire](#étape-6---compréhension-de-linventaire) |
| 18 | + - [Étape 7 - Utilisation d'ansible-navigator pour explorer l'inventaire](#étape-7---utilisation-dansible-navigator-pour-explorer-linventaire) |
| 19 | + - [Étape 8 - Connexion aux périphériques réseau](#étape-8---connexion-aux-périphériques-réseau) |
| 20 | + - [Conclusion](#conclusion) |
| 21 | + |
| 22 | +## Objectif |
| 23 | + |
| 24 | +Explorer et comprendre l'environnement de laboratoire. |
| 25 | + |
| 26 | +Les premiers exercices de ce laboratoire permettront d'explorer les utilitaires en ligne de commande de la plateforme d'automatisation Ansible. Cela inclut : |
| 27 | + |
| 28 | +- [ansible-navigator](https://github.com/ansible/ansible-navigator) - un utilitaire en ligne de commande et une interface utilisateur textuelle (TUI) pour exécuter et développer du contenu d'automatisation Ansible. |
| 29 | +- [ansible-core](https://docs.ansible.com/core.html) - l'exécutable de base qui fournit le cadre, le langage et les fonctions soutenant la plateforme d'automatisation Ansible. Il inclut également divers outils CLI tels que `ansible`, `ansible-playbook` et `ansible-doc`. Ansible Core fait le lien entre la communauté open source et l'offre d'automatisation d'entreprise de Red Hat. |
| 30 | +- [Environnements d'exécution](https://docs.ansible.com/automation-controller/latest/html/userguide/execution_environments.html) - non spécifiquement couverts dans cet atelier car les environnements intégrés incluent déjà toutes les collections prises en charge par Red Hat utilisées ici. Les environnements d'exécution sont des images de conteneurs utilisées pour exécuter Ansible. |
| 31 | +- [ansible-builder](https://github.com/ansible/ansible-builder) - également non couvert ici, c'est un utilitaire CLI pour automatiser la création d'environnements d'exécution. |
| 32 | + |
| 33 | +Pour plus d'informations sur les nouveaux composants de la plateforme d'automatisation Ansible, vous pouvez consulter cette page [https://red.ht/AAP-20](https://red.ht/AAP-20). |
| 34 | + |
| 35 | +> Rejoignez notre forum communautaire ! |
| 36 | +> |
| 37 | +> Avant de commencer, rejoignez-nous sur <a target="_new" href="https://forum.ansible.com/">https://forum.ansible.com/</a>. Cela vous permettra d'obtenir de l'aide après les ateliers. |
| 38 | +
|
| 39 | +## Diagramme |
| 40 | + |
| 41 | + |
| 42 | + |
| 43 | +## Guide |
| 44 | + |
| 45 | +### Étape 1 - Connexion via VS Code |
| 46 | + |
| 47 | +<table> |
| 48 | +<thead> |
| 49 | + <tr> |
| 50 | + <th>Il est fortement recommandé d'utiliser Visual Studio Code pour réaliser les exercices de l'atelier. Visual Studio Code offre : |
| 51 | + <ul> |
| 52 | + <li>Un explorateur de fichiers</li> |
| 53 | + <li>Un éditeur de texte avec mise en surbrillance de la syntaxe</li> |
| 54 | + <li>Un terminal intégré</li> |
| 55 | + </ul> |
| 56 | + Un accès SSH direct est disponible en solution de secours, ou si Visual Studio Code ne convient pas. Une courte vidéo YouTube est disponible pour plus de clarté : <a href="https://youtu.be/Y_Gx4ZBfcuk">Ansible Workshops - Accéder à votre environnement de travail</a>. |
| 57 | +</th> |
| 58 | + </tr> |
| 59 | +</thead> |
| 60 | +</table> |
| 61 | + |
| 62 | +- Connectez-vous à Visual Studio Code depuis la page de lancement de l'atelier (fournie par votre instructeur). Le mot de passe est indiqué sous le lien WebUI. |
| 63 | + |
| 64 | +  |
| 65 | + |
| 66 | +- Entrez le mot de passe fourni pour vous connecter. |
| 67 | + |
| 68 | +  |
| 69 | + |
| 70 | +- Ouvrez le répertoire `network-workshop` dans Visual Studio Code : |
| 71 | + |
| 72 | +  |
| 73 | + |
| 74 | +- Cliquez sur `playbook.yml` pour voir le contenu. |
| 75 | + |
| 76 | +  |
| 77 | + |
| 78 | +### Étape 2 - Utilisation du terminal |
| 79 | + |
| 80 | +- Ouvrez un terminal dans Visual Studio Code : |
| 81 | + |
| 82 | +  |
| 83 | + |
| 84 | +Naviguez jusqu'au répertoire `network-workshop` sur le terminal du noeud de contrôle Ansible. |
| 85 | + |
| 86 | +```bash |
| 87 | +[student@ansible-1 ~]$ cd ~/network-workshop/ |
| 88 | +[student@ansible-1 network-workshop]$ pwd |
| 89 | +/home/student/network-workshop |
| 90 | +[student@ansible-1 network-workshop]$ |
| 91 | +``` |
| 92 | + |
| 93 | +* `~` - le tilde dans ce contexte est un raccourci pour le répertoire personnel, c'est-à-dire `/home/student` |
| 94 | +* `cd` - commande Linux pour changer de répertoire |
| 95 | +* `pwd` - commande Linux pour afficher le répertoire de travail actuel |
| 96 | + |
| 97 | +### Étape 3 - Examen des environnements d'exécution |
| 98 | + |
| 99 | +Exécutez la commande `ansible-navigator` avec l'argument `images` pour examiner les environnements d'exécution configurés sur le noeud de contrôle : |
| 100 | + |
| 101 | +```bash |
| 102 | +$ ansible-navigator images |
| 103 | +``` |
| 104 | + |
| 105 | + |
| 106 | + |
| 107 | +> Note |
| 108 | +> |
| 109 | +> La sortie que vous voyez peut différer de celle ci-dessus. |
| 110 | +
|
| 111 | +Cette commande vous donne des informations sur tous les environnements d'exécution actuellement installés (ou EEs pour "Execution Environments"). Examinez un EE en appuyant sur le numéro correspondant. Par exemple, en appuyant sur **0** dans l'exemple ci-dessus, vous ouvrirez l'environnement d'exécution `network-ee` : |
| 112 | + |
| 113 | + |
| 114 | + |
| 115 | +La sélection de `2` pour `Version et collections Ansible` affichera toutes les collections Ansible installées sur cet EE particulier, ainsi que la version de `ansible-core` : |
| 116 | + |
| 117 | + |
| 118 | + |
| 119 | +### Étape 4 - Examen de la configuration d'ansible-navigator |
| 120 | + |
| 121 | +Utilisez Visual Studio Code pour ouvrir ou utilisez la commande `cat` pour afficher le contenu du fichier `ansible-navigator.yml`. Le fichier est situé dans le répertoire personnel : |
| 122 | + |
| 123 | +```bash |
| 124 | +$ cat ~/.ansible-navigator.yml |
| 125 | +--- |
| 126 | +ansible-navigator: |
| 127 | + ansible: |
| 128 | + inventory: |
| 129 | + entries: |
| 130 | + - /home/student/lab_inventory/hosts |
| 131 | + |
| 132 | + execution-environment: |
| 133 | + image: quay.io/acme_corp/network-ee:latest |
| 134 | + enabled: true |
| 135 | + container-engine: podman |
| 136 | + pull: |
| 137 | + policy: missing |
| 138 | + volume-mounts: |
| 139 | + - src: "/etc/ansible/" |
| 140 | + dest: "/etc/ansible/" |
| 141 | +``` |
| 142 | + |
| 143 | +Notez les paramètres suivants dans le fichier `ansible-navigator.yml` : |
| 144 | + |
| 145 | +* `inventories` : montre l'emplacement de l'inventaire Ansible utilisé |
| 146 | +* `execution-environment` : où l'environnement d'exécution par défaut est défini |
| 147 | + |
| 148 | +Pour une liste complète de toutes les options configurables, consultez la [documentation](https://ansible-navigator.readthedocs.io/en/latest/settings/). |
| 149 | + |
| 150 | +### Étape 5 - Examen de l'inventaire |
| 151 | + |
| 152 | +La portée d'un `play` dans un `playbook` est limitée aux groupes d'hôtes déclarés dans un **inventaire** Ansible. Ansible prend en charge plusieurs [types d'inventaire](http://docs.ansible.com/ansible/latest/intro_inventory.html). Un inventaire peut être un simple fichier plat contenant une collection d'hôtes ou un script dynamique (interrogeant potentiellement une base de données CMDB) générant une liste de dispositifs pour exécuter le playbook. |
| 153 | + |
| 154 | +Dans ce laboratoire, vous travaillerez avec un inventaire basé sur fichier au format **ini**. Utilisez Visual Studio Code pour ouvrir ou utilisez la commande `cat` pour afficher le contenu du fichier `~/lab_inventory/hosts`. |
| 155 | + |
| 156 | +```bash |
| 157 | +$ cat ~/lab_inventory/hosts |
| 158 | +``` |
| 159 | + |
| 160 | +```bash |
| 161 | +[all:vars] |
| 162 | +ansible_ssh_private_key_file=~/.ssh/aws-private.pem |
| 163 | + |
| 164 | +[routers:children] |
| 165 | +cisco |
| 166 | +juniper |
| 167 | +arista |
| 168 | + |
| 169 | +[cisco] |
| 170 | +rtr1 ansible_host=18.222.121.247 private_ip=172.16.129.86 |
| 171 | +[arista] |
| 172 | +rtr2 ansible_host=18.188.194.126 private_ip=172.17.158.197 |
| 173 | +rtr4 ansible_host=18.221.5.35 private_ip=172.17.8.111 |
| 174 | +[juniper] |
| 175 | +rtr3 ansible_host=3.14.132.20 private_ip=172.16.73.175 |
| 176 | + |
| 177 | +[cisco:vars] |
| 178 | +ansible_user=ec2-user |
| 179 | +ansible_network_os=ios |
| 180 | +ansible_connection=network_cli |
| 181 | + |
| 182 | +[juniper:vars] |
| 183 | +ansible_user=ec2-user |
| 184 | +ansible_network_os=junos |
| 185 | +ansible_connection=netconf |
| 186 | + |
| 187 | +[arista:vars] |
| 188 | +ansible_user=ec2-user |
| 189 | +ansible_network_os=eos |
| 190 | +ansible_connection=network_cli |
| 191 | +ansible_become=true |
| 192 | +ansible_become_method=enable |
| 193 | + |
| 194 | +[dc1] |
| 195 | +rtr1 |
| 196 | +rtr3 |
| 197 | + |
| 198 | +[dc2] |
| 199 | +rtr2 |
| 200 | +rtr4 |
| 201 | + |
| 202 | +[control] |
| 203 | +ansible ansible_host=13.58.149.157 ansible_user=student private_ip=172.16.240.184 |
| 204 | +``` |
| 205 | + |
| 206 | +### Étape 6 - Compréhension de l'inventaire |
| 207 | + |
| 208 | +Dans la sortie ci-dessus, chaque `[ ]` définit un groupe. Par exemple, `[dc1]` est un groupe qui contient les hôtes `rtr1` et `rtr3`. Les groupes peuvent également être _imbriqués_. Le groupe `[routers]` est un groupe parent du groupe `[cisco]`. |
| 209 | + |
| 210 | +Les groupes parents sont déclarés à l'aide de la directive `children`. L'imbrication des groupes permet d'attribuer des valeurs plus spécifiques aux variables. |
| 211 | + |
| 212 | +Nous pouvons associer des variables à des groupes et à des hôtes. |
| 213 | + |
| 214 | +> Note : |
| 215 | +> |
| 216 | +> Un groupe appelé **all** existe toujours et contient tous les groupes et hôtes définis dans un inventaire. |
| 217 | +
|
| 218 | +Les variables des hôtes peuvent être définies sur la même ligne que les hôtes eux-mêmes. Par exemple, pour l'hôte `rtr1` : |
| 219 | + |
| 220 | +```sh |
| 221 | +rtr1 ansible_host=18.222.121.247 private_ip=172.16.129.86 |
| 222 | +``` |
| 223 | + |
| 224 | +* `rtr1` - Le nom qu'Ansible utilisera. Cela peut, mais ne doit pas, reposer sur le DNS. |
| 225 | +* `ansible_host` - L'adresse IP qu'Ansible utilisera. Si elle n'est pas configurée, elle utilisera par défaut le DNS. |
| 226 | +* `private_ip` - Cette valeur n'est pas réservée par Ansible, elle sera donc considérée comme une [variable d'hôte](http://docs.ansible.com/ansible/latest/intro_inventory.html#host-variables). Cette variable peut être utilisée par les playbooks ou ignorée. |
| 227 | + |
| 228 | +Les variables de groupe sont déclarées à l'aide de la directive `vars`. Les groupes permettent d'attribuer des variables communes à plusieurs hôtes. Plusieurs variables de groupe peuvent être définies sous la section `[group_name:vars]`. Par exemple, regardez le groupe `cisco` : |
| 229 | + |
| 230 | +```sh |
| 231 | +[cisco:vars] |
| 232 | +ansible_user=ec2-user |
| 233 | +ansible_network_os=ios |
| 234 | +ansible_connection=network_cli |
| 235 | +``` |
| 236 | + |
| 237 | +* `ansible_user` - L'utilisateur qu'Ansible utilisera pour se connecter à cet hôte. Si elle n'est pas configurée, elle utilisera par défaut l'utilisateur avec lequel le playbook est exécuté. |
| 238 | +* `ansible_network_os` - Cette variable est nécessaire lors de l'utilisation du type de connexion `network_cli` dans une définition de play. |
| 239 | +* `ansible_connection` - Cette variable définit le [plugin de connexion](https://docs.ansible.com/ansible/latest/plugins/connection.html) pour ce groupe. Elle peut être configurée avec des valeurs telles que `netconf`, `httpapi` et `network_cli` en fonction des compatibilités de la plateforme réseau. |
| 240 | + |
| 241 | +### Étape 7 - Utilisation d'ansible-navigator pour explorer l'inventaire |
| 242 | + |
| 243 | +Nous pouvons également utiliser l'interface utilisateur textuelle (TUI) `ansible-navigator` pour explorer l'inventaire. |
| 244 | + |
| 245 | +Exécutez la commande `ansible-navigator inventory` pour afficher l'inventaire dans la TUI : |
| 246 | + |
| 247 | + |
| 248 | + |
| 249 | +Appuyer sur **0** ou **1** sur votre clavier ouvrira respectivement les groupes ou les hôtes. |
| 250 | + |
| 251 | + |
| 252 | + |
| 253 | +Appuyez sur la touche **Esc** pour remonter d'un niveau, ou vous pouvez zoomer sur un hôte individuel : |
| 254 | + |
| 255 | + |
| 256 | + |
| 257 | +### Étape 8 - Connexion aux périphériques réseau |
| 258 | + |
| 259 | +Il y a quatre routeurs, nommés rtr1, rtr2, rtr3 et rtr4. Le diagramme réseau est toujours disponible dans la [table des matières de l'atelier d'automatisation réseau](../README.fr.md). Le fichier de configuration SSH (`~/.ssh/config`) est déjà configuré sur le nœud de contrôle. Cela signifie que vous pouvez vous connecter en SSH à n'importe quel routeur depuis le nœud de contrôle sans identifiants supplémentaires : |
| 260 | + |
| 261 | +Par exemple, pour se connecter à rtr1 depuis le nœud de contrôle Ansible, tapez : |
| 262 | + |
| 263 | +```bash |
| 264 | +$ ssh rtr1 |
| 265 | +``` |
| 266 | + |
| 267 | +Par exemple : |
| 268 | +``` |
| 269 | +$ ssh rtr1 |
| 270 | +Warning: Permanently added 'rtr1,35.175.115.246' (RSA) to the list of known hosts. |
| 271 | +``` |
| 272 | + |
| 273 | +et utilisez la commande `show version` pour vérifier la version de Cisco IOS : |
| 274 | + |
| 275 | +``` |
| 276 | +rtr1#show ver |
| 277 | +Cisco IOS XE Software, Version 17.14.01a |
| 278 | +Cisco IOS Software [IOSXE], Virtual XE Software (X86_64_LINUX_IOSD-UNIVERSALK9-M), Version 17.14.1a, RELEASE SOFTWARE (fc1) |
| 279 | +``` |
| 280 | + |
| 281 | +> **Note** |
| 282 | +> |
| 283 | +> Les ateliers ont récemment été mis à niveau vers Red Hat Enterprise Linux 9, qui utilise une [politique cryptographique système plus sécurisée](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/security_hardening/using-the-system-wide-cryptographic-policies_security-hardening). Si vous rencontrez l'erreur `no mutual signature supported` pour un périphérique réseau Cisco, exécutez la commande `sudo update-crypto-policies --set LEGACY`, puis quittez/réouvrez votre terminal pour que la politique prenne effet. Ce problème sera corrigé dans une future version de l'atelier. Veuillez signaler les problèmes sur https://github.com/ansible/workshops |
| 284 | +
|
| 285 | +## Conclusion |
| 286 | + |
| 287 | +Vous avez terminé l'exercice 1 ! |
| 288 | + |
| 289 | +Vous comprenez maintenant : |
| 290 | + |
| 291 | +* Comment se connecter à l'environnement de laboratoire avec Visual Studio Code |
| 292 | +* Comment explorer les **environnements d'exécution** avec `ansible-navigator` |
| 293 | +* Où se trouve la configuration Ansible Navigator (`ansible-navigator.yml`) |
| 294 | +* Où est stocké l'inventaire pour les exercices en ligne de commande |
| 295 | +* Comment utiliser l'interface utilisateur textuelle (TUI) d'ansible-navigator |
| 296 | + |
| 297 | +--- |
| 298 | +[Exercice suivant](../2-first-playbook/README.fr.md) |
| 299 | + |
| 300 | +[Retour à l'atelier d'automatisation réseau Ansible](../README.fr.md) |
| 301 | + |
| 302 | + |
| 303 | + |
0 commit comments