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

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019

Utilisez Azure Pipelines pour déployer automatiquement votre application web sur Azure App Service à chaque build réussie. Azure Pipelines vous permet de générer, de tester et de déployer avec l’intégration continue et la livraison continue (CI/CD) à l’aide d’Azure DevOps.

Les pipelines YAML sont définis à l’aide d’un fichier YAML dans votre référentiel. Une étape est le plus petit bloc de construction d’un pipeline, et peut être un script ou une tâche (script prédéfini). En savoir plus sur les principaux concepts et composants qui composent un pipeline.

Vous utilisez la tâche Azure Web App (AzureWebApp) pour déployer sur Azure App Service dans votre pipeline. Pour des scénarios plus complexes, comme lorsque vous devez utiliser des paramètres XML dans votre déploiement, vous pouvez utiliser la tâche AzureRmWebAppDeploymentde déploiement Azure App Service.

Configuration requise :

• Compte Azure avec un abonnement actif. Créez un compte gratuitement.
• Une organisation Azure DevOps. Créez-en un gratuitement.
• Possibilité de faire fonctionner des pipelines sur des agents hébergés par Microsoft. Vous pouvez acheter un travail parallèle ou demander un niveau gratuit.
• Application Azure App Service opérationnelle avec le code hébergé sur GitHub ou Azure Repos.
  • .NET : Créez une application web ASP.NET Core dans Azure.
  • ASP.NET : Créez une application web ASP.NET Framework dans Azure.
  • JavaScript : Créez une application web Node.js dans Azure App Service.
  • Java : Créez une application Java dans Azure App Service.
  • Python : Créez une application Python dans Azure App Service.

1. Créer un pipeline pour votre pile

Les exemples de code de cette section supposent que vous déployez une application web ASP.NET. Vous pouvez adapter les instructions pour d’autres infrastructures.

Apprenez-en davantage plus sur la prise en charge de l’écosystème Azure Pipelines.

YAML

1. Connectez-vous à votre organisation Azure DevOps et accédez à votre projet.

2. Accédez aux pipelines et sélectionnez Nouveau pipeline.

3. Lorsque vous y êtes invité, sélectionnez l’emplacement de votre code source : Azure Repos Git ou GitHub.

   Vous serez peut-être redirigé vers GitHub pour vous connecter. Si c’est le cas, entrez vos informations d’identification GitHub.

4. Quand la liste des dépôts s’affiche, sélectionnez votre dépôt.

5. Vous serez peut-être redirigé vers GitHub pour pouvoir installer l’application Azure Pipelines. Si c’est le cas, sélectionnez Approuver et installer.

6. Quand l’onglet Configurer s’affiche, sélectionnez ASP.NET Core.

7. Quand votre nouveau pipeline s’affiche, examinez le code YAML pour voir ce qu’il fait. Lorsque vous êtes prêt, sélectionnez Enregistrer et exécuter.

Classique

Pour commencer :

1. Créez un pipeline, puis sélectionnez le modèle ASP.NET Core. Cette sélection ajoute automatiquement les tâches requises pour générer le code dans l’exemple de référentiel.

2. Pour le voir en action, enregistrez le pipeline et mettez une build en file d'attente.

   Le modèle de pipeline ASP.NET Core publie le fichier ZIP de déploiement en tant qu’artefact Azure pour la tâche de déploiement à l’étape suivante.

2. Ajouter la tâche de déploiement

YAML

1. Sélectionnez la fin du fichier YAML, puis sélectionnez Afficher l’Assistant.

2. Utilisez l’Assistant Tâche pour ajouter la tâche d’application web Azure .

   Vous pouvez également ajouter la tâche Azure App Service de déploiementAzureRmWebAppDeployment.

3. Choisissez votre abonnement Azure. Veillez à sélectionner Autoriser pour autoriser votre connexion. L’autorisation crée la connexion de service requise.

4. Sélectionnez le type d’application, le nom de l’application et la pile d’exécution en fonction de votre application App Service. Votre YAML complet doit ressembler au code suivant.

   variables:
     buildConfiguration: 'Release'
   
   steps:
   - task: DotNetCoreCLI@2
     inputs:
       command: 'publish'
       publishWebProjects: true
   - task: AzureWebApp@1
     inputs:
       azureSubscription: '<service-connection-name>'
       appType: 'webAppLinux'
       appName: '<app-name>'
       package: '$(System.DefaultWorkingDirectory)/**/*.zip'
   

   • 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 à un dossier contenant votre contenu App Service. Les caractères génériques sont pris en charge.

Classique

Pour commencer :

1. Créer un pipeline de publication. Sélectionnez Versions dans le menu de gauche et sélectionnez Nouveau pipeline.

2. Sélectionnez le modèle Déploiement d’Azure App Service pour votre index. Cette étape 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éployé Node.js App sur Azure App Service . La seule différence entre ces modèles est que le modèle Node.js configure la tâche pour générer un web.config fichier qui contient un paramètre qui démarre le iisnode service.

3. Pour lier ce pipeline de déploiement à l’artefact Azure de l’étape précédente, sélectionnez Ajouter un artefact>Build.

4. Dans Source (pipeline de build), sélectionnez le pipeline de build que vous avez créé dans la section précédente. Ensuite, cliquez sur Ajouter.

5. Pour le voir en action, enregistrez le pipeline de publication et créez une publication.

Exemple : déployer une application .NET

YAML

Pour déployer un package web .zip (par exemple, à partir d’une application web ASP.NET) vers une application web Azure, utilisez l’extrait de code suivant pour déployer la build sur une application.

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
- task: AzureWebApp@1
  inputs:
    azureSubscription: '<service-connection-name>'
    appType: 'webAppLinux'
    appName: '<app-name>'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'

• azureSubscription: Votre abonnement Azure.
• appType: type d’application web.
• appName: nom de votre service d’application existant.
• package: chemin d’accès au package ou à un dossier contenant votre contenu App Service. Les caractères génériques sont pris en charge.

Classique

Pour les pipelines classiques, il est plus facile de définir respectivement les étapes de compilation et de publication dans des volets distincts (Pipelines et Releases).

• Dans le volet Pipelines , générez et testez votre application à l’aide du modèle de votre choix, tel que ASP.NET Core, Node.js avec Grunt, Maven ou d’autres. Publiez un artefact.
• Dans le volet Version, utilisez le modèle de déploiement Azure App Service générique pour déployer l’artefact.

Il peut y avoir des modèles pour des langages de programmation spécifiques parmi lesquels choisir.

Exemple : Déployer sur une application virtuelle

YAML

Par défaut, votre déploiement se produit à 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 AzureRmWebAppDeployment :

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

• VirtualApplication: 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.

Classique

Par défaut, votre déploiement se produit à l’application racine dans l’application web Azure. Si vous souhaitez déployer sur une application virtuelle spécifique, entrez le nom de celle-ci dans la propriété Application virtuelle de la tâche de déploiement d’Azure App Service.

Exemple : déployer sur un emplacement

YAML

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>'
    appType: webAppLinux
    WebAppName: '<app-name>'
    ResourceGroupName: '<name of resource group>'
    SourceSlot: staging
    SwapWithProduction: true

• azureSubscription: Votre abonnement Azure.
• appType: (Facultatif) Permet webAppLinux de déployer sur une application web sur Linux.
• appName: nom de votre service d’application existant.
• deployToSlotOrASE*:Booléen. Déployez dans un emplacement de déploiement existant ou dans Azure App Service Environment.
• resourceGroupName: nom du groupe de ressources. Obligatoire si la valeur de deployToSlotOrASE est true.
• slotName: Nom de l’emplacement, qui est défini par défaut sur production. Obligatoire si la valeur de deployToSlotOrASE est true.
• package: chemin d’accès au package ou à un dossier contenant votre contenu App Service. Les caractères génériques sont pris en charge.
• SourceSlot : Emplacement envoyé à la production lorsque SwapWithProduction est vrai.
• SwapWithProduction:Booléen. Échangez le trafic de l’emplacement source avec la production.

Classique

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.

Exemple : déployer sur plusieurs applications web

YAML

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'

Classique

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 en savoir plus, consultez Phases.

Exemple : déployer de manière conditionnelle

YAML

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

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

L’exemple suivant montre comment utiliser des conditions d’étape pour déployer uniquement des builds 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 en savoir plus sur les conditions, consultez Spécifier des conditions.

Classique

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 Déclencheurs de version, de branche et de phase, Contrôle du déploiement de version avec des approbations, Contrôle du déploiement de version avec des portes et Spécifier des conditions d’exécution d’une tâche.

Exemple : Déployer à l’aide de Web Deploy

La tâche AzureRmWebAppDeployment de déploiement Azure App Service peut être déployée sur App Service à l’aide du déploiement web.

YAML

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@4
  inputs:
    ConnectionType: 'AzureRM'
    azureSubscription: '<service-connection-name>'
    appType: 'webApp'
    WebAppName: '<app-name>'
    packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'
    enableCustomDeployment: true
    DeploymentType: 'webDeploy'

Classique

Si vous utilisez le modèle de déploiement Azure App Service dans le pipeline de publication :

1. Sélectionnez l’onglet Tâches , puis déployez Azure App Service (la AzureRmWebAppDeployment tâche).

2. Dans la boîte de dialogue, vérifiez que le type de connexion est défini sur Azure Resource Manager.

3. Dans la boîte de dialogue, 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.

Remarque

Avec les tâches AzureRmWebAppDeployment@3 et AzureRmWebAppDeployment@4, vous devez utiliser le type de connexion Azure Resource Manager ou AzureRM lorsque vous déployez avec Web Deploy. Il utilise des profils de publication pour le déploiement lorsque l’authentification de base est activée pour votre application. Lorsque l’authentification de base est désactivée, elle utilise l’authentification Microsoft Entra ID plus sécurisée.

Forum aux questions

Quelle est la différence entre les tâches AzureWebApp et AzureRmWebAppDeployment ?

La tâche AzureWebApp est le moyen le plus simple de déployer sur une application web Azure. Par défaut, votre déploiement se produit à l’application racine dans l’application web Azure.

La tâche de déploiement Azure App Service (AzureRmWebAppDeployment) peut gérer des scénarios plus personnalisés, tels que :

• Déployez avec Web Deploy, si vous utilisez généralement le processus de déploiement d’Internet Information Services (IIS).
• Déployez sur des applications virtuelles.
• Déployez sur d’autres types d’applications, tels que les applications conteneur, les applications de fonction, les tâches web ou les applications API et mobiles.

Remarque

La tâche de transformation de fichier distincte prend également en charge les transformations de fichiers et la substitution de variables à utiliser dans Azure Pipelines. Vous pouvez utiliser la tâche Transformation de fichier pour appliquer des transformations de fichiers et des substitutions de variables sur tous les fichiers de configuration et de paramètres.

Pourquoi est-ce que je reçois le message « Chemin de package ou de dossier App Service non valide fourni » ?

Dans les pipelines YAML, selon votre pipeline, il peut y avoir une incompatibilité entre l’emplacement où votre package web généré est enregistré et où la tâche de déploiement la recherche. Par exemple, la tâche AzureWebApp récupère le package web pour le déploiement. La tâche AzureWebApp pourrait apparaître dans $(System.DefaultWorkingDirectory)/**/*.zip. Si le package web est déposé ailleurs, modifiez la valeur de package.

Pourquoi est-ce que je reçois le message « Les options de publication avec Webdeploy ne sont prises en charge que lors de l'utilisation d'un agent Windows » ?

Cette erreur se produit dans la AzureRmWebAppDeployment tâche lorsque vous configurez la tâche pour déployer à l'aide de Web Deploy, mais que votre agent n'exécute pas Windows. Vérifiez que votre YAML inclut quelque chose de similaire au code suivant :

pool:
  vmImage: windows-latest

Pourquoi le déploiement web ne fonctionne-t-il pas quand je désactive l’authentification de base ?

Pour obtenir des informations de dépannage sur la manière de faire fonctionner l'authentification ID Microsoft Entra avec la tâche AzureRmWebAppDeployment, consultez Je ne peux pas déployer par le Web vers mon Azure App Service à l'aide de l'authentification ID Microsoft Entra à partir de mon agent Windows.

Contenu connexe

• Personnalisez votre Pipeline Azure DevOps.