Ćwiczenie — implementowanie niebieskiego zielonego wzorca wdrażania

Ukończone

** W sekcji "Tworzenie potoku wieloetapowego przy użyciu usługi Azure Pipelines"stworzyliśmy podstawowy potok wdrożeniowy, który w kolejnych etapach instaluje aplikację internetową na usłudze Azure App Service: Dev, Testoraz Staging.

W tym miejscu dodajesz do tego workflow, stosując wzorzec wdrażania niebiesko-zielony podczas Staging.

W tym celu, Ty:

  • Dodaj miejsce wdrożeniowe do wystąpienia usługi App Service, które odpowiada staging.
  • Dodaj zadanie do pipeline'u, aby zamienić sloty wdrożeniowe.

Dodaj slot wdrożeniowy

W tym miejscu dodasz slot wdrożeniowy do wystąpienia usługi App Service, które odpowiada Staging.

Domyślnie każde wystąpienie usługi App Service udostępnia domyślną przestrzeń o nazwie produkcja. Wdrożyłeś do miejsca produkcyjnego w slocie, gdy skonfigurowałeś potok w poprzedniej sekcji.

Wystąpienie usługi App Service może mieć wiele slotów. W tym miejscu dodasz drugi slot wdrożeniowy do instancji App Service, który odpowiada Staging. Miejsce wdrożenia nosi nazwę swap.

Aby dodać miejsce:

  1. Przejdź do witryny Azure Portal i zaloguj się.

  2. W menu wybierz pozycję Cloud Shell. Po wyświetleniu monitu wybierz środowisko powłoki Bash.

  3. pl-PL: Uruchom następujące polecenie, aby uzyskać nazwę wystąpienia usługi App Service odpowiadającego przejściowemu środowisku i zapisać wynik w zmiennej Bash o nazwie staging.

    staging=$(az webapp list \
      --resource-group tailspin-space-game-rg \
      --query "[?contains(@.name, 'tailspin-space-game-web-staging')].{name: name}" \
      --output tsv)
    

    Argument --query używa JMESPath, który jest językiem zapytań dla formatu JSON. Argument wybiera wystąpienie usługi App Service, którego pole name zawiera wartość "tailspin-space-game-web-staging".

  4. Wydrukuj zmienną staging, aby sprawdzić, czy otrzymasz poprawną nazwę.

    echo $staging
    

    Oto przykład danych wyjściowych:

    tailspin-space-game-web-staging-1234
    
  5. Uruchom następujące polecenie, aby dodać slot o nazwie swap do środowiska przejściowego.

    az webapp deployment slot create \
      --name $staging \
      --resource-group tailspin-space-game-rg \
      --slot swap
    
  6. Uruchom następujące polecenie, aby wyświetlić nazwę hosta dla miejsca wdrożenia.

    az webapp deployment slot list \
        --name $staging \
        --resource-group tailspin-space-game-rg \
        --query [].hostNames \
        --output tsv
    

    Wynik przypomina następujące dane wyjściowe:

    tailspin-space-game-web-staging-25391-swap.azurewebsites.net
    

    Zanotuj tę nazwę hosta na później.

  7. Opcjonalnie przejdź do witryny w przeglądarce. Widzisz domyślną stronę główną, ponieważ nie wdrożyłeś jeszcze swojego kodu do tego slotu.

    Zrzut ekranu przedstawiający domyślną stronę główną w usłudze Azure App Service.

Domyślnie gniazdo wdrożeniowe jest dostępne z internetu. W praktyce można skonfigurować sieć wirtualną platformy Azure, która umieszcza slot przełączania w sieci, która nie jest routowalna z Internetu, do której tylko twój zespół może mieć dostęp. Twoje miejsce produkcyjne pozostanie dostępne z Internetu.

Zmiana slotów wdrożeniowych na etapie przejściowym

W tym miejscu używasz zadania AzureAppServiceManage@0, aby zamienić sloty wdrożeniowe w środowisku Staging.

To zadanie może być również używane do uruchamiania, zatrzymywania lub usuwania slotu. Możesz też użyć go do zainstalowania rozszerzeń witryny lub włączenia ciągłego monitorowania w usłudze Azure App Service.

  1. W programie Visual Studio Code zmodyfikuj azure-pipelines.yml przy użyciu tego kodu:

    Napiwek

    Możesz zastąpić cały plik lub po prostu zaktualizować wyróżnioną część.

    trigger:
    - '*'
    
    variables:
      buildConfiguration: 'Release'
    
    stages:
    - stage: 'Build'
      displayName: 'Build the web application'
      jobs: 
      - job: 'Build'
        displayName: 'Build job'
        pool:
          vmImage: 'ubuntu-20.04'
          demands:
          - npm
    
        variables:
          wwwrootDir: 'Tailspin.SpaceGame.Web/wwwroot'
          dotnetSdkVersion: '6.x'
    
        steps:
        - task: UseDotNet@2
          displayName: 'Use .NET SDK $(dotnetSdkVersion)'
          inputs:
            version: '$(dotnetSdkVersion)'
    
        - task: Npm@1
          displayName: 'Run npm install'
          inputs:
            verbose: false
    
        - script: './node_modules/.bin/node-sass $(wwwrootDir) --output $(wwwrootDir)'
          displayName: 'Compile Sass assets'
    
        - task: gulp@1
          displayName: 'Run gulp tasks'
    
        - script: 'echo "$(Build.DefinitionName), $(Build.BuildId), $(Build.BuildNumber)" > buildinfo.txt'
          displayName: 'Write build info'
          workingDirectory: $(wwwrootDir)
    
        - task: DotNetCoreCLI@2
          displayName: 'Restore project dependencies'
          inputs:
            command: 'restore'
            projects: '**/*.csproj'
    
        - task: DotNetCoreCLI@2
          displayName: 'Build the project - $(buildConfiguration)'
          inputs:
            command: 'build'
            arguments: '--no-restore --configuration $(buildConfiguration)'
            projects: '**/*.csproj'
    
        - task: DotNetCoreCLI@2
          displayName: 'Publish the project - $(buildConfiguration)'
          inputs:
            command: 'publish'
            projects: '**/*.csproj'
            publishWebProjects: false
            arguments: '--no-build --configuration $(buildConfiguration) --output $(Build.ArtifactStagingDirectory)/$(buildConfiguration)'
            zipAfterPublish: true
    
        - publish: '$(Build.ArtifactStagingDirectory)'
          artifact: drop
    
    - stage: 'Dev'
      displayName: 'Deploy to the dev environment'
      dependsOn: Build
      jobs:
      - deployment: Deploy
        pool:
          vmImage: 'ubuntu-20.04'
        environment: dev
        variables:
        - group: Release
        strategy:
          runOnce:
            deploy:
              steps:
              - download: current
                artifact: drop
              - task: AzureWebApp@1
                displayName: 'Azure App Service Deploy: website'
                inputs:
                  azureSubscription: 'Resource Manager - Tailspin - Space Game'
                  appName: '$(WebAppNameDev)'
                  package: '$(Pipeline.Workspace)/drop/$(buildConfiguration)/*.zip'
    
    - stage: 'Test'
      displayName: 'Deploy to the test environment'
      dependsOn: Dev
      jobs:
      - deployment: Deploy
        pool:
          vmImage: 'ubuntu-20.04'
        environment: test
        variables:
        - group: 'Release'
        strategy:
          runOnce:
            deploy:
              steps:
              - download: current
                artifact: drop
              - task: AzureWebApp@1
                displayName: 'Azure App Service Deploy: website'
                inputs:
                  azureSubscription: 'Resource Manager - Tailspin - Space Game'
                  appName: '$(WebAppNameTest)'
                  package: '$(Pipeline.Workspace)/drop/$(buildConfiguration)/*.zip'
    
    - stage: 'Staging'
      displayName: 'Deploy to the staging environment'
      dependsOn: Test
      jobs:
      - deployment: Deploy
        pool:
          vmImage: 'ubuntu-20.04'
        environment: staging
        variables:
        - group: 'Release'
        strategy:
          runOnce:
            deploy:
              steps:
              - download: current
                artifact: drop
              - task: AzureWebApp@1
                displayName: 'Azure App Service Deploy: website'
                inputs:
                  azureSubscription: 'Resource Manager - Tailspin - Space Game'
                  deployToSlotOrASE: 'true'
                  resourceGroupName: 'tailspin-space-game-rg'
                  slotName: 'swap'
                  appName: '$(WebAppNameStaging)'
                  package: '$(Pipeline.Workspace)/drop/$(buildConfiguration)/*.zip'
              - task: AzureAppServiceManage@0
                displayName: 'Swap deployment slots'
                inputs:
                  azureSubscription: 'Resource Manager - Tailspin - Space Game'
                  resourceGroupName: 'tailspin-space-game-rg'
                  webAppName: '$(WebAppNameStaging)'
                  sourceSlot: 'swap'
                  targetSlot: 'production'
                  action: 'Swap Slots'
    

    Zanotuj następujące zmiany:

    • Zadanie AzureWebApp@1 określa teraz następujące wartości:
      • deployToSlotOrASE, gdy jest ustawiona na true, jest wdrażana w istniejącym miejscu wdrożenia.
      • resourceGroupName określa nazwę grupy zasobów. Ta wartość jest wymagana, gdy deployToSlotOrASE jest true.
      • slotName określa nazwę miejsca wdrożenia. Tutaj wdrażasz do slotu o nazwie swap.
    • Nowe zadanie, AzureAppServiceManage@0, zamienia miejsca wdrożenia.
      • sourceSlot i targetSlot wskazują sloty do zamiany.
      • action określa akcję do wykonania. Pamiętaj, że to zadanie służy do uruchamiania, zatrzymywania lub usuwania slotu. Tutaj "Zamiana miejsc" odnosi się do zamiany miejsc źródłowych i docelowych.

    Ta konfiguracja zawsze wdraża się do slotu wymiany . Następnie zamienia produkcje i na swoje miejsca. Proces zamiany gwarantuje, że produkcji wskazuje na nowsze wdrożenie.

  2. W zintegrowanym terminalu dodaj azure-pipelines.yml do indeksu. Zatwierdź zmiany, a następnie wypchnij gałąź do usługi GitHub.

    Napiwek

    Zapisz plik azure-pipelines.yml przed uruchomieniem tych poleceń Git.

    git add azure-pipelines.yml
    git commit -m "Swap deployment slots"
    git push origin blue-green
    
  3. W usłudze Azure Pipelines prześledź kompilację przez każdy z kroków.

Nota

Jeśli wystąpi następujący błąd ...'staging' slot did not respond to http ping. (CODE: 417), spróbuj ponownie uruchomić usługę aplikacji. Jeśli problem będzie się powtarzać, zresetuj przełączanie automatyczne dla slota.

  1. Opcjonalnie w przeglądarce przejdź do adresu URL odpowiadającego każdemu etapowi.

    Mimo że nie wprowadzono jeszcze zmian w witrynie internetowej, zobaczysz, że witryna internetowa Space Game pomyślnie wdrożona w każdym środowisku usługi App Service.

    Zrzut ekranu przedstawiający przeglądarkę z witryną internetową Space Game w środowisku deweloperskim.