Konfigurowanie potoku i aktualizacji wypychanych

  • Artykuł

W tym artykule dowiesz się, jak za pomocą interfejsu wiersza polecenia dla deweloperów platformy Azure (azd) wypychać zmiany szablonu za pośrednictwem potoku ciągłej integracji/ciągłego wdrażania, takiego jak GitHub Actions lub Azure DevOps. W tym przykładzie użyjesz aplikacji internetowej React z interfejsem API Node.js i bazą danych MongoDB na platformie Azure , ale możesz zastosować zasady, które poznasz w tym artykule, do dowolnego z szablonów interfejsu wiersza polecenia dla deweloperów platformy Azure.

Uwaga

Polecenie azd pipeline config jest nadal w wersji beta. Przeczytaj więcej na temat obsługi funkcji alfa i beta na stronie strategii obsługi wersji funkcji i wydania.

Wymagania wstępne

Wszystkie azd szablony obejmują domyślny plik konfiguracji potoku GitHub Actions i Azure DevOps o nazwie azure-dev.yml, który jest wymagany do skonfigurowania ciągłej integracji/ciągłego wdrażania. Ten plik konfiguracji aprowizuje zasoby platformy Azure i wdróż kod w gałęzi głównej. Możesz znaleźć następujące informacje azure-dev.yml:

  • W przypadku funkcji GitHub Actions: w .github/workflow katalogu.
  • W przypadku .azdo/pipelines usługi Azure DevOps: w katalogu .

Aby skonfigurować potok ciągłej integracji/ciągłego wdrażania, użyj azd pipeline config polecenia , które obsługuje następujące zadania:

  • Tworzy i konfiguruje jednostkę usługi dla aplikacji w subskrypcji platformy Azure.
  • Procedura tworzenia i konfigurowania repozytorium GitHub oraz zatwierdzania do niego kodu projektu. Możesz również użyć istniejącego repozytorium GitHub.
  • Tworzy bezpieczne połączenie między platformą Azure i repozytorium przy użyciu wpisów tajnych usługi GitHub.
  • Uruchamia akcję Usługi GitHub po zaewidencjonowyniu pliku przepływu pracy.

Aby uzyskać bardziej szczegółową kontrolę nad tym procesem, możesz również ręcznie skonfigurować potok.

Wszystkie szablony zawierają domyślne akcje GitHub Actions i plik konfiguracji potoku usługi Azure DevOps o nazwie azure-dev.yml. Ten plik konfiguracji aprowizuje zasoby platformy Azure i wdraża kod w gałęzi głównej. Możesz znaleźć następujące informacje azure-dev.yml:

  • W przypadku funkcji GitHub Actions: w .github/workflow katalogu.
  • W przypadku .azdo/pipelines usługi Azure DevOps: w katalogu .

Możesz użyć pliku konfiguracji zgodnie z potrzebami lub zmodyfikować go zgodnie z potrzebami.

Wybierz preferowanego dostawcę potoku, aby kontynuować:

Autoryzowanie usługi GitHub do wdrażania na platformie Azure

Aby skonfigurować przepływ pracy, musisz przyznać usłudze GitHub uprawnienia do wdrażania na platformie Azure w Twoim imieniu. Autoryzuj usługę GitHub przez utworzenie jednostki usługi platformy Azure przechowywanej we wpisie tajnym usługi GitHub o nazwie AZURE_CREDENTIALS.

  1. Uruchom następujące polecenie, aby utworzyć jednostkę usługi platformy Azure i skonfigurować potok:

    azd pipeline config

    To polecenie tworzy również prywatne repozytorium GitHub i wypycha kod do nowego repozytorium.

    Uwaga

    Domyślnie azd pipeline config używa Połączenie OpenID (OIDC) nazywanych poświadczeniami federacyjnymi. Jeśli nie chcesz używać protokołu OIDC, uruchom polecenie azd pipeline config --auth-type client-credentials.

    Poświadczenia OIDC/federacyjne nie są obsługiwane w przypadku programu Terraform.

    Dowiedz się więcej o obsłudze funkcji OIDC w systemie azd.

  2. Podaj żądane informacje w witrynie GitHub.

  3. Po wyświetleniu monitu o zatwierdzenie i wypchnięcie lokalnych zmian w celu uruchomienia nowego uruchomienia funkcji GitHub Actions określ wartość y.

  4. W oknie terminalu wyświetl wyniki azd pipeline config polecenia. Polecenie azd pipeline config wyświetli nazwę repozytorium GitHub dla projektu.

  5. Za pomocą przeglądarki otwórz repozytorium GitHub dla projektu.

  6. Wybierz pozycję Akcje , aby wyświetlić uruchomiony przepływ pracy.

    Zrzut ekranu przedstawiający uruchomiony przepływ pracy usługi GitHub.

Wprowadzanie i wypychanie zmiany kodu

  1. W katalogu projektu /src/web/src/layout otwórz plik header.tsx.

  2. Znajdź wiersz <Text variant="xLarge">ToDo</Text>.

  3. Zmień literał ToDo na myTodo.

  4. Zapisz plik.

  5. Zatwierdź wprowadzone zmiany. Zatwierdzenie zmiany powoduje uruchomienie potoku akcji usługi GitHub w celu wdrożenia aktualizacji.

    Zrzut ekranu przedstawiający kroki wymagane do wprowadzenia i zatwierdzenia zmiany w pliku testowym.

  6. Za pomocą przeglądarki otwórz repozytorium GitHub projektu, aby wyświetlić oba te elementy:

    • Zatwierdzenie
    • Zatwierdzanie z konfigurowanych funkcji GitHub Actions.

    Zrzut ekranu przedstawiający zatwierdzoną zmianę w usłudze GitHub.

  7. Wybierz pozycję Akcje , aby wyświetlić aktualizację testu odzwierciedlona w przepływie pracy.

    Zrzut ekranu przedstawiający przepływ pracy usługi GitHub uruchomiony po aktualizacji testowej.

  8. Odwiedź adres URL frontonu internetowego, aby sprawdzić aktualizację.

azd jako akcja usługi GitHub

Dodaj azd jako akcję usługi GitHub. Ta akcja spowoduje zainstalowanie azdelementu . Aby go użyć, możesz dodać następujące elementy do :.github\workflows\azure-dev.yml

on: [push]

jobs:
   build:
      runs-on: ubuntu-latest
      steps:
         - name: Install azd
         uses: Azure/setup-azd@v0.1.0

Czyszczenie zasobów

Jeśli nie potrzebujesz już zasobów platformy Azure utworzonych w tym artykule, uruchom następujące polecenie:

azd down

Zażądaj pomocy

Aby uzyskać informacje na temat tworzenia usterki, żądania pomocy lub zaproponowania nowej funkcji dla interfejsu wiersza polecenia dla deweloperów platformy Azure, odwiedź stronę rozwiązywania problemów i pomocy technicznej .

Następne kroki

Monitorowanie aplikacji przy użyciu interfejsu wiersza polecenia dla deweloperów platformy Azure (azd)