TP 1 — Mettre votre premier script sous Git

Objectif

À l’issue de ce TP, vous saurez faire seul ce que nous avons fait ensemble en leçon 1.7, plus deux choses nouvelles :

  • utiliser le plateau de montage pour séparer deux changements sans rapport en deux enregistrements distincts ;
  • mener une enquête dans l’historique pour retrouver quand et pourquoi une valeur a été modifiée.

Tout se passe en local. Aucune forge, aucun réseau.


Le contexte

Nordika vous a confié le dossier Scripts du service informatique. Il contient deux scripts et un début de documentation, dans l’état où les a laissés votre prédécesseur : aucun historique, aucune explication.

Votre mission : le mettre sous Git proprement, et le laisser dans un état où un collègue pourra comprendre ce qui s’est passé.


Préparation

Créez le dossier de travail :

# Windows
mkdir C:\Lab\tp1-nordika
cd C:\Lab\tp1-nordika
# Linux
mkdir -p ~/lab/tp1-nordika && cd ~/lab/tp1-nordika

Créez-y les trois fichiers suivants, à l’identique.

# Vérifie l'espace disque disponible sur les serveurs
$serveurs = @("SRV-FIC01", "SRV-APP01")
$seuil = 20

foreach ($serveur in $serveurs) {
    $disques = Get-CimInstance Win32_LogicalDisk -ComputerName $serveur -Filter "DriveType=3"
    foreach ($disque in $disques) {
        $libre = [math]::Round(($disque.FreeSpace / $disque.Size) * 100, 1)
        if ($libre -lt $seuil) {
            Write-Warning "$serveur - $($disque.DeviceID) : $libre % libre"
        }
    }
}
# Supprime les profils utilisateurs inactifs depuis plus de 90 jours
$limite = 90
$cible = "C:\Users"

Get-ChildItem $cible -Directory | ForEach-Object {
    $age = (New-TimeSpan -Start $_.LastWriteTime -End (Get-Date)).Days
    if ($age -gt $limite) {
        Write-Output "A supprimer : $($_.Name) ($age jours)"
    }
}
# Scripts IT - Nordika

Scripts d'administration du service informatique.

Mission 1 — Ouvrir le registre

Transformez ce dossier en dépôt Git, puis vérifiez son état.

Vous devez obtenir une liste de trois fichiers non suivis.

💡 Indice

Deux commandes, vues en 1.7 : celle qui crée le dépôt, et celle qui donne l’état.

Mission 2 — Le premier enregistrement

Placez les trois fichiers dans l’historique en un seul enregistrement, avec un message qui décrive correctement l’action.

Contrainte : le message ne doit contenir ni « update », ni « init », ni « premier commit ». Décrivez ce que contient réellement cet enregistrement.

Vérifiez ensuite que votre établi est propre.

💡 Indice

git add accepte plusieurs fichiers, ou un . pour tout prendre. Pour vérifier l’état final, cherchez la mention working tree clean.

Mission 3 — Une modification tracée

Le service comptabilité a signalé des alertes trop tardives. Vous devez abaisser le seuil de Check-Espace.ps1 de 20 à 15.

Avant d’enregistrer, affichez le changement pour vérifier que vous n’avez modifié que ce que vous croyez.

Puis enregistrez avec un message qui explique pourquoi, pas seulement quoi.

💡 Indice

La commande qui affiche les changements non encore posés sur le plateau commence par git di….

Exemple de message acceptable : Seuil d'alerte abaissé à 15% suite aux alertes tardives signalées par la compta.

Mission 4 — Le cœur du TP : deux changements, deux enregistrements

C’est la mission la plus importante. Prenez le temps.

Vous devez faire deux modifications sans aucun rapport entre elles :

  1. Dans Check-Espace.ps1, ajoutez le serveur SRV-BDD01 à la liste.
  2. Dans README.md, ajoutez une ligne décrivant à quoi sert chaque script.

Faites les deux modifications d’abord, avant de toucher à Git.

Puis produisez deux enregistrements distincts, chacun ne contenant qu’un seul des deux changements :

  • un enregistrement qui ne concerne que le script ;
  • un enregistrement qui ne concerne que la documentation.

Contrainte : interdiction d’utiliser git add . ou git commit -a.

💡 Indice

C’est exactement l’usage du plateau de montage. Posez un seul fichier dessus, enregistrez, puis recommencez avec l’autre.

Entre les deux, git status vous montrera qu’il reste un fichier modifié non enregistré. C’est normal et c’est le but.

🔎 Comment vérifier que c’est réussi

git log --oneline doit afficher quatre enregistrements.

Et surtout : git show sur chacun des deux derniers ne doit montrer qu’un seul fichier modifié. Si l’un des deux en montre deux, les changements ont été mélangés — recommencez.

Mission 5 — L’enquête

C’est le scénario du lundi matin de la leçon 1.3, en miniature.

Un collègue vous demande : « Le seuil d’alerte était bien à 20 avant, non ? Qui l’a changé, quand, et pourquoi ? »

Répondez en utilisant uniquement Git — sans rouvrir vos anciennes versions à la main.

Vous devez pouvoir donner :

  1. La date et l’heure du changement
  2. Son auteur
  3. Le motif
  4. Les lignes exactes qui ont été modifiées

💡 Indice

git log --oneline pour repérer l’enregistrement concerné, puis git show <empreinte> pour en voir le détail complet — métadonnées et diff.

Les sept premiers caractères de l’empreinte suffisent.

Mission 6 — Comparer deux états éloignés

Affichez tout ce qui a changé dans Check-Espace.ps1 depuis le tout premier enregistrement, en une seule commande.

💡 Indice

git diff accepte deux points de comparaison. Vous pouvez lui donner deux empreintes :

git diff <empreinte_du_premier> <empreinte_du_dernier> -- Check-Espace.ps1

Il existe aussi une notation relative : HEAD~3 désigne « trois enregistrements avant le dernier ».

🎁 Bonus (facultatif)

Bonus 1 — Affichez l’historique sous forme de graphe compact, avec l’alias configuré en leçon 1.6.

Bonus 2 — Retrouvez tous les enregistrements dont le message contient le mot « seuil ».

💡 Indice

git log --grep="seuil"

Bonus 3 — Affichez l’historique d’un seul fichier, avec le détail des changements à chaque étape.

💡 Indice

git log -p -- Check-Espace.ps1

Corrigé

Voir la solutionMasquer la solution

Mission 1

git init
git status

Mission 2

git add .
git commit -m "Ajout des scripts de contrôle d'espace disque et de purge des profils"
git status    # doit afficher : working tree clean

Mission 3

# après avoir modifié $seuil = 15
git diff
git add Check-Espace.ps1
git commit -m "Seuil d'alerte abaissé à 15% suite aux alertes tardives signalées par la compta"

Mission 4

# après avoir modifié LES DEUX fichiers

git add Check-Espace.ps1
git commit -m "Ajout de SRV-BDD01 à la surveillance d'espace disque"

git add README.md
git commit -m "Documentation du rôle de chaque script"

Vérification :

git log --oneline          # 4 enregistrements
git show HEAD              # 1 seul fichier : README.md
git show HEAD~1            # 1 seul fichier : Check-Espace.ps1

Mission 5

git log --oneline
# repérer l'enregistrement du seuil, par exemple a7f2b18

git show a7f2b18

La sortie donne l’auteur, la date, le message (le motif) et le diff (les lignes exactes).

Mission 6

git diff HEAD~3 HEAD -- Check-Espace.ps1

Ou avec les empreintes complètes du premier et du dernier enregistrement.

Bonus

git lg
git log --grep="seuil"
git log -p -- Check-Espace.ps1

Ce que vous devez avoir à la fin

  • Un dépôt contenant quatre enregistrements
  • Aucun enregistrement mélangeant script et documentation
  • Des messages qui décrivent l’action et, quand c’est utile, l’intention
  • Un établi propre (working tree clean)
  • La capacité de répondre en moins d’une minute à « qui a changé ce seuil, quand, et pourquoi ? »

Ce que ce TP vous a réellement appris

La mission 4 est celle qui compte, et c’est aussi celle qui semble la plus artificielle. Pourquoi s’imposer deux enregistrements quand un seul aurait suffi ?

Parce que le jour où il faudra annuler l’ajout de SRV-BDD01 sans perdre la documentation, la séparation vous sauvera. Et parce qu’un historique où chaque enregistrement traite d’un seul sujet se lit ; un historique où tout est mélangé ne se lit pas.

C’est une discipline, pas une contrainte technique. Elle prend dix secondes de plus au moment de l’enregistrement, et elle fait toute la différence six mois plus tard.

Conservez ce dépôt : nous le publierons sur votre forge en section 3.