Ćwiczenie — implementowanie niebieskiego zielonego wzorca wdrażania
** 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:
Przejdź do witryny Azure Portal i zaloguj się.
W menu wybierz pozycję Cloud Shell. Po wyświetleniu monitu wybierz środowisko powłoki Bash.
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 polename
zawiera wartość "tailspin-space-game-web-staging".Wydrukuj zmienną
staging
, aby sprawdzić, czy otrzymasz poprawną nazwę.echo $staging
Oto przykład danych wyjściowych:
tailspin-space-game-web-staging-1234
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
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.
Opcjonalnie przejdź do witryny w przeglądarce. Widzisz domyślną stronę główną, ponieważ nie wdrożyłeś jeszcze swojego kodu do tego slotu.
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.
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 natrue
, jest wdrażana w istniejącym miejscu wdrożenia. -
resourceGroupName
określa nazwę grupy zasobów. Ta wartość jest wymagana, gdydeployToSlotOrASE
jesttrue
. -
slotName
określa nazwę miejsca wdrożenia. Tutaj wdrażasz do slotu o nazwie swap.
-
- Nowe zadanie,
AzureAppServiceManage@0
, zamienia miejsca wdrożenia.-
sourceSlot
itargetSlot
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.
- Zadanie
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
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.
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.