Un déploiement complet sur un seul serveur pilote
Le scénario fictif Atelier Boréal déploie une page statique sur IIS. Le pipeline construit une seule fois, publie un artefact, attend une approbation, puis vérifie que le serveur retourne précisément la nouvelle version. La page statique garde l’exemple reproductible : une application réelle exige aussi un test de dépendances et une transaction métier. Cet exemple cible Azure DevOps Services, même si IIS est sur site.
1. Préparer le périmètre avant de connecter l’agent
Utiliser un serveur IIS pilote dédié, une version prise en charge de Windows Server, PowerShell 7 et un agent Windows pris en charge. Préparer un site HTTPS avec certificat approuvé pour iis-pilot.atelier.example et une page index.html existante. Dans le laboratoire, remplacer le nom fictif par un nom résolu qui pointe directement vers le pilote, sans cache ou redirection. Précréer D:\Sites\IisDemo et D:\DeployState\IisDemo sur le même volume NTFS; le second dossier reste hors racine Web. Accorder au compte de service de l’agent la modification de ces seuls dossiers; laisser à l’identité IIS les droits de lecture nécessaires. Ne donner à l’agent ni administration du domaine ni accès de production. Vérifier les exigences actuelles de l’agent et la capacité de jobs parallèles pour le pool hébergé et le pool auto-hébergé. Les tâches Pipeline Artifacts de l’exemple sont propres à Services; avec Azure DevOps Server, vérifier les tâches et pools compatibles.
2. Séparer la compilation du déploiement
Le pool Microsoft hébergé prépare l’artefact. Le pool iis-pilot-only comporte uniquement l’agent installé sur le serveur pilote, avec accès HTTPS sortant selon les exigences Microsoft; aucune connexion entrante depuis Azure DevOps n’est nécessaire pour l’agent. Restreindre l’usage du pool et de l’environnement au pipeline autorisé. Protéger main par revue et validation de compilation, réserver les droits de modification des politiques et définir une approbation manuelle et un verrou exclusif sur iis-pilot dans l’interface. Ajouter le contrôle de branche protégée sur la ressource quand disponible. La condition YAML seule ne constitue pas une frontière de sécurité. Ne jamais exécuter une PR non approuvée sur le pool de déploiement.
3. Créer les trois fichiers du dépôt
Placer le YAML à la racine, le script à deploy/Deploy-IisDemo.ps1 et une page sans dépendance dans web/index.html. Contenu minimal : <!doctype html><title>IIS Demo</title><p>__RELEASE__</p>. Le stage Package remplace le marqueur par l’identifiant du build et regroupe la page et le script de ce même commit. Le stage Pilot télécharge uniquement l’artefact de l’exécution courante et ne récupère pas le dépôt. Le déclenchement est manuel; pour les PR, utiliser une validation distincte qui ne déploie pas. Garder les exécutions approuvées selon la politique de rétention pour retrouver les versions déployées.
# Azure DevOps Services. Run manually from protected main.
trigger: none
stages:
- stage: Package
condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
jobs:
- job: BuildDemo
pool:
vmImage: windows-latest
steps:
- checkout: self
persistCredentials: false
- pwsh: |
$page = Get-Content -Raw web/index.html
if (-not $page.Contains('__RELEASE__')) { throw 'Missing release marker' }
$out = New-Item -ItemType Directory -Force '$(Build.ArtifactStagingDirectory)/iis'
$page.Replace('__RELEASE__', 'release-$(Build.BuildId)') |
Set-Content -Encoding utf8 (Join-Path $out.FullName 'index.html')
Copy-Item deploy/Deploy-IisDemo.ps1 $out.FullName
displayName: Package the approved commit
- publish: $(Build.ArtifactStagingDirectory)/iis
artifact: iis-demo
- stage: Pilot
dependsOn: Package
condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
jobs:
- deployment: DeployIisPilot
environment: iis-pilot
pool:
name: iis-pilot-only
workspace:
clean: all
strategy:
runOnce:
deploy:
steps:
- checkout: none
- download: none
- download: current
artifact: iis-demo
- task: PowerShell@2
displayName: Deploy and verify the pilot
inputs:
pwsh: true
targetType: filePath
filePath: $(Pipeline.Workspace)/iis-demo/Deploy-IisDemo.ps1
arguments: -ArtifactPath "$(Pipeline.Workspace)/iis-demo/index.html" -BuildId "$(Build.BuildId)"4. Déployer un fichier et vérifier le résultat HTTPS
Ce script modifie le pilote. Il refuse de démarrer si la réponse HTTPS ne correspond pas au fichier déjà servi, valide le marqueur de l’artefact, puis remplace le fichier en conservant une copie précédente hors de la racine Web. La sonde compare le contenu, sans ignorer les erreurs TLS. En cas d’échec après remplacement, le script remet le fichier précédent et vérifie sa réponse; même si le retour réussit, le pipeline échoue pour empêcher une promotion. Pour un arrêt de l’agent ou un remplacement incomplet, vérifier l’état du fichier, la copie de secours et la réponse avant toute relance manuelle.
param(
[Parameter(Mandatory)] [string] $ArtifactPath,
[Parameter(Mandatory)] [ValidatePattern('^\d+$')] [string] $BuildId
)
$ErrorActionPreference = 'Stop'
# Preconfigured paths on the same NTFS volume. No IIS config changes.
$live = 'D:\Sites\IisDemo\index.html'
$work = 'D:\DeployState\IisDemo'
$uri = 'https://iis-pilot.atelier.example/index.html'
$id = [guid]::NewGuid().ToString('N')
$next = Join-Path $work "$id.next"
$backup = Join-Path $work "$id.previous"
$failed = Join-Path $work "$id.failed"
function Read-Page {
$r = Invoke-WebRequest -Uri $uri -TimeoutSec 10 -MaximumRedirection 0
if ($r.StatusCode -ne 200) { throw "Unexpected HTTP status: $($r.StatusCode)" }
return ([string]$r.Content).Trim()
}
# Refuse deployment if IIS is already unhealthy or serves another copy.
$old = [IO.File]::ReadAllText($live).Trim()
if ((Read-Page) -cne $old) { throw 'Live file does not match the HTTPS response' }
Copy-Item -LiteralPath $ArtifactPath -Destination $next
$new = [IO.File]::ReadAllText($next).Trim()
if (-not $new.Contains("release-$BuildId<")) { throw 'Artifact version mismatch' }
$swapped = $false
try {
[IO.File]::Replace($next, $live, $backup)
$swapped = $true
if ((Read-Page) -cne $new) { throw 'HTTPS response differs from the artifact' }
Write-Host "Release $BuildId verified; previous file: $backup"
} catch {
$cause = $_
if (-not $swapped) {
throw "Replacement did not complete; inspect live and staging files before retrying: $cause"
}
try {
[IO.File]::Replace($backup, $live, $failed)
if ((Read-Page) -cne $old) { throw 'Previous HTTPS response was not restored' }
} catch {
throw "Deployment and rollback verification failed. Stop the rollout. Deploy: $cause; rollback: $_"
}
throw "Deployment failed; previous page restored and verified. Cause: $cause"
}5. Tester une réussite et un échec maîtrisé
Sur un laboratoire jetable, approuver une exécution depuis main. Confirmer que le journal indique la version et que l’URL HTTPS retourne ce marqueur. Pour tester le retour sans changer le réseau ni les certificats, ajouter temporairement un throw juste après $swapped = $true dans la branche main d’un dépôt de laboratoire distinct, avec pipeline, pool, environnement et contrôles réservés au laboratoire. Le résultat attendu est une exécution en échec et le contenu précédent encore servi. Retirer l’injection après le test. Si la validation du retour échoue, arrêter la promotion et utiliser la copie conservée et le journal; ne pas relancer à l’aveugle.
6. Adapter avant de passer à une application réelle
Pour IIS avec plusieurs fichiers, préparer des répertoires de versions et une procédure de bascule adaptée au framework; ce remplacement de fichier ne couvre pas les fichiers verrouillés, les migrations SQL ni les effets externes. Utiliser des sondes de disponibilité et une lecture métier en préproduction, puis promouvoir le même artefact approuvé sans le reconstruire. Pour SQL, valider la compatibilité entre les deux versions applicatives et séparer toute migration irréversible. Définir le seuil d’arrêt, la durée de conservation des versions et la procédure d’urgence avec le responsable du service. Une revue d’infrastructure peut compléter ce pilote.