Skip to content

Commit 530e240

Browse files
rlopez133rlopez133
authored
Merge pull request #2296 from rlopez133/issue1896
Updates Windows Exercise 7 to AAP 2.5
2 parents 67148ba + 065e69f commit 530e240

File tree

6 files changed

+275
-398
lines changed

6 files changed

+275
-398
lines changed

‎exercises/ansible_windows/7-win-patch/README.fr.md‎

Lines changed: 94 additions & 102 deletions
Original file line numberDiff line numberDiff line change
@@ -1,158 +1,150 @@
1-
**Lisez ceci dans d'autres langues**:
2-
<br>![uk](../../../images/uk.png) [English](README.md), ![japan](../../../images/japan.png)[日本語](README.ja.md), ![france](../../../images/fr.png) [Française](README.fr.md).
1+
**Lire ceci dans d'autres langues** :
2+
<br>![uk](../../../images/uk.png) [English](README.md), ![japan](../../../images/japan.png) [日本語](README.ja.md), ![france](../../../images/fr.png) [Français](README.fr.md)
3+
<br>
34

4-
Section 1 - Créer un Playbook
5-
==================================
6-
7-
Le module `win_updates` est utilisé pour rechercher ou installer les mises à jour Windows. Le module utilise le service Windows Update intégré pour fonctionner. Cela signifie que vous aurez toujours besoin d'un système principal comme WSUS ou les serveurs Windows Update en ligne pour télécharger les mises à jour. Si la configuration de Windows Update de votre serveur est définie pour télécharger automatiquement mais ne pas installer, vous pouvez également utiliser le module pour organiser les mises à jour en lui disant de «rechercher» les mises à jour. Nous avons également la possibilité de mettre en liste blanche ou noire les mises à jour. Par exemple, nous pourrions lui dire de n'installer qu'une seule mise à jour de sécurité particulière au lieu de chaque mise à jour disponible.
5+
---
86

9-
Pour commencer, nous allons créer un nouveau playbook. Nous répéterons les étapes que vous avez effectuées dans les exercices précédents.
7+
# Section 1 – Création de votre Playbook
108

9+
Le module `win_updates` est utilisé pour vérifier ou installer des mises à jour Windows. Il utilise le service Windows Update intégré, ce qui signifie que vous devez toujours disposer d’un système en arrière-plan comme WSUS ou les serveurs Microsoft Update.
10+
Si la configuration Windows Update de votre serveur est définie pour télécharger automatiquement sans installer, vous pouvez utiliser ce module pour préparer les mises à jour en utilisant `search`.
11+
Vous pouvez également créer une liste blanche ou noire de mises à jour — par exemple, installer uniquement une mise à jour de sécurité précise au lieu de toutes les mises à jour disponibles.
1112

12-
Étape 1:
13-
--------
13+
Pour commencer, nous allons créer un nouveau playbook, en suivant un processus similaire aux exercices précédents.
1414

15-
Dans Visual Studio Code, nous allons maintenant créer un nouveau répertoire dans votre référentiel git et créer un nouveau fichier playbook.
15+
---
1616

17-
Dans l'Explorer, vous devriez avoir le repertoire où vous avez précédemment créé `iis_basic`.
17+
## Étape 1 – Créer le fichier Playbook
1818

19-
![Student Playbooks](images/7-vscode-existing-folders.png)
19+
Dans Visual Studio Code :
2020

21-
Allez sur la section *WORKSHOP_PROJECT* et cliquez sur le bouton *Nouveau dossier*. Tapez `win_updates` et appuyez sur Entrée.
21+
1. Dans la vue **Explorer**, trouvez votre section *student#* où vous avez précédemment créé `iis_basic`.
22+
2. Survolez le dossier **WORKSHOP_PROJECT** et cliquez sur le bouton **New Folder**. Nommez le dossier `win_updates` et appuyez sur Entrée.
23+
3. Faites un clic droit sur le dossier `win_updates`, sélectionnez **New File**, nommez-le `site.yml`, puis appuyez sur Entrée.
2224

23-
Maintenant, cliquez sur le dossier `win_updates` et cliquez sur le bouton *Nouveau fichier*. Tapez `site.yml` et appuyez sur Entrée.
25+
Vous devriez maintenant avoir un éditeur vide ouvert, prêt à recevoir votre playbook.
2426

25-
Vous devriez maintenant avoir un éditeur ouvert dans le volet droit qui peut être utilisé pour modifier votre playbook.
2627
![Empty site.yml](images/7-create-win_updates.png)
2728

28-
Section 2: Ecrire votre Playbook
29-
================================
29+
---
3030

31-
Modifiez le fichier site.yml et ajoutez une définition et quelques tâches à votre playbook. Cela couvrira un playbook très basique pour l'installation des mises à jour Windows. En règle générale, vous auriez encore plus de tâches pour accomplir l'ensemble du processus de mise à jour. Cela peut impliquer la création de tickets de service, la création d'instantanés (snapshot) ou la désactivation de la surveillance.
31+
# Section 2 – Écrire votre Playbook
3232

33-
<!-- {% raw %} -->
34-
```yaml
33+
Éditez `site.yml` et ajoutez le contenu suivant :
34+
35+
~~~yaml
3536
---
3637
- hosts: windows
37-
name: This is my Windows patching playbook
38+
name: Ceci est mon playbook de mise à jour Windows
3839
tasks:
39-
- name: Install Windows Updates
40+
- name: Installer les mises à jour Windows
4041
win_updates:
4142
category_names: "{{ categories | default(omit) }}"
42-
reboot: '{{ reboot_server | default(true) }}'
43-
```
44-
<!-- {% endraw %} -->
45-
46-
> **Note**
47-
>
48-
> **Que faisons-nous ici ?**
49-
>
50-
> - `win_updates:` Ce module est utilisé pour vérifier ou installer des mises à jour. Nous lui demandons d'installer uniquement les mises à jour de catégories spécifiques à l'aide d'une variable. L'attribut `reboot` redémarrera automatiquement l'hôte distant s'il est requis et continuera à installer les mises à jour après le redémarrage. Nous utiliserons également une variable modifiable via un formulaire pour nous permettre d'empécher le rédemarrage quand c'est nécessaire. Si la valeur reboot_server n'est pas spécifiée, nous définirons l'attribut par defaut à true.
43+
reboot: "{{ reboot_server | default(true) }}"
44+
~~~
5145

46+
> **Remarque**
47+
> - `win_updates` : vérifie ou installe les mises à jour.
48+
> - `category_names` : permet de limiter les mises à jour à certaines catégories via une variable.
49+
> - `reboot` : si `true`, redémarre automatiquement l’hôte distant si nécessaire et poursuit le processus. Contrôlé via une variable de sondage (survey).
5250

53-
Section 3: Enregistrer et valider
54-
=================================
51+
---
5552

56-
Votre playbook est terminé! Mais n'oubliez pas que nous devons encore valider les modifications apportées au SCM.
53+
# Section 3 – Enregistrer et valider
5754

58-
Cliquez sur «Fichier» → «Tout enregistrer» pour enregistrer les fichiers que vous avez écrits
55+
1. Dans VS Code, cliquez sur **File → Save All**.
5956

6057
![site.yml](images/7-win_update-playbook.png)
6158

62-
Cliquez sur l'icône du code source (1), saisissez un message de validation tel que *Ajout d'un playbook de mise à jour Windows* (2), puis cochez la case ci-dessus (3).
59+
2. Cliquez sur l’icône **Source Control** (1), saisissez un message de commit comme *Ajout du playbook Windows update* (2), puis cliquez sur la case de validation (3).
6360

6461
![Commit site.yml](images/7-win_update-commit.png)
6562

66-
Synchronisez-vous avec gitlab en cliquant sur les flèches dans la barre bleue en bas à gauche.
63+
3. Envoyez vos changements vers GitLab en cliquant sur les flèches en bas à gauche dans la barre bleue.
6764

6865
![Push to Gitlab.yml](images/7-push.png)
6966

70-
Cela devrait prendre 5 à 30 secondes pour terminer la validation. La barre bleue devrait s'arrêter de tourner et indiquer 0 problème…
71-
72-
Section 4: Création du modèle de tache
73-
======================================
74-
75-
Maintenant, de retour dans Controller, vous devrez resynchroniser votre projet pour que les nouveaux fichiers s'affichent.
67+
---
7668

77-
Ensuite, nous devons créer un nouveau modèle de tache pour exécuter ce playbook. Allez donc dans *Modèle*, cliquez sur *Ajouter* et sélectionnez "Modèle de tache".
69+
# Section 4 – Créer votre Job Template
7870

79-
Étape 1:
80-
--------
71+
Dans **automation controller** :
8172

82-
Remplissez le formulaire en utilisant les valeurs suivantes
73+
1. Allez dans **Projects**, et resynchronisez votre projet pour que le nouveau playbook apparaisse.
74+
2. Allez dans **Templates**.
75+
3. Cliquez sur **Create template**, puis sélectionnez **Create job template**.
8376

84-
| Clé | Valeur | Note |
85-
|--------------------|----------------------------|------|
86-
| NOM | Windows Updates | |
87-
| DESCRIPTION | | |
88-
| JOB TYPE | Run | |
89-
| INVENTAIRE | Workshop Inventory | |
90-
| PROJET | Ansible Workshop Project | |
91-
| Execution Environnment | windowws workshop environnement | |
92-
| Playbook | `win_updates/site.yml` | |
93-
| CREDENTIAL | Student Account | |
94-
| LIMIT | windows | |
95-
| OPTIONS | [*] ENABLE FACT STORAGE | |
77+
Remplissez le formulaire :
9678

97-
Étape 2:
98-
--------
79+
| Champ | Valeur |
80+
|----------------------|---------------------------------|
81+
| **Name** | Windows Updates |
82+
| **Description** | (optionnel) |
83+
| **Job Type** | Run |
84+
| **Inventory** | Windows Workshop Inventory |
85+
| **Project** | Ansible Workshop Project |
86+
| **Playbook** | `win_updates/site.yml` |
87+
| **Execution Environment** | Default execution environment |
88+
| **Credentials** | Student Account |
89+
| **Limit** | windows |
90+
| **Options** | Enable fact storage |
9991

100-
Cliquez sur ENREGISTRER ![Save](images/at_save.png) puis cliquez sur Survey en haut à droite !
92+
![Create Job Template](images/7-win_update-template.png)
10193

102-
Étape 3:
103-
--------
94+
Cliquez sur **Create job template**.
10495

105-
Cliquez sur Ajouter ou ADD et remplissez le questionnaire avec les valeurs suivantes
96+
---
10697

107-
| Clé | Valeur | Note |
108-
|-------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------|
109-
| PROMPT | Categories | |
110-
| DESCRIPTION | Which Categories to install? | |
111-
| ANSWER VARIABLE NAME | categories | |
112-
| ANSWER TYPE | Multiple Choice (multiple select) | **There's also a *single* selection option** |
113-
| MULTIPLE CHOICE OPTIONS | Application<br>Connectors<br>CriticalUpdates<br>DefinitionUpdates<br>DeveloperKits<br>FeaturePacks Guidance<br>SecurityUpdates<br>ServicePacks<br>Tools<br>UpdateRollups<br>Updates | |
114-
| DEFAULT ANSWER | CriticalUpdates<br>SecurityUpdates | |
115-
| REQUIRED | Selected | |
116-
| | | |
98+
## Ajouter un sondage (Survey)
11799

100+
1. Sur la page du job template **Windows Updates**, cliquez sur l’onglet **Survey** et sélectionnez le bouton **Create survey question**.
101+
2. Remplissez la première question :
118102

119-
Une fois terminé, cliquez sur le bouton save.
120-
Ajoutez une second questionnaire avec ces valeurs :
103+
| Champ | Valeur |
104+
|------------------------|---------------------------------------------------------------------------------------------------------------|
105+
| **Question** | Which categories to install? |
106+
| **Description** | (Optional) |
107+
| **Answer Variable Name** | categories |
108+
| **Answer Type** | Multiple Choice (multiple select) |
109+
| **Multiple Choice Options** | Application<br>Connectors<br>CriticalUpdates<br>DefinitionUpdates<br>DeveloperKits<br>FeaturePacks Guidance<br>SecurityUpdates<br>ServicePacks<br>Tools<br>UpdateRollups<br>Updates |
110+
| **Default option** | CriticalUpdates<br>SecurityUpdates |
111+
| **Options** | Required |
121112

122-
| Clé | Valeur | Note |
123-
|-------------------------|---------------------------------------------------------|------|
124-
| PROMPT | Redémarrer après l'installation? | |
125-
| DESCRIPTION | If the server needs to reboot, then do so after install | |
126-
| ANSWER VARIABLE NAME | `reboot_server` | |
127-
| ANSWER TYPE | Multiple Choice (single select) | |
128-
| MULTIPLE CHOICE OPTIONS | Yes<br>No | |
129-
| DEFAULT ANSWER | Yes | |
130-
| REQUIRED | Selected | |
113+
![Category Survey Form](images/7-category-survey.png)
131114

132-
Cliquez sur Save, n'oubliez pas d'activer le formulaire !
115+
Cliquez sur **Create survey question** pour enregistrer.
133116

117+
3. Ajoutez la deuxième question :
134118

135-
Section 6: lancer votre nouveau playbook
136-
========================================
119+
| Champ | Valeur |
120+
|------------------------|----------------------------------------------------------|
121+
| **Question** | Reboot after install? |
122+
| **Description** | (Optional) |
123+
| **Answer Variable Name** | reboot_server |
124+
| **Answer Type** | Multiple Choice (single select) |
125+
| **Multiple Choice Options** | Yes<br>No |
126+
| **Default option** | Yes |
127+
| **Options** | Required |
137128

138-
Maintenant, exécutons-le et voyons comment il fonctionne.
129+
![Reboot Survey Form](images/7-reboot-survey.png)
139130

140-
Étape 1:
141-
--------
131+
4. Cliquez sur **Create survey question**.
132+
5. Sur la page du job template, activez **Survey Enabled**.
142133

143-
Cliquez sur `Modeles`
134+
---
144135

136+
# Section 5 – Exécuter votre Playbook
145137

146-
Étape 2:
147-
--------
138+
1. Allez dans **Templates** dans l’automation controller.
139+
2. Trouvez le job template **Windows Updates** et cliquez sur le bouton **Launch** (icône de fusée).
140+
3. Lors des invites :
141+
- Sélectionnez les catégories de mise à jour.
142+
- Choisissez **Yes** pour *Reboot after install?*.
143+
- Cliquez sur **Next**, puis **Launch**.
148144

149-
Cliquez sur l'icône de la fusée ![Add](images/at_launch_icon.png) pour éxécuter la tache **Windows Updates**.
145+
Vous serez redirigé vers la page de sortie du job pour suivre l’avancement en temps réel.
150146

151-
Étape 3:
152-
--------
147+
---
153148

154-
Lorsque vous y êtes invité, sélectionnez la catégories de mise à jour. Puis répondez "Oui" à la question **Redémarrer après l'installation?** Et cliquez sur **SUIVANT**.
149+
[Retour à l’atelier Ansible pour Windows](../README.md)
155150

156-
Après le lancement de la tache, vous pouvez voir le résultat de la tache en cours en temps réel.
157-
<br><br>
158-
[Cliquez ici pour revenir à l'atelier Ansible pour Windows](../README.fr.md)

0 commit comments

Comments
 (0)