Déployer sur Azure App Service à l’aide d’Azure Pipelines

Définissez un pipeline en créant un fichier YAML azure-pipelines.yml dans votre référentiel de code.

1. Dans le menu de navigation de gauche de votre projet Azure DevOps, sélectionnez Pipelines.
2. Dans la page Pipelines, sélectionnez Nouveau pipeline, ou Créer un pipeline si ce pipeline est le premier du projet.
3. Dans l’écran Où se trouve votre code, sélectionnez l’emplacement de votre code source, Azure Repos Git ou GitHub. Si nécessaire, connectez-vous à GitHub.
4. Dans l’écran Sélectionner un référentiel, sélectionnez votre référentiel de code.
5. Dans l’écran Configurer votre pipeline, sélectionnez Pipeline de démarrage.

Ajoutez la tâche .NET Core (DotNetCoreCLI@2) au pipeline, puis générez et publiez votre application.

1. Dans l’écran Vérifier votre YAML de pipeline, supprimez tout le code après la ligne steps:.
2. Sélectionnez la fin du fichier, puis sélectionnez Afficher l’Assistant à droite.
3. Sous Tâches, sélectionnez .NET Core.
4. Dans l’écran de configuration .NET Core, sous Connexion Azure Resource Manager, sélectionnez votre abonnement Azure, puis sélectionnez Autoriser pour créer la connexion de service requise.
5. Sous Commande, sélectionnez Publier.
6. Vérifiez que les cases à cocher Publier des projets web et Projets zip publiés sont cochées, puis sélectionnez Ajouter.
7. La tâche s’affiche dans votre pipeline YAML. Passez en revue le code YAML pour voir ce qu’il fait. Lorsque vous êtes prêt, sélectionnez Enregistrer et exécuter, puis à nouveau Enregistrer et exécuter.
8. Dans l’écran Résumé de la build, sous Travaux, sélectionnez le lien Autorisation nécessaire. Dans l’écran Vérifications, sélectionnez Autoriser, puis à nouveau Autoriser. L’octroi de l’autorisation ici autorise l’utilisation de la connexion de service que vous avez autorisée pour toutes les exécutions de ce pipeline.

1. Dans le menu de navigation de gauche de votre projet Azure DevOps, sélectionnez Pipelines.
2. Dans la page Pipelines, sélectionnez Nouveau pipeline, ou Créer un pipeline si ce pipeline est le premier du projet.
3. Dans l’écran Où se trouve votre code, sélectionnez Utiliser l’éditeur classique pour créer un pipeline sans YAML.
4. Dans l’écran Sélectionner un référentiel, sélectionnez l’emplacement de votre code source, Azure Repos Git ou GitHub, puis sélectionnez votre référentiel de code et votre branche par défaut. Sélectionnez Continuer.
5. Dans l’écran Choisir un modèle , sélectionnez ASP.NET Core, puis Appliquer.
6. Dans le nouvel écran de pipeline, sous Spécification de l’agent à droite, sélectionnez une spécification d’agent telle que ubuntu-latest ou windows-latest en fonction de votre plateforme d’application et de votre version.
7. Examinez le pipeline pour voir ce qu’il fait. Lorsque vous êtes prêt, sélectionnez Enregistrer et mettre en file d’attente.
8. Sélectionnez à nouveau Enregistrer et mettre en file d’attente puis, dans l’écran Exécuter le pipeline , sélectionnez Enregistrer et exécuter.

1. Dans l’écran Résumé de l’exécution du pipeline, sélectionnez l’icône Autres actions en haut à droite, puis sélectionnez Modifier le pipeline.
2. Sélectionnez la fin du fichier YAML, puis sélectionnez Afficher l’Assistant si la liste Tâches n’est pas visible.
3. Dans la liste Tâches , recherchez et sélectionnez la tâche Azure Web App. Vous pouvez également utiliser la tâche de déploiement Azure App Service.
4. Dans l’écran de configuration d’Azure Web App, sous Abonnement Azure, sélectionnez la même connexion de service que celle que vous avez configurée pour l’étape précédente. Vous n’avez pas besoin de réautoriser cette connexion.
5. Pour Type d’application, sélectionnez Azure Web App sur Linux ou Azure Web App sur Windows, en fonction de votre code.
6. Pour Nom de l’application, sélectionnez ou entrez le nom de votre application App Service.
7. Sélectionnez Ajouter.
8. Sélectionnez Valider et enregistrer, puis Enregistrer.
9. Sélectionnez Exécuter, puis à nouveau Exécuter.

Le pipeline YAML complet doit ressembler au code suivant :

trigger:
- <branch-specification>

pool:
  vmImage: <agent-specification>

steps:
- task: DotNetCoreCLI@2
  inputs:
    azureSubscription: '<your-authorized-service-connection>'
    command: 'publish'
    publishWebProjects: true

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<your-authorized-service-connection>'
    appType: 'webApp'
    appName: '<your-app-name>'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'
    deploymentMethod: 'auto'  

• azureSubscription: nom de la connexion de service autorisée à votre abonnement Azure.
• appName: nom de votre application existante.
• package : chemin d’accès au package ou au dossier contenant votre contenu App Service. Les caractères génériques sont pris en charge.

Pour les pipelines classiques, il est plus simple de définir les phases de génération et de mise en production dans des pipelines distincts.

1. Dans le menu de navigation de gauche de votre projet, sélectionnez Pipelines>Mise en production, puis sélectionnez Nouveau pipeline pour créer un pipeline de mise en production.

2. Sous Sélectionner un modèle, sélectionnez le modèle Déploiement Azure App Service , puis sélectionnez Appliquer. Ce modèle ajoute automatiquement les tâches nécessaires.

   Remarque

   Si vous déployez une application Node.js sur App Service sur Windows, sélectionnez le modèle Déployer une application Node.js sur Azure App Service. Ce modèle configure la tâche pour générer un fichier web.config contenant un paramètre qui démarre le service iisnode.

3. Dans la page Nouveau pipeline de mise en production, sélectionnez l’onglet Tâches, sélectionnez Étape 1, puis renseignez les champs suivants sous Paramètres :

   • Abonnement Azure : si vous n’avez pas encore de connexion de service Azure, sélectionnez votre abonnement Azure, puis Autoriser pour créer la connexion de service requise.
   • Type d’application : sélectionnez Azure Web App sur Linux ou Azure Web App sur Windows en fonction de votre code et de votre spécification de l’agent.
   • Nom de l’App Service : sélectionnez votre application App Service.

4. Sous l’onglet Pipeline de l’écran Nouveau pipeline de mise en production, en regard d’Artefacts, sélectionnez Ajouter.

5. Dans l’écran Ajouter un artefact, vérifiez que Build est sélectionnée et, sous Source (pipeline de build), sélectionnez le pipeline que vous avez créé dans la section précédente.

6. Sélectionnez Ajouter.

7. Dans la page de pipeline, sélectionnez Enregistrer en haut à droite, puis sélectionnez OK.

8. Pour exécuter le pipeline, dans la page du pipeline, sélectionnez Créer une mise en production, puis Créer.

La tâche Azure Web App se déploie sur l’application racine dans l’application web Azure. Vous pouvez déployer sur une application virtuelle spécifique en utilisant la propriété VirtualApplication de la tâche de déploiement Azure App Service.

- task: AzureRmWebAppDeployment@5
  inputs:
    VirtualApplication: '<name of virtual application>'

VirtualApplication est le nom de l’application virtuelle configurée dans le portail Azure. Pour plus d’informations, consultez Configurer une application App Service dans le portail Azure.

La tâche Azure Web App se déploie sur l’application racine dans l’application web Azure. Pour effectuer un déploiement sur une application virtuelle spécifique, entrez son nom dans la propriété Application virtuelle de la tâche de déploiement Azure App Service.

L’exemple suivant montre comment effectuer un déploiement vers un emplacement de préproduction, puis dans un emplacement de production :

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<service-connection-name>'
    appType: webAppLinux
    appName: '<app-name>'
    deployToSlotOrASE: true
    resourceGroupName: '<name of resource group>'
    slotName: staging
    package: '$(Build.ArtifactStagingDirectory)/**/*.zip'

- task: AzureAppServiceManage@0
  inputs:
    azureSubscription: '<service-connection-name>'
    WebAppName: '<app-name>'
    ResourceGroupName: '<name of resource group>'
    SourceSlot: staging
    SwapWithProduction: true

• azureSubscription : votre connexion de service Azure.
• appType : type d’application facultatif, tel que webAppLinux pour déployer une application web sur Linux.
• appName : nom de votre application existante.
• deployToSlotOrASE:Booléen. Indique s’il faut déployer sur un emplacement de déploiement existant ou un environnement App Service.
• resourceGroupName : nom du groupe de ressources sur lequel effectuer le déploiement ; obligatoire si deployToSlotOrASE est true.
• slotName : nom de l’emplacement sur lequel effectuer le déploiement ; obligatoire si deployToSlotOrASE est true. La valeur par défaut est production.
• package : chemin d’accès au package ou au dossier contenant le contenu de votre application. Les caractères génériques sont pris en charge.
• SourceSlot : Emplacement envoyé à la production lorsque SwapWithProduction est vrai.
• SwapWithProduction:Booléen. Indique s’il faut échanger le trafic de l’emplacement source avec la production.

Utilisez l’option Déployer sur l’emplacement ou l’environnement App Service dans la tâche Azure Web App pour spécifier l’emplacement vers lequel effectuer le déploiement. Pour échanger les emplacements, utilisez la tâche de gestion Azure App Service.

Vous pouvez utiliser des travaux dans votre fichier YAML pour configurer un pipeline de déploiements. En utilisant des travaux, vous pouvez contrôler l’ordre de déploiement sur plusieurs applications web.

jobs:
- job: buildandtest
  pool:
    vmImage: ubuntu-latest
 
  steps:
  # publish an artifact called drop
  - task: PublishPipelineArtifact@1
    inputs:
      targetPath: '$(Build.ArtifactStagingDirectory)' 
      artifactName: drop
  
  # deploy to Azure Web App staging
  - task: AzureWebApp@1
    inputs:
      azureSubscription: '<service-connection-name>'
      appType: <app type>
      appName: '<staging-app-name>'
      deployToSlotOrASE: true
      resourceGroupName: <group-name>
      slotName: 'staging'
      package: '$(Build.ArtifactStagingDirectory)/**/*.zip'

- job: deploy
  dependsOn: buildandtest
  condition: succeeded()

  pool: 
    vmImage: ubuntu-latest
  
  steps:
    # download the artifact drop from the previous job
  - task: DownloadPipelineArtifact@2
    inputs:
      source: 'current'
      artifact: 'drop'
      path: '$(Pipeline.Workspace)'

  - task: AzureWebApp@1
    inputs:
      azureSubscription: '<service-connection-name>'
      appType: <app type>
      appName: '<production-app-name>'
      resourceGroupName: <group-name>
      package: '$(Pipeline.Workspace)/**/*.zip'

Pour effectuer un déploiement sur plusieurs applications web, ajoutez des étapes à votre pipeline de mise en production. Vous pouvez contrôler l’ordre du déploiement. Pour plus d’informations, consultez Phases.

Pour effectuer un déploiement conditionnel dans YAML, utilisez l’une des techniques suivantes :

• Ajouter une condition à l’étape.
• Isoler les étapes de déploiement dans un travail distinct et ajouter une condition à celui-ci.

L’exemple suivant montre comment utiliser des conditions d’étape pour déployer uniquement les builds réussies provenant de la branche principale :

- task: AzureWebApp@1
  condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
  inputs:
    azureSubscription: '<service-connection-name>'
    appName: '<app-name>'

Pour plus d’informations sur les conditions, consultez Spécifier des conditions.

Dans votre pipeline de mise en production, vous pouvez implémenter diverses vérifications et conditions pour contrôler le déploiement :

• Définissez des filtres de branche pour configurer le déclencheur de déploiement continu sur l’artefact du pipeline de publication.
• Définissez les approbations de prédéploiement ou configurez des portes comme condition préalable pour le déploiement à une étape.
• Spécifiez des conditions d’exécution d’une tâche.

Pour plus d’informations, consultez les articles suivants :

• Déclencheurs de mise en production classiques
• Contrôle de déploiement à l’aide d’approbations
• Concepts des portes de déploiement

trigger:
- main

pool:
  vmImage: windows-latest

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
    arguments: '--configuration $(buildConfiguration)'
    zipAfterPublish: true

- task: AzureRmWebAppDeployment@5
  inputs:
    ConnectionType: 'AzureRM'
    azureSubscription: '<service-connection-name>'
    appType: 'webApp'
    WebAppName: '<app-name>'
    packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'
    enableCustomDeployment: true
    DeploymentType: 'webDeploy'

Si vous utilisez le modèle de déploiement Azure App Service dans un pipeline de mise en production, procédez comme suit pour effectuer le déploiement sur Web Deploy.

1. Sélectionnez l’onglet Tâches, puis Déployer Azure App Service, la tâche de déploiement Azure App Service.
2. Dans l’écran de configuration, vérifiez que le Type de connexion est défini sur Azure Resource Manager.
3. Développez Options de déploiement supplémentaires et choisissez Sélectionner la méthode de déploiement. Assurez-vous que Web Deploy est sélectionné comme méthode de déploiement.
4. Enregistrez le pipeline de mise en production.