Ćwiczenie — aktualizowanie wyzwalacza przepływu pracy

Ukończone

Współpracownik prosi Cię o włączenie funkcji Always On usługi App Service w witrynie internetowej firmy, dzięki czemu aplikacja internetowa jest zawsze uruchomiona.

W tym ćwiczeniu zaktualizujesz utworzony przepływ pracy, aby był uruchamiany automatycznie za każdym razem, gdy plik zmieni się w gałęzi głównej . Zaktualizowany przepływ pracy zostanie użyty do wdrożenia żądanej zmiany konfiguracji w witrynie internetowej.

Podczas tego procesu wykonasz następujące czynności:

  • Zaktualizuj przepływ pracy, aby był wyzwalany automatycznie za każdym razem, gdy plik zmieni się w folderze wdrażania w gałęzi głównej.
  • Wprowadź zmianę w pliku Bicep.
  • Sprawdź, czy przepływ pracy jest uruchamiany automatycznie.

Aktualizowanie wyzwalacza tak, aby był oparty na gałęzi

  1. W programie Visual Studio Code otwórz plik .github/workflows/workflow.yml .

  2. W górnej części pliku po wierszu name: deploy-toy-website dodaj następujący kod, aby zapobiec wielu równoczesnym uruchomieniom przepływów pracy:

    name: deploy-toy-website
    concurrency: toy-company
    
  3. Usuń wyzwalacz ręczny, czyli wiersz, który obecnie odczytuje on: [workflow_dispatch]element .

  4. Między concurrency: i permissions: dodaj następującą definicję wyzwalacza:

    concurrency: toy-company
    
    on:
      push:
        branches:
          - main
        paths:
          - 'deploy/**'
    
    permissions:
    
  5. Zapisz zmiany w pliku.

  6. Zatwierdź zmiany, ale nie wypchnij ich jeszcze. Wkrótce wypchniesz zmiany.

    git add .
    git commit -m 'Add branch trigger'
    

Aktualizowanie pliku Bicep

  1. W programie Visual Studio Code otwórz plik main.bicep .

  2. appServiceApp We właściwości definicji siteConfig zasobu dodaj alwaysOn właściwość z wartością true:

    
    resource appServiceApp 'Microsoft.Web/sites@2022-03-01' = {
      name: appServiceAppName
      location: location
      properties: {
        serverFarmId: appServicePlan.id
        httpsOnly: true
        siteConfig: {
          alwaysOn: true
          appSettings: [
            {
              name: 'ToyManualsStorageAccountConnectionString'
              value: toyManualsStorageAccountConnectionString
            }
          ]
        }
      }
    
  3. Zapisz zmiany w pliku.

  4. W terminalu programu Visual Studio Code uruchom następujący kod, aby zatwierdzić zmiany i wypchnąć oba zatwierdzenia:

    git add .
    git commit -m 'Configure app Always On setting'
    git push
    

Sprawdzanie, czy przepływ pracy kończy się niepowodzeniem

  1. W przeglądarce wybierz menu Akcje usługi GitHub i wybierz przepływ pracy.

  2. Wybierz najnowszy przebieg przepływu pracy, aby zobaczyć, że przepływ pracy został uruchomiony automatycznie. Przepływ pracy został uruchomiony, ponieważ zmiany zostały wypchnięte do gałęzi monitorowanej przez wyzwalacz wypychania. Jeśli przepływ pracy jest nadal uruchomiony, zaczekaj minutę, a następnie odśwież stronę.

    Screenshot of the GitHub interface showing the failed workflow run.

    Przepływ pracy pokazuje nieudane wdrożenie.

  3. Aby zdiagnozować błąd, wybierz zadanie wdrażania, a następnie wybierz zadanie wdrażania arm-deploy, które zakończyło się niepowodzeniem.

    Zwróć uwagę, że zawiera on następujący tekst:

    There was a conflict. AlwaysOn cannot be set for this site as the plan does not allow it.
    For more information on pricing and features, please see: https://aka.ms/appservicepricingdetails
    

    Ten komunikat o błędzie wskazuje, że wdrożenie nie powiodło się, ponieważ aplikacja usługi App Service została wdrożona przy użyciu warstwy Bezpłatna F1, która nie obsługuje funkcji Always On.

    Ważne

    W tym przykładzie pokazano, jak ważne jest przetestowanie plików Bicep, w tym wszystkich używanych wartości parametrów. Subtelne błędy można łatwo dodać do konfiguracji zasobu lub innego kodu. Problem może nie zostać wykryty, dopóki przepływ pracy nie wdroży kodu i zakończy się niepowodzeniem. W przyszłym module poznasz kilka strategii, których można użyć do weryfikowania i testowania kodu Bicep.

Napraw plik Bicep i zobacz ponownie wyzwolony przepływ pracy

Porozmawiasz z współpracownikem o nieudanym wdrożeniu. Jednocześnie decydujesz, że ustawienie Zawsze włączone musi być stosowane tylko dla środowiska produkcyjnego. W tym miejscu rozwiążesz problem, który spowodował niepowodzenie wdrożenia, stosując nową regułę, której chcesz użyć.

  1. W programie Visual Studio Code dodaj nowe właściwości dla każdego typu środowiska do zmiennej environmentConfigurationMap :

    var environmentConfigurationMap = {
      nonprod: {
        appServiceApp: {
          alwaysOn: false
        }
        appServicePlan: {
          sku: {
            name: 'F1'
            capacity: 1
          }
        }
        toyManualsStorageAccount: {
          sku: {
            name: 'Standard_LRS'
          }
        }
      }
      prod: {
        appServiceApp: {
          alwaysOn: true
        }
        appServicePlan: {
          sku: {
            name: 'S1'
            capacity: 2
          }
        }
        toyManualsStorageAccount: {
          sku: {
            name: 'Standard_ZRS'
          }
        }
      }
    }
    
  2. Zmień ustawienie aplikacji alwaysOn , aby użyć odpowiedniej wartości mapy konfiguracji dla typu środowiska:

    resource appServiceApp 'Microsoft.Web/sites@2023-12-01' = {
      name: appServiceAppName
      location: location
      properties: {
        serverFarmId: appServicePlan.id
        httpsOnly: true
        siteConfig: {
          alwaysOn: environmentConfigurationMap[environmentType].appServiceApp.alwaysOn
          appSettings: [
            {
              name: 'ToyManualsStorageAccountConnectionString'
              value: toyManualsStorageAccountConnectionString
            }
          ]
        }
      }
    }
    
  3. Zapisz zmiany w pliku.

  4. W terminalu programu Visual Studio Code zatwierdź zmiany i wypchnij je:

    git add .
    git commit -m 'Enable App Service Always On for production environments only'
    git push
    

Sprawdzanie, czy przepływ pracy zakończył się pomyślnie

  1. W usłudze GitHub wróć do listy przepływów pracy. wybierz przepływ pracy.

  2. Wybierz najnowszy przebieg. Jeśli przepływ pracy jest nadal uruchomiony, zaczekaj minutę, a następnie odśwież stronę.

    Zostanie wyświetlony przebieg przepływu pracy.

    Screenshot of the GitHub interface showing the successful workflow run.

    Przepływ pracy przedstawia pomyślne wdrożenie. Udało się to tym razem, ponieważ użyto prawidłowego pliku Bicep.

Oczyszczanie zasobów

Po ukończeniu ćwiczenia możesz usunąć zasoby, aby nie były naliczane opłaty.

W terminalu programu Visual Studio Code uruchom następujące polecenie:

az group delete --resource-group ToyWebsite --yes --no-wait

Grupa zasobów jest usuwana w tle.

Remove-AzResourceGroup -Name ToyWebsite -Force