Rozpocznij od nowego szablonu interfejsu wiersza polecenia dewelopera Azure (azd)

Za pomocą różnych metod tworzenia można utworzyć standardowe pliki w nowym szablonie interfejsu wiersza polecenia dewelopera (azd) Azure:

• Użyj integracji GitHub Copilot w programie azd init. Wbudowany przepływ pracy analizuje istniejące pliki projektu lub ułatwia zaplanowanie nowego projektu, utworzenie zasobów szablonu i uruchomienie weryfikacji wdrożenia wstępnego.
• Użyj innego asystenta kodowania sztucznej inteligencji. Poproś asystenta o utworzenie tego samego azure.yaml, infrastruktury jako kod, aplikacji i plików pomocniczych bez bezpośredniej integracji z azd init.
• Utwórz pliki bezpośrednio. Twórz i edytuj zasoby szablonu samodzielnie, gdy chcesz mieć pełną kontrolę lub jeśli nie używasz asystenta kodowania AI.

Ten artykuł koncentruje się głównie na wbudowanym przepływie pracy GitHub Copilot, ponieważ zapewnia obsługę z przewodnikiem zintegrowaną z azd. Niezależnie od metody tworzenia przejrzyj i zweryfikuj każdy plik przed wdrożeniem.

Wygenerowane zasoby to standardowe, edytowalne azd pliki szablonów. Po zainicjowaniu można je zaktualizować bezpośrednio lub za pomocą dowolnego asystenta kodowania sztucznej inteligencji.

Wymagania wstępne dotyczące GitHub Copilot

Aby użyć wbudowanego przepływu pracy Copilot, potrzebne są następujące elementy:

• Azure Developer CLI w wersji 1.23.11 lub nowszej.
• Aktywna subskrypcja GitHub Copilot.
• Git, którego azd init używa do sprawdzania katalogu roboczego przed zmodyfikowaniem plików.
• Interaktywna sesja terminalu.

Jeśli nie jesteś jeszcze uwierzytelniony(-a) w usłudze GitHub Copilot, azd wyświetli monit o zalogowanie się.

Uruchom polecenie azd version , aby sprawdzić zainstalowaną wersję interfejsu wiersza polecenia dewelopera Azure.

Kompilowanie przy użyciu GitHub Copilot

1. Otwórz terminal w katalogu, w którym chcesz skompilować szablon.

   Note

   Katalog może zawierać istniejącą aplikację, projekt infrastruktury lub pliki początkowe dla nowego rozwiązania. Jeśli katalog zawiera niezatwierdzone zmiany, azd poprosi o potwierdzenie przed kontynuowaniem. Najpierw zatwierdź lub stash ważne zmiany.

2. Uruchom azd init:

   azd init
   

3. Wybierz Skonfiguruj za pomocą usługi GitHub Copilot (Wersja zapoznawcza).

   Monit inicjowania przypomina następujący przykład:

   ? How do you want to initialize your app?
      Scan current directory
      Select a template
   > Set up with GitHub Copilot (Preview)
   

4. Przejrzyj żądany dostęp do narzędzia i udziel dostępu do narzędzi wymaganych dla przepływu pracy. Copilot używa azd oraz możliwości programistycznych platformy Azure do sprawdzenia projektu, utworzenia plików i zweryfikowania rezultatu.

5. Wybierz model i poziom rozumowania, jeśli azd poprosi Cię o ich skonfigurowanie.

   Przy pierwszym uruchomieniu komunikaty używają następujących etykiet. Dostępne opcje modelu i rozumowania zależą od konta GitHub Copilot i wybranego modelu:

   ? Select AI model
   ? Select reasoning effort level
   

6. Opisz, co chcesz skompilować. Uwzględnij odpowiednie wymagania, takie jak:

   • Niezależnie od tego, czy szablon zawiera kod aplikacji, tylko infrastrukturę, czy oba te elementy.
   • Języki i struktury aplikacji, jeśli są znane.
   • Usługi Azure i platforma hostingowa do użycia.
   • Czy używać Bicep czy Terraform.
   • Wymagania dotyczące zabezpieczeń, sieci, skalowania i regionu.

   Przykład:

   Build an infrastructure-only azd template that provisions an Azure Container Apps
   environment, Azure Container Registry, and Log Analytics workspace with Bicep.
   Use managed identity and least-privilege role assignments. Parameterize the location
   and environment name so the template can be reused.
   

7. Odpowiedz na pytania dotyczące architektury lub konfiguracji z Copilot. Agent przygotowuje projekt do Azure, generuje zasoby szablonu i uruchamia walidację przed wdrożeniem.

8. Przejrzyj ogólną strukturę plików, które Copilot utworzył lub zmienił. Upewnij się, że szablon zawiera oczekiwaną konfigurację projektu, katalog infrastruktury, źródło aplikacji i zasoby pomocnicze dla rozwiązania.

   Na przykład wygenerowany szablon tylko do infrastruktury może zawierać następujące pliki klucza:

   azure.yaml
   infra/
   ├── main.bicep
   ├── main.parameters.json
   └── modules/
      ├── container-apps-environment.bicep
      └── container-registry.bicep
   

   Aby uzyskać szczegółowe wskazówki dotyczące przeglądania zawartości konfiguracji i infrastruktury, zobacz Eksplorowanie i edytowanie plików szablonów.

Aprowizuj i wdróż szablon

Po zatwierdzeniu wygenerowanych plików uruchom następujące polecenie:

azd up

Polecenie tworzy lub wybiera środowisko azd, aprowizuje zasoby platformy Azure, pakuje wszelkie usługi aplikacji i wdraża je. Aby uzyskać szczegółowy podział poleceń, zobacz Eksplorowanie azd up przepływu pracy.

Użyj innej metody tworzenia

Inni asystenci AI do kodowania nie są bezpośrednio połączeni z procesem azd init, ale mogą tworzyć te same standardowe zasoby szablonów. Możesz również tworzyć każdy zasób bezpośrednio.

Utwórz te zasoby samodzielnie lub poproś innego asystenta kodowania o przeanalizowanie wymagań i utworzenie ich:

• azure.yaml Plik definiujący projekt i usługi możliwe do wdrożenia.
• Pliki Bicep lub Terraform, które aprowizują wymagane zasoby platformy Azure.
• Dane wyjściowe zasobów i zmienne środowiskowe aplikacji.
• Pliki Dockerfile, konfiguracja wdrożenia i skrypty pomocnicze, jeśli jest to wymagane.

Aby zapewnić minimalny punkt początkowy przed użyciem innego agenta, uruchom polecenie:

azd init --minimal

Jeśli używasz innego asystenta kodowania, poinstruuj go, aby postępował zgodnie ze azure.yaml schematem, Azure praktykami zabezpieczeń infrastruktury oraz konwencjami szablonów opisanymi w szablonach interfejsu wiersza polecenia dla deweloperów Azure. Jeśli tworzysz pliki bezpośrednio, użyj tych samych odwołań co przewodnik implementacji. Przejrzyj i zweryfikuj wszystkie pliki przed uruchomieniem polecenia azd up.

Treści powiązane

• Omówienie tworzenia szablonów
• Eksplorowanie i edytowanie plików szablonów
• Rozpoczynanie od istniejącego szablonu
• Rozszerzanie szablonu
• Eksplorowanie azd init przepływu pracy

Zażądaj pomocy

Aby uzyskać informacje o tym, jak zgłosić usterkę, poprosić o pomoc lub zaproponować nową funkcję dla interfejsu wiersza polecenia dewelopera Azure, odwiedź stronę troubleshooting i pomoc techniczną.