Tworzenie minimalnego szablonu przy użyciu funkcji redagowania interfejsu wiersza polecenia dla deweloperów platformy Azure

Funkcja komponowania (redagowania) interfejsu wiersza polecenia dla deweloperów platformy Azure umożliwiaazd stopniowe tworzenie zasobów platformy Azure wymaganych dla aplikacji bez ręcznego pisania kodu Bicep. Z tego artykułu dowiesz się, jak pracować z funkcją redagowania w celu utworzenia minimalnego szablonu. Aby uzyskać więcej informacji koncepcyjnych na temat tej funkcji, odwiedź artykuł z omówieniem redagowania.azd

Uwaga / Notatka

Funkcja azd redagowania jest obecnie w wersji alfa i nie powinna być używana w aplikacjach produkcyjnych. Zmiany funkcji alfa w kolejnych wersjach mogą powodować zmiany powodujące niezgodność. Aby uzyskać więcej informacji, odwiedź strony wersjonowania funkcji azd i strategii wydawania oraz etapów funkcji. Użyj przycisku Opinia w prawym górnym rogu, aby podzielić się opinią compose na temat funkcji i tego artykułu.

Praca z funkcją redagowania

Uzyskaj dostęp do azd funkcji redagowania za pomocą azd add polecenia . Polecenie azd add działa z szablonami utworzonymi przy użyciu następujących azd init przepływów pracy:

• Użyj kodu w bieżącym katalogu (w przypadku aplikacji przeznaczonych dla usługi Azure Container Apps do hostingu)
• Tworzenie minimalnego projektu

Szablony inicjowane za pomocą przepływu Wybieranie szablonu nie są obecnie obsługiwane. Funkcja azd komponowania zarządza infrastrukturą i nie jest zgodna z szablonami, które mają istniejące zasoby folderów infra. Odwiedź artykuł Generowanie kodu Bicep oraz stronę przepływy pracy tworzenia szablonu, aby uzyskać więcej informacji.

Wykonaj następujące kroki, aby dodać nowe zasoby do szablonu bez konieczności pisania kodu:

1. W oknie terminalu przejdź do folderu głównego swojego szablonu azd.

2. Uruchom polecenie , azd add aby dodać nowy zasób i uruchomić przepływ pracy redagowania:

   azd add
   

3. Wybierz jeden z obsługiwanych zasobów, które chcesz dodać do aplikacji. W tym przykładzie wybierz pozycję Database.

   ? What would you like to add? [Use arrows to move, type to filter]
   > AI
     Database
     Host service
     Key Vault
     Messaging
     Storage account
     ~Existing resource
   

4. Dla typu bazy danych wybierz pozycję PostgreSQL.

   ? Which type of database?  [Use arrows to move, type to filter]
     MongoDB
   > PostgreSQL
     Redis
   

5. Wprowadź nazwę nowego zasobu, na przykład azddb.

   ? Input the name of the app database (PostgreSQL)
   

6. Jeśli aplikacja zawiera usługi, zostanie wyświetlony monit o wybranie usługi korzystającej azd z tego zasobu.

   ? Select the service(s) that uses this resource
   > [✓]  webfrontend
   

7. azd generuje podgląd wymaganych zmian w azure.yaml pliku. Naciśnij Enter , aby zaakceptować i zastosować zmiany.

   Previewing changes to azure.yaml:
   
   +  azddata:
   +      type: db.postgres
   
      webfrontend:
          type: host.containerapp
          uses:
              - azddb
   +          - azddata
          port: 80
   

8. Uruchom polecenie , azd up aby aprowizować wszelkie zmiany wprowadzone za pomocą azd add polecenia . W tym przykładzie azd aprowizuje bazę danych PostgreSQL na platformie Azure.

9. Uruchom ponownie polecenie, azd add aby dodać inne zasoby, takie jak usługa OpenAI.

Zbadaj plik azure.yaml

azure.yaml to plik konfiguracji używany azd do zarządzania aplikacją. azd zarządza usługami i zasobami skomponowanymi poprzez polecenie azd add przy użyciu odpowiednich węzłów services i resources. Rozważmy następujący przykład azure.yaml pliku zaktualizowanego całkowicie za pomocą polecenia azd add:

name: azdcomposesample
metadata:
  template: azd-init@1.11.0
services:
  webfrontend:
    project: src
    host: containerapp
    language: dotnet
resources:
  webfrontend:
    type: host.containerapp
    port: 80
    uses:
      - azdsql
      - azdchat
  azdsql:
    type: db.postgres
  azdchat:
    type: ai.openai.model
    model:
      name: gpt-4o
      version: "2024-08-06"

• Węzeł services deklaruje:
  • Mapowanie wdrożenia o nazwie webfrontend między aplikacją webową .NET w katalogu src oraz usłudze Azure Container Apps.
• Węzeł resources deklaruje:
  • Aplikacja kontenera platformy Azure i pasujące mapowanie zależności o nazwie webfrontend między hostowaną aplikacją kontenera platformy .NET a bazą danych i usługą sztucznej inteligencji, od której zależy. Węzeł uses mapuje aplikację na inne zasoby, od których zależy.
  • Zasób usługi Azure Database for PostgreSQL o nazwie azdsql.
  • Zasób usługi Azure OpenAI o nazwie azdchat.

Dalsze kroki

Generowanie kodu Bicep przy użyciu funkcji redagowania