Share via


Implementeren naar App Service met behulp van Azure Pipelines

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

Notitie

Vanaf 1 juni 2024 hebben alle nieuw gemaakte App Service-apps de mogelijkheid om een unieke standaardhostnaam te genereren met behulp van de naamconventie <app-name>-<random-hash>.<region>.azurewebsites.net. Bestaande app-namen blijven ongewijzigd.

Voorbeeld: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Raadpleeg de unieke standaardhostnaam voor App Service-resource voor meer informatie.

Gebruik Azure Pipelines om uw web-app automatisch te implementeren in Azure-app Service bij elke geslaagde build. Met Azure Pipelines kunt u met behulp van Azure DevOps bouwen, testen en implementeren met continue integratie (CI) en continue levering (CD).

YAML-pijplijnen worden gedefinieerd met behulp van een YAML-bestand in uw opslagplaats. Een stap is de kleinste bouwsteen van een pijplijn en kan een script of taak (vooraf verpakt script) zijn. Meer informatie over de belangrijkste concepten en onderdelen waaruit een pijplijn bestaat.

U gebruikt de Azure-web-app-taak (AzureWebApp) om te implementeren in Azure-app Service in uw pijplijn. Voor complexere scenario's, zoals het gebruik van XML-parameters in uw implementatie, kunt u de Azure-app Service Deploy-taak (AzureRmWebAppDeployment) gebruiken.

Vereisten

1. Een pijplijn voor uw stack maken

In de codevoorbeelden in deze sectie wordt ervan uitgegaan dat u een ASP.NET-web-app implementeert. U kunt de instructies voor andere frameworks aanpassen.

Meer informatie over azure Pipelines-ecosysteemondersteuning.

  1. Meld u aan bij uw Azure DevOps-organisatie en navigeer naar uw project.

  2. Ga naar Pijplijnen en selecteer vervolgens Nieuwe pijplijn.

  3. Wanneer u hierom wordt gevraagd, selecteert u de locatie van uw broncode: Azure Repos Git of GitHub.

    U wordt mogelijk omgeleid naar GitHub om u aan te melden. Voer in dat geval uw GitHub-referenties in.

  4. Wanneer de lijst met opslagplaatsen wordt weergegeven, selecteert u uw opslagplaats.

  5. U wordt mogelijk omgeleid naar GitHub om de Azure Pipelines-app te installeren. Als dat het zo is, selecteert u Goedkeuren en installeren.

  6. Wanneer het tabblad Configureren wordt weergegeven, selecteert u ASP.NET Core.

  7. Wanneer uw nieuwe pijplijn wordt weergegeven, bekijkt u de YAML om te zien wat deze doet. Wanneer u klaar bent, selecteert u Opslaan en uitvoeren.

2. De implementatietaak toevoegen

  1. Klik op het einde van het YAML-bestand en selecteer Assistent weergeven.'

  2. Gebruik de taakassistent om de Azure-web-app-taak toe te voegen.

    Schermopname van azure-web-app-taak.

    U kunt ook de taak Azure-app Service Deploy (AzureRmWebAppDeployment) toevoegen.

  3. Kies uw Azure-abonnement. Zorg ervoor dat u uw verbinding autoriseert . De autorisatie maakt de vereiste serviceverbinding.

  4. Selecteer het app-type, de app-naam en de runtimestack op basis van uw App Service-app. Uw volledige YAML moet er ongeveer uitzien als de volgende code.

    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: naam van de geautoriseerde serviceverbinding met uw Azure-abonnement.
    • appName: naam van uw bestaande app.
    • pakket: Bestandspad naar het pakket of een map met de inhoud van uw app-service. Jokertekens worden ondersteund.

Voorbeeld: Een .NET-app implementeren

Als u een .zip-webpakket (bijvoorbeeld van een ASP.NET-web-app) naar een Azure-web-app wilt implementeren, gebruikt u het volgende codefragment om de build te implementeren in een app.

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: uw Azure-abonnement.
  • appType: uw web-app-type.
  • appName: de naam van uw bestaande app-service.
  • pakket: het bestandspad naar het pakket of een map met de inhoud van uw app-service. Jokertekens worden ondersteund.

Voorbeeld: implementeren in een virtuele toepassing

Uw implementatie gebeurt standaard met de hoofdtoepassing in de Azure-web-app. U kunt implementeren in een specifieke virtuele toepassing met behulp van de VirtualApplication eigenschap van de taak Azure-app Service deploy (AzureRmWebAppDeployment):

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

Voorbeeld: Implementeren in een site

In het volgende voorbeeld ziet u hoe u implementeert in een staging-site en vervolgens overwisselt naar een productiesite:

- 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: uw Azure-abonnement.
  • appType: (optioneel) Gebruiken webAppLinux om te implementeren in een web-app in Linux.
  • appName: de naam van uw bestaande app-service.
  • deployToSlotOrASE: Booleaanse waarde. Implementeren naar een bestaande implementatiesite of Azure-app Service Environment.
  • resourceGroupName: naam van de resourcegroep. Vereist als deployToSlotOrASE waar is.
  • slotName: de naam van de site, die standaard wordt gebruikt production. Vereist als deployToSlotOrASE waar is.
  • pakket: het bestandspad naar het pakket of een map met de inhoud van uw app-service. Jokertekens worden ondersteund.
  • SourceSlot: Slot verzonden naar productie wanneer SwapWithProduction waar is.
  • SwapWithProduction: Booleaanse waarde. Het verkeer van de bronsite wisselen met productie.

Voorbeeld: Implementeren in meerdere web-apps

U kunt taken in uw YAML-bestand gebruiken om een pijplijn met implementaties in te stellen. Met behulp van taken kunt u de volgorde van implementatie in meerdere web-apps beheren.

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'

Voorbeeld: Variabelen vervangen

Voor de meeste taalstacks kunnen app-instellingen en verbindingsreeks s tijdens runtime worden ingesteld als omgevingsvariabelen.

Maar er zijn andere redenen waarom u variabelen wilt vervangen door uw Web.config. In dit voorbeeld bevat uw Web.config-bestand een verbindingsreeks met de naam connectionString. U kunt de waarde ervan wijzigen voordat u implementeert in elke web-app. U kunt dit doen door een Web.config-transformatie toe te passen of door variabelen in uw Web.config-bestand te vervangen.

In het volgende fragment ziet u een voorbeeld van het vervangen van variabelen met behulp van de taak Azure-app Service Deploy (AzureRmWebAppDeployment):

jobs:
- job: test
  variables:
    connectionString: <test-stage connection string>
  steps:
  - task: AzureRmWebAppDeployment@4
    inputs:
      azureSubscription: '<Test stage Azure service connection>'
      WebAppName: '<name of test stage web app>'
      enableXmlVariableSubstitution: true

- job: prod
  dependsOn: test
  variables:
    connectionString: <prod-stage connection string>
  steps:
  - task: AzureRmWebAppDeployment@4
    inputs:
      azureSubscription: '<Prod stage Azure service connection>'
      WebAppName: '<name of prod stage web app>'
      enableXmlVariableSubstitution: true

Voorbeeld: Voorwaardelijk implementeren

U kunt dit doen in YAML door een van de volgende technieken te gebruiken:

  • Isoleer de implementatiestappen in een afzonderlijke taak en voeg een voorwaarde toe aan die taak.
  • Voeg een voorwaarde toe aan de stap.

In het volgende voorbeeld ziet u hoe u stapvoorwaarden gebruikt om alleen builds te implementeren die afkomstig zijn van de hoofdbranch:

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

Zie Voorwaarden opgeven voor meer informatie over voorwaarden.

Voorbeeld: implementeren met behulp van Web Deploy

De taak Azure-app Service deploy (AzureRmWebAppDeployment) kan implementeren in App Service met behulp van Web Deploy.

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'

Veelgestelde vragen

Wat is het verschil tussen de AzureWebApp en AzureRmWebAppDeployment taken?

De Azure Web App-taak (AzureWebApp) is de eenvoudigste manier om te implementeren in een Azure-web-app. Uw implementatie gebeurt standaard met de hoofdtoepassing in de Azure-web-app.

De Azure-app Service Deploy-taak (AzureRmWebAppDeployment) kan meer aangepaste scenario's verwerken, zoals:

Notitie

Bestandstransformaties en het vervangen van variabelen worden ook ondersteund door de afzonderlijke taak Bestandstransformatie voor gebruik in Azure Pipelines. U kunt de taak Bestandstransformatie gebruiken om bestandstransformaties en variabele vervangingen toe te passen op configuratie- en parameterbestanden.

Ik krijg het bericht 'Ongeldig App Service-pakket of mappad opgegeven'.

Afhankelijk van uw pijplijn komen er in YAML-pijplijnen mogelijk niet overeen tussen waar uw ingebouwde webpakket wordt opgeslagen en waar de implementatietaak ernaar op zoek is. De taak haalt bijvoorbeeld AzureWebApp het webpakket op voor implementatie. De AzureWebApp-taak zoekt bijvoorbeeld in $(System.DefaultWorkingDirectory)/**/*.zip. Als het webpakket ergens anders wordt neergezet, wijzigt u de waarde van package.

Ik krijg het bericht 'Publiceren met webdeploy-opties worden alleen ondersteund bij het gebruik van Windows-agent'.

Deze fout treedt op in de AzureRmWebAppDeployment-taak wanneer u de taak configureert voor implementatie met webimplementatie, maar uw agent wordt niet uitgevoerd op Windows. Controleer of uw YAML iets vergelijkbaars heeft met de volgende code:

pool:
  vmImage: windows-latest

Web Deploy werkt niet wanneer ik basisverificatie uitschakelt

Zie voor informatie over het oplossen van problemen met microsoft Entra ID-verificatie om met de AzureRmWebAppDeployment taak te werken, zie ik geen webimplementatie in mijn Azure-app-service met behulp van Microsoft Entra ID-verificatie van mijn Windows-agent

Volgende stappen