Azure DevOps : déployer sur IIS sur site et valider le retour arrière

Déployez une version sur IIS avec Azure Pipelines, un agent auto-hébergé, une approbation, une sonde HTTPS et un retour arrière vérifiable.

01

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.

02

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.

03

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.

04

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.

YAML
# 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)"
05

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.

PowerShell
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"
}
06

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.

07

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.

08

Documentation officielle