Jak wdrożyć projekt Aspire przy użyciu Azure Developer CLI

• Azure organizację DevOps lub wybierz istniejącą organizację
• Utwórz Azure osobisty token dostępu DevOps (PAT) i zapisz go do późniejszego użycia. Skonfiguruj token z następującymi uprawnieniami:
  • Zasoby agentów (odczyt, zarządzanie)
  • Kompilacja (odczyt i uruchomienie)
  • Kod (pełny)
  • Projekt i zespół (czytanie, pisanie i zarządzanie)
  • Wydanie (odczyt, zapis, wykonywanie i zarządzanie)
  • Połączenia usług (odczyt, wykonywanie zapytań i zarządzanie)

Utwórz repozytorium GitHub i potok

Azure Developer CLI umożliwia automatyczne tworzenie potoków CI/CD z prawidłowymi konfiguracjami i uprawnieniami, aby aprowizować i wdrażać zasoby do Azure. azd również można utworzyć repozytorium GitHub dla Twojej aplikacji, jeśli jeszcze nie istnieje.

1. Uruchom polecenie azd pipeline config, aby skonfigurować potok wdrażania i bezpiecznie połączyć go z Azure:

   azd pipeline config
   

2. Wybierz subskrypcję, w ramach której chcesz aprowizować i wdrożyć zasoby aplikacji.

3. Wybierz lokalizację Azure, która ma być używana dla zasobów.

4. Gdy zostanie wyświetlony monit o utworzenie nowego repozytorium Git w katalogu, wprowadź y i naciśnij Enter.

   Uwaga / Notatka

   Utworzenie repozytorium GitHub wymaga zalogowania się do GitHub. Istnieje kilka opcji, które różnią się w zależności od preferencji. Po zalogowaniu zostanie wyświetlony monit o utworzenie nowego repozytorium w bieżącym katalogu.

5. Wybierz pozycję Utwórz nowe prywatne repozytorium GitHub, aby skonfigurować zdalny serwer git.

6. Wprowadź wybraną nazwę nowego repozytorium GitHub lub naciśnij Enter, aby użyć nazwy domyślnej. azd tworzy nowe repozytorium w GitHub i konfiguruje je z niezbędnymi tajnymi danymi wymaganymi do uwierzytelnienia w Azure.

   

7. Wprowadź y, aby przejść dalej, gdy zostaniesz poproszony przez azd o zatwierdzenie i wypchnięcie lokalnych zmian w celu uruchomienia skonfigurowanego potoku.

Eksploruj przepływ pracy i wdrażanie Actions GitHub

1. Przejdź do nowego repozytorium GitHub, korzystając z linku, który został wyświetlony przez azd.

2. Wybierz kartę Akcje, aby wyświetlić przepływy pracy repozytorium. Powinieneś zobaczyć nowy przepływ pracy albo uruchomiony, albo już ukończony. Wybierz przepływ pracy, aby wyświetlić kroki zadania i szczegóły w dziennikach przebiegu. Możesz na przykład rozwinąć kroki, takie jak Wdrażanie aplikacji , aby wyświetlić szczegóły ukończonej akcji.

   

3. Wybierz Zainstaluj aplikację, aby rozwinąć logi dla tego kroku. Powinny być wydrukowane dwa adresy URL punktów końcowych dla apiservice i webfrontend. Wybierz jeden z tych linków, aby otworzyć go na innej karcie przeglądarki i zapoznać się z wdrożoną aplikacją.

   

Gratulacje! Pomyślnie wdrożono projekt Aspire za pomocą Akcji Azure Developer CLI i GitHub.

Konfigurowanie katalogu roboczego dla rozwiązań obejmujących wiele projektów

W przypadku dodawania GitHub akcji do istniejącego rozwiązania obejmującego wiele projektów Aspire , w którym projekt AppHost nie znajduje się w katalogu głównym, może być konieczne skonfigurowanie parametru working-directory dla określonych kroków przepływu pracy. W tej sekcji wyjaśniono, kiedy i jak wprowadzić te korekty.

Gdy wymagana jest konfiguracja katalogu roboczego

Polecenie azd pipeline config generuje GitHub workflow Akcji, który zakłada, że projekt AppHost znajduje się w katalogu głównym repozytorium. Jednak w wielu rzeczywistych scenariuszach, zwłaszcza podczas dodawania Aspire do istniejących aplikacji, projekt AppHost może znajdować się w podkatalogu.

Jeśli na przykład struktura repozytorium wygląda następująco:

└───📂 MyAspireApp
    ├───📂 MyAspireApp.ApiService
    ├───📂 MyAspireApp.AppHost
    │    ├─── MyAspireApp.AppHost.csproj
    │    └─── AppHost.cs
    ├───📂 MyAspireApp.Web
    └─── MyAspireApp.sln

Wygenerowane kroki przepływu pracy dla aprowizowania infrastruktury i wdrażania aplikacji muszą być uruchamiane z MyAspireApp.AppHost katalogu, a nie z katalogu głównego repozytorium.

Aktualizowanie przepływu pracy dla Akcji

Po uruchomieniu azd pipeline configprogramu sprawdź wygenerowany plik przepływu pracy w pliku .github/workflows/azure-dev.yml. Zidentyfikuj kroki uruchamiające polecenia azd i w razie potrzeby dodaj parametr working-directory.

Oto przykład oryginalnych wygenerowanych kroków:

- name: Provision Infrastructure
  run: azd provision --no-prompt
  env:
    AZURE_ENV_NAME: ${{ vars.AZURE_ENV_NAME }}
    AZURE_LOCATION: ${{ vars.AZURE_LOCATION }}
    AZURE_SUBSCRIPTION_ID: ${{ vars.AZURE_SUBSCRIPTION_ID }}

- name: Deploy Application
  run: azd deploy --no-prompt
  env:
    AZURE_ENV_NAME: ${{ vars.AZURE_ENV_NAME }}
    AZURE_LOCATION: ${{ vars.AZURE_LOCATION }}
    AZURE_SUBSCRIPTION_ID: ${{ vars.AZURE_SUBSCRIPTION_ID }}

Zaktualizuj następujące kroki, aby uwzględnić working-directory parametr:

- name: Provision Infrastructure
  run: azd provision --no-prompt
  working-directory: ./MyAspireApp.AppHost
  env:
    AZURE_ENV_NAME: ${{ vars.AZURE_ENV_NAME }}
    AZURE_LOCATION: ${{ vars.AZURE_LOCATION }}
    AZURE_SUBSCRIPTION_ID: ${{ vars.AZURE_SUBSCRIPTION_ID }}

- name: Deploy Application
  run: azd deploy --no-prompt
  working-directory: ./MyAspireApp.AppHost
  env:
    AZURE_ENV_NAME: ${{ vars.AZURE_ENV_NAME }}
    AZURE_LOCATION: ${{ vars.AZURE_LOCATION }}
    AZURE_SUBSCRIPTION_ID: ${{ vars.AZURE_SUBSCRIPTION_ID }}

Znajdowanie poprawnego katalogu roboczego

Katalog roboczy powinien wskazywać na folder zawierający projekt Aspire AppHost (projekt zawierający plik azure.yaml, wygenerowany przez program azd init). Ten katalog można zidentyfikować, wykonując następujące czynności:

1. Wyszukaj projekt, który ma odwołanie do pakietu Aspire.AppHost w pliku .csproj.
2. Znajdź katalog zawierający plik azure.yaml .
3. Znajdź projekt, do którego odwołuje się rozwiązanie, które organizuje inne usługi.

Utwórz repozytorium i potok Azure DevOps

Azure Developer CLI umożliwia automatyczne tworzenie potoków z prawidłowymi konfiguracjami i uprawnieniami do aprowizowania i wdrażania zasobów w Azure. azd może również utworzyć repozytorium Azure Pipelines dla aplikacji, jeśli jeszcze nie istnieje.

1. Uruchom polecenie azd pipeline config, aby skonfigurować potok wdrażania i bezpiecznie połączyć go z Azure. Uwzględnij opcję --provider azdo, aby użyć Azure Pipelines zamiast domyślnej konfiguracji GitHub Actions.

   azd pipeline config --provider azdo
   

   Ważne

   Przed uruchomieniem azd pipeline configprogramu upewnij się, że pomyślnie uruchomiono azd init , aby zainicjować projekt. Jeśli podczas wykonywania potoku wystąpią błędy, takie jak "brak projektu", zobacz sekcję rozwiązywania problemów, aby znaleźć rozwiązania.

2. Wybierz subskrypcję, w ramach której chcesz aprowizować i wdrożyć zasoby aplikacji.

3. Wybierz lokalizację Azure, która ma być używana dla zasobów.

4. Wklej utworzony wcześniej osobisty token dostępu.

5. Wprowadź nazwę organizacji Azure DevOps utworzoną lub wybraną.

6. Po wyświetleniu monitu o utworzenie nowego repozytorium w bieżącym katalogu wprowadź i i naciśnij Enter.

7. Po wyświetleniu monitu o skonfigurowanie zdalnego repozytorium Git wybierz pozycję Utwórz nowy projekt Azure DevOps.

8. Wprowadź unikatową nazwę nowego repozytorium, na przykład aspireazd. azd tworzy nowe repozytorium w usłudze Azure Repos i konfiguruje je z użyciem niezbędnych tajnych danych wymaganych do uwierzytelniania z Azure.

   

9. Wprowadź y, aby przejść dalej, gdy zostaniesz poproszony przez azd o zatwierdzenie i wypchnięcie lokalnych zmian w celu uruchomienia skonfigurowanego potoku.

Zbadaj potok danych i aplikację

1. Przejdź do nowego pipeline'u Azure, korzystając z linku statusu dostarczonego przez azd.

   

2. Wybierz ukończone uruchomienie potoku, aby wyświetlić podsumowanie.

   

3. Wybierz link zadania w dolnej części widoku, aby przejść do szczegółów zadania.

   

4. Na stronie szczegółów zadania jest wyświetlany stan wszystkich poszczególnych etapów. Wybierz pozycję Aprowizacja infrastruktury, aby wyświetlić dzienniki dla tego etapu, które szczegółowo opisują wszystkie kroki aprowizacji wykonane przez azd. W dolnej części dzienników zanotuj końcowy komunikat o stanie i połącz się z aprowizowaną grupą zasobów Azure.

5. Wybierz link na dole dzienników wyników aprowizacji, aby nawigować do nowej grupy zasobów Azure.

   

   Uwaga / Notatka

   Możesz również przejść bezpośrednio do nowej grupy zasobów, wyszukując ją w portalu Azure. Nazwa grupy zasobów będzie nazwą środowiska, którą podałeś do azd z prefiksem rg-.

6. Wybierz kontenerową aplikację webfrontend, która hostuje część witryny dostępną publicznie.

7. Na stronie szczegółów webfrontend wybierz link Application Url, aby otworzyć swoją witrynę w przeglądarce.

Gratulacje! Pomyślnie wdrożono projekt Aspire przy użyciu Azure Developer CLI i Azure Pipeline'y.

Rozwiązywanie problemów z wdrażaniem Azure potoku DevOps

W tej sekcji opisano typowe problemy, które mogą wystąpić podczas wdrażania Aspire projektów przy użyciu Azure potoków DevOps.

BŁĄD: żaden projekt nie istnieje; aby utworzyć nowy projekt, uruchom azd init

Problem: Podczas kroku aprowizacji potoku Azure DevOps występuje komunikat o błędzie:

ERROR: no project exists; to create a new project, run azd init

Przyczyna: Ten błąd występuje, ponieważ azd init polecenie generuje pliki (azure.yaml i .azure folder), które zwykle nie są zatwierdzane w repozytorium. Gdy potok działa w czystym środowisku, te pliki nie istnieją, co powoduje, że polecenia azd zawodzą.

Rozwiązanie: Istnieje kilka podejść do rozwiązania tego problemu:

Opcja 1: Uruchom azd init w potoku (Zalecane)

azd init Dodaj krok do Azure potoku DevOps przed krokiem aprowizacji. Możesz użyć flag --from-code i --no-prompt, aby uruchomić polecenie nieinteraktywnie.

- task: AzureCLI@2
  displayName: 'Initialize Azure Developer CLI'
  inputs:
    azureSubscription: '$(AZURE_SERVICE_CONNECTION)'
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: |
      azd init --from-code --no-prompt
      azd env new $(AZURE_ENV_NAME) --location $(AZURE_LOCATION) --subscription $(AZURE_SUBSCRIPTION_ID)

Pamiętaj, aby zdefiniować następujące zmienne w potoku danych:

• AZURE_ENV_NAME: Nazwa środowiska (na przykład dev lub prod).
• AZURE_LOCATION: Twój Azure region (na przykład eastus2).
• AZURE_SUBSCRIPTION_ID: Identyfikator Azure subskrypcji.

Opcja 2. Zatwierdzanie wymaganych plików w repozytorium

Jeśli wolisz zatwierdzić wygenerowane pliki w repozytorium:

1. Uruchom azd init lokalnie w katalogu projektu.
2. Dodaj wygenerowany azure.yaml plik do repozytorium.
3. Opcjonalnie dodaj .azure folder do repozytorium, jeśli chcesz zachować ustawienia specyficzne dla środowiska.

Opcja 3: Użyj konfiguracji potoku azd z odpowiednią inicjalizacją

Upewnij się, że uruchamiasz azd pipeline config --provider azdo po tym jak pomyślnie uruchomisz azd init lokalnie. To polecenie powinno skonfigurować rurociąg za pomocą właściwej konfiguracji, która automatycznie obsługuje inicjalizację.

Jeśli nadal występują problemy, sprawdź, czy:

• Struktura projektu odpowiada temu, czego azd oczekuje w projektach Aspire.
• Uruchamiasz polecenia z odpowiedniego katalogu (zazwyczaj tam, gdzie znajduje się twój plik .sln).
• Połączenie Azure usługi DevOps ma niezbędne uprawnienia do tworzenia zasobów.