La première victoire : savoir exactement ce qui roule
À 6 h, une tâche planifiée produit le CSV que l’équipe des opérations ouvre au début de son quart. Quelqu’un propose de mettre le script dans Git. La première question est simple : quel fichier est réellement exécuté, par quel compte et avec quels paramètres? Le premier changement utile consiste à identifier et préserver cette version. La tâche continue d’utiliser son chemin actuel pendant l’importation.
Dans cet exemple fictif, Atelier Boréal possède deux copies d’Export-Inventaire.ps1. Seule celle indiquée par la tâche fait foi pour le pilote. Le contrat à préserver : un CSV avec les mêmes colonnes, le même encodage et le même séparateur, au même endroit; un échec doit rester visible dans les journaux et au système de surveillance.
1. Cartographier les dépendances en lecture seule
Sur le serveur qui exécute la tâche, utiliser un compte autorisé à lire sa définition et le fichier. Les commandes ci-dessous ne lancent pas la tâche. Valider le chemin du script à partir de l’action réelle : un exécutable peut appeler un fichier intermédiaire. Les arguments et les identités peuvent être sensibles; conserver la sortie dans le dossier de changement à accès restreint.
Relever le moteur (Windows PowerShell 5.1 ou PowerShell 7), sa version et son architecture, le répertoire de travail, les paramètres, le compte, les modules et leurs versions, les chemins UNC, la configuration et les droits. Recenser aussi les appels provenant d’un service, d’un autre script ou d’un outil de déploiement. Un résultat de tâche à zéro ne prouve pas que le CSV est frais et exploitable; vérifier le fichier et le processus qui le lit.
$task = Get-ScheduledTask -TaskPath '\Operations\' -TaskName 'Export-Inventaire' -ErrorAction Stop
$task.Actions | Select-Object Execute, Arguments, WorkingDirectory
$task.Principal | Select-Object UserId, LogonType, RunLevel
$task | Get-ScheduledTaskInfo | Select-Object LastRunTime, LastTaskResult, NextRunTime
$script = 'C:\Ops\Export-Inventaire.ps1'
Get-FileHash -LiteralPath $script -Algorithm SHA256
Get-AuthenticodeSignature -LiteralPath $script | Select-Object Status
Get-Acl -LiteralPath $script | Select-Object Owner, AccessToString2. Préserver une référence exploitable
Mettre de côté une copie approuvée du script effectivement exécuté, de ses dépendances, de la définition de la tâche, des ACL et de la configuration, dans un emplacement protégé. Noter les empreintes et le statut de signature. L’export de la définition ne permet pas de récupérer un mot de passe de tâche; prévoir la restauration de l’identité séparément. Si deux serveurs exécutent des versions différentes, comparer les copies avant de choisir laquelle servira de référence. Consigner chaque différence qui a un effet métier.
Avant de copier quoi que ce soit dans le dépôt, rechercher secrets, données de production et identifiants sensibles. Si un secret est découvert dans la source, conserver la preuve en lieu sûr, prévoir sa rotation et importer une version assainie en documentant l’écart avec l’empreinte de production. Un dépôt privé et .gitignore ne protègent pas une valeur déjà commise.
3. Importer dans un dépôt privé sans modifier la tâche
Partir d’un clone de travail séparé du dossier exécuté. Pour ce premier import, la ligne « scripts/Export-Inventaire.ps1 -text » dans .gitattributes désactive la conversion de fins de ligne par Git pour ce fichier. Vérifier qu’aucun filtre ou attribut d’encodage n’altère la copie, puis comparer le SHA-256 d’un clone frais avec la copie assainie approuvée. Sous Windows PowerShell 5.1, un script UTF-8 sans BOM qui contient des accents peut être mal lu. Tester l’encodage avant toute normalisation; une modification des octets peut invalider la signature. Traiter la normalisation et la nouvelle signature dans une demande distincte.
Les commandes ci-dessous modifient seulement le clone local. Examiner le diff avant de commettre et publier la branche seulement après cette revue. Dans Azure Repos, réserver le contournement des politiques et protéger main par une demande de tirage, une revue et une validation de build. Prévoir les droits d’accès au dépôt privé et la capacité de jobs de pipeline séparément selon l’offre; Azure DevOps Server et Services n’ont pas les mêmes modalités.
git switch -c import/inventaire
git add -- .gitattributes .gitignore scripts/Export-Inventaire.ps1
git diff --cached --stat
git diff --cached --check
git diff --cached
git commit -m "Import inventory export baseline"4. Valider le contrat avec des entrées fictives
Exécuter ce contrôle de syntaxe depuis le clone avec le même moteur que la tâche. Il analyse le fichier sans l’exécuter. Ajouter ensuite des tests Pester dans une version compatible et fixée : colonnes et ordre du CSV, accents, fichier vide, entrée manquante, accès refusé et comportement du code de sortie. Un mock aide à tester le chemin d’erreur; seul un essai sous une identité et des ACL représentatives valide les accès réels. Ne pas installer de modules de test sur le serveur de production pour ce pilote.
Comparer deux exécutions sur les mêmes entrées fictives, avec des sorties temporaires distinctes. Pour les scripts qui envoient des courriels, créent des billets ou écrivent dans une base, utiliser des destinations de test isolées. Un paramètre WhatIf ne protège que les actions qui le respectent. Ne pas exécuter en parallèle deux tâches qui écrivent au même endroit.
$file = (Resolve-Path -LiteralPath '.\scripts\Export-Inventaire.ps1').Path
$tokens = $null
$parseErrors = $null
[System.Management.Automation.Language.Parser]::ParseFile(
$file, [ref]$tokens, [ref]$parseErrors
) | Out-Null
if ($parseErrors) { throw ($parseErrors -join [Environment]::NewLine) }5. Déployer une version, puis observer un cycle complet
Sur un hôte pilote, construire un artefact depuis un commit approuvé et noter le SHA du commit, l’empreinte du paquet et les dépendances incluses. Signer au besoin et valider la signature sur le paquet final. Le compte de la tâche lit et exécute le script et écrit seulement là où le traitement l’exige; le compte de déploiement gère la livraison. Aucun git pull dans le dossier de production. Conserver le chemin d’appel, les arguments et la configuration hors dépôt.
Avant de remplacer quoi que ce soit, confirmer qu’aucune instance n’est active et que la fenêtre couvre le prochain déclenchement; ne pas tuer un traitement en cours. Conserver le paquet précédent et ses droits, déposer le nouveau dans une zone de préparation, vérifier les empreintes, puis basculer le pilote selon la procédure de l’équipe. Avant promotion, observer au moins un déclenchement normal et vérifier la fraîcheur, le schéma et la lecture du CSV par son consommateur. Une sortie absente, incomplète, en retard ou illisible suffit pour arrêter la promotion.
6. Restaurer l’exécution et corriger la source séparément
Si le pilote échoue, bloquer les nouvelles exécutions du pilote selon la procédure et vérifier si une instance doit terminer. Rétablir le paquet précédent et, s’ils ont changé, ses ACL, sa configuration et sa définition de tâche. Vérifier l’empreinte, la signature attendue et le résultat d’une exécution contrôlée avant de reprendre le calendrier. Si le script a déjà modifié des données ou envoyé un message, traiter ces effets séparément avant toute relance.
Dans Git, proposer un revert par demande de tirage si le commit fautif est déjà partagé. Le revert crée un commit d’annulation et ne réinstalle rien sur le serveur. Le dossier de changement doit relier les deux décisions : quelle version est revenue sur le pilote et quelle correction est entrée dans main. Une revue d’infrastructure peut aider à cartographier les dépendances quand aucun propriétaire ne peut expliquer ce qu’un script alimente.