Utwórz potok CI/CD w GitHub Actions przy użyciu Azure Developer CLI

W tym artykule dowiesz się, jak wykorzystać interfejs wiersza polecenia dla deweloperów Azure (azd) do utworzenia potoku CI/CD GitHub Actions dla szablonu azd. Ten ciąg przetwarzania umożliwia przesyłanie aktualizacji szablonów do repozytorium kodu i automatyczne aprowizowanie oraz wdrażanie Twoich zmian w środowisku platformy Azure.

Note

Polecenie azd pipeline config jest w wersji beta. Aby uzyskać szczegółowe informacje, zobacz strategię obsługi wersji i wydawania funkcji.

Prerequisites

• Instalowanie interfejsu wiersza polecenia dla deweloperów platformy Azure
• Visual Studio Code (opcjonalnie do edycji plików)
• Konto usługi GitHub
• Subskrypcja platformy Azure

Inicjowanie szablonu

W tym przykładzie użyto szablonu Hello-AZD, ale można wykonać te kroki dla dowolnego szablonu azd zawierającego plik definicji potoku (zazwyczaj znajdującego się w folderach .github lub .azdo).

1. W pustym katalogu zainicjuj hello-azd szablon:

   azd init -t hello-azd
   

2. Po wyświetleniu monitu wprowadź nazwę środowiska, taką jak helloazd.

Utwórz rurociąg za pomocą GitHub Actions

Wykonaj następujące kroki, aby utworzyć i skonfigurować pipeline:

1. W terminalu w katalogu głównym szablonu uruchom polecenie:

   azd pipeline config
   

2. Po wyświetleniu monitu o wybranie dostawcy wybierz pozycję GitHub.

   ? Select a provider:  [Use arrows to move, type to filter]
   > GitHub
     Azure DevOps
   

3. Wybierz żądaną subskrypcję platformy Azure i region.

4. Po wyświetleniu monitu o skonfigurowanie repozytorium zdalnego wybierz pozycję Utwórz nowe prywatne repozytorium GitHub. Jeśli masz istniejący projekt, którego chcesz użyć, możesz również wybrać pozycję Wybierz istniejący projekt GitHub.

   ? How would you like to configure your git remote to GitHub?  [Use arrows to move, type to filter]
     Select an existing GitHub project
   > Create a new private GitHub repository
     Enter a remote URL directly
   

5. Wprowadź nazwę nowego repozytorium.

6. Po wyświetleniu monitu o zatwierdzenie i wypchnięcie lokalnych zmian, aby rozpocząć nowe uruchomienie GitHub Actions, wpisz y.

7. Przejrzyj dane wyjściowe w terminalu. Polecenie azd pipeline config wyświetla nazwę repozytorium GitHub dla projektu.

   Note

   Domyślnie azd pipeline config konfiguruje OpenID Connect (OIDC), nazywane również poświadczeniami federacyjnymi. Aby zamiast tego użyć poświadczeń klienta, 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.

8. W przeglądarce otwórz repozytorium GitHub dla projektu.

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

   

Przetestuj potok ze zmianą kodu

1. W katalogu projektu /src/components/pages otwórz plik Home.razor.

2. Znajdź tekst nagłówka Hello AZD! w górnej części pliku.

3. Zmień tekst na Hello, pipeline!.

4. Zapisz plik.

5. Zatwierdź i prześlij swoją zmianę. Ta akcja wyzwala potok zadań GitHub Actions w celu wdrożenia aktualizacji.

   

6. W przeglądarce otwórz repozytorium GitHub projektu, aby zobaczyć:

   • Your commit
   • Komit z konfiguracji GitHub Actions

   

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

   

8. Aby wyświetlić wdrożoną aktualizację, odwiedź adres URL frontonu internetowego podany w danych wyjściowych azd .

Użyj azd jako akcji GitHub

Możesz zainstalować azd jako akcję usługi GitHub, używając akcji setup-azd. Aby go użyć, dodaj następujące elementy do pliku .github/workflows/azure-dev.yml :

on: [push]

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

Note

Sprawdź setup-azd releases, aby uzyskać najnowszy numer wersji.

Uprzątnij zasoby

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

azd down

To polecenie usuwa wszystkie zasoby platformy Azure skojarzone z projektem.

Next steps

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