Een aangepaste container implementeren in Azure-app Service met Azure Pipelines

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Met Behulp van Azure Pipelines kunt u uw web-app bouwen, testen en automatisch implementeren in een Azure-app Service Web App-container in Linux. In dit artikel leert u hoe u YAML- of klassieke pijplijnen gebruikt voor het volgende:

• Een Docker-image bouwen en publiceren naar Azure Container Registry
• Een Azure-web-app maken
• Een container implementeren in Azure-app Service
• Implementeren naar implementatieslots

Vereisten

• Een Azure-account met een actief abonnement. Gratis een account maken
• Een GitHub-account. Maak een gratis GitHub-account als u er nog geen hebt.
• een Azure DevOps-organisatie. Maak een organisatie als u er nog geen hebt.
• Een Azure Container Registry. Maak een Azure-containerregister als u er nog geen hebt.

Code ophalen

Fork de volgende voorbeeld-app op GitHub.

Java

https://github.com/spring-guides/gs-spring-boot-docker.git

JavaScript

https://github.com/MicrosoftDocs/pipelines-javascript-docker

Python

https://github.com/Microsoft/python-sample-vscode-flask-tutorial

.NET Core

https://github.com/MicrosoftDocs/pipelines-dotnet-core-docker

Een Docker-image bouwen en publiceren naar Azure Container Registry

Als u deze sectie wilt voltooien, moet u een Azure Container Registry hebben. Raadpleeg de sectie vereisten voor meer informatie.

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

2. Selecteer Pijplijnen en vervolgens Nieuwe pijplijn.

3. Selecteer GitHub wanneer u wordt gevraagd om de locatie van uw broncode en selecteer vervolgens uw opslagplaats.

4. Selecteer de pijplijnsjabloon Docker: build and push an image to Azure Container Registry.

   

5. Selecteer uw Azure-abonnement en selecteer vervolgens Doorgaan.

6. Selecteer uw containerregister in de vervolgkeuzelijst en selecteer vervolgens Valideren en configureren.

   

7. Controleer de YAML-sjabloon voor de pijplijn en selecteer Opslaan en uitvoeren om de Docker-image te bouwen en te publiceren naar uw Azure Container Registry.

   trigger:
   - main
   
   resources:
   - repo: self
   
   variables:
       # Container registry service connection established during pipeline creation
       dockerRegistryServiceConnection: '{{ containerRegistryConnection.Id }}'
       imageRepository: 'javascriptdocker'
       containerRegistry: 'sampleappcontainerregistry.azurecr.io'
       dockerfilePath: '$(Build.SourcesDirectory)/app/Dockerfile'
       tag: '$(Build.BuildId)'
   
       # Agent VM image name
       vmImageName: 'ubuntu-latest'
   
   stages:
   - stage: Build
       displayName: Build and push stage
       jobs:
       - job: Build
       displayName: Build
       pool:
           vmImage: $(vmImageName)
       steps:
       - task: Docker@2
           displayName: Build and push an image to container registry
           inputs:
           command: buildAndPush
           repository: $(imageRepository)
           dockerfile: $(dockerfilePath)
           containerRegistry: $(dockerRegistryServiceConnection)
           tags: |
               $(tag)
   

8. Om de gepubliceerde Docker-afbeelding te zien nadat uw pijplijnuitvoering is voltooid, gaat u naar uw containerregister in de Azure Portal en selecteert u Repositories.

   

9. Om uw afbeelding vanuit het containerregister uit te rollen, moet u het admin gebruikersaccount inschakelen. Navigeer naar uw containerregister in Azure Portal en selecteer Toegangssleutels. Selecteer vervolgens de schakelknop om de Admin-gebruiker in te schakelen.

Een web-app maken

1. Ga naar Azure Portal.

2. Selecteer Maak een resource>Containers en kies vervolgens Web App voor Containers.

   

3. Voer een naam in voor uw nieuwe web-app en maak een nieuwe resourcegroep. Selecteer Linux voor het besturingssysteem.

   

4. Kies in de sectie Prijsplannen het gratis F1-abonnement.

5. Selecteer Beoordelen en maken. Controleer uw configuratie en selecteer Maken wanneer u klaar bent.

Implementeren in Web App for Containers

YAML

In deze YAML bouwt en pusht u een Docker-afbeelding naar een containerregister en implementeert u deze vervolgens in Azure Web App voor Containers. In de buildfase bouwt en pusht u een Docker-image naar een Azure Container Registry met de Docker@2 taak. De AzureWebAppContainer@1 taak implementeert het image in Web App for Containers.

trigger:
- main

resources:
- repo: self

variables: 
  ## Add this under variables section in the pipeline
  azureSubscription: <Name of the Azure subscription>
  appName: <Name of the Web App>
  containerRegistry: <Name of the Azure container registry>
  dockerRegistryServiceConnection: '4fa4efbc-59af-4c0b-8637-1d5bf7f268fc'
  imageRepository: <Name of image repository>
  dockerfilePath: '$(Build.SourcesDirectory)/Dockerfile'
  tag: '$(Build.BuildId)'

  vmImageName: 'ubuntu-latest'

stages:
- stage: Build
  displayName: Build and push stage
  jobs:
  - job: Build
    displayName: Build
    pool:
      vmImage: $(vmImageName)
    steps:
    - task: Docker@2
      displayName: Build and push an image to container registry
      inputs:
        command: buildAndPush
        repository: $(imageRepository)
        dockerfile: $(dockerfilePath)
        containerRegistry: $(dockerRegistryServiceConnection)
        tags: |
          $(tag)


    ## Add the below snippet at the end of your pipeline
    - task: AzureWebAppContainer@1
      displayName: 'Azure Web App on Container Deploy'
      inputs:
        azureSubscription: $(azureSubscription)
        appName: $(appName)
        containers: $(containerRegistry)/$(imageRepository):$(tag)

Klassiek

1. Selecteer Pijplijnen in uw project en selecteer vervolgens Release.

2. Selecteer Nieuwe pijplijn om een nieuwe release-pijplijn te maken.

3. Selecteer de Azure App Service-implementatie-sjabloon

   

4. Selecteer Taken en kies daarna Alles ontkoppelen in fase 1 om alle pijplijnparameters los te koppelen.

   

5. Selecteer de taak Implementatie van Azure App Service en vul de vereiste velden in. Selecteer Opslaan wanneer u klaar bent.

   

6. Selecteer Release maken en kies fase 1 in de vervolgkeuzelijst. Selecteer Maken wanneer u klaar bent.

   

7. Beweeg de muisaanwijzer over Fase 1 in uw pijplijn en selecteer Implementeren om in de wachtrij te plaatsen en de implementatie te starten.

   

8. Uw pijplijnlogboeken moeten er ongeveer uitzien als in de onderstaande schermafbeelding.

   

9. Navigeer naar uw zojuist geïmplementeerde web-app om uw implementatie te verifiëren.

   

Implementeren naar een implementatieslot

YAML

U kunt de Azure Web App-container zo configureren dat er meerdere slots zijn. Met slots kunt u uw app veilig uitrollen en testen voordat u deze beschikbaar maakt voor uw klanten. Zie voor meer informatie Faseringsomgevingen maken.

In het volgende YAML-fragment ziet u hoe u implementeert in een staging-slot en vervolgens wisselt naar een productieslot.

- task: AzureWebAppContainer@1
  inputs:
    azureSubscription: '<Azure service connection>'
    appName: '<Name of the web app>'
    containers: $(containerRegistry)/$(imageRepository):$(tag)
    deployToSlotOrASE: true
    resourceGroupName: '<Name of the resource group>'
    slotName: staging

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

Klassiek

U kunt de Azure Web App voor containers configureren om meerdere sleuven te hebben. Met slots kunt u uw app veilig uitrollen en testen voordat u deze beschikbaar maakt voor uw klanten. Gebruik de optie Implementeren naar slot in de Azure Web App Container-taak om de slot op te geven waarop moet worden geïmplementeerd. U kunt de slots wisselen met behulp van de Azure App Service Manage-taak.

Veelgestelde vragen

V: Hoe kan ik mijn Docker-registerreferenties vinden?

A: Navigeer naar Azure Portal en selecteer vervolgens uw Web App for Containers. Selecteer De >en klik om de waarde weer te geven.

Verwante artikelen:

• Implementeren naar Azure
• ARM-sjablonen gebruiken
• Omgevingen definiëren en doelomgevingen