Omówienie tworzenia szablonów w Azure Developer CLI (azd)

Szablony programu Azure Developer CLI (azd) zawierają konfigurację, infrastrukturę oraz opcjonalny kod aplikacji niezbędne do aprowizacji i wdrożenia rozwiązania na platformie Azure. Można użyć szablonu aplikacji, projektu obejmującego wyłącznie infrastrukturę lub wielokrotnego użytku punktu wyjścia dla przyszłych projektów.

Note

Przed rozpoczęciem zapoznaj się z artykułem Szablony Azure Developer CLI, aby uzyskać pełny opis struktury szablonu, wymaganych i opcjonalnych składników, powiązań usług z zasobami oraz sposobu, w jaki polecenia azd używają poszczególnych plików.

Przepływ pracy tworzenia szablonów

Następujący przepływ pracy ma zastosowanie niezależnie od tego, czy tworzysz szablon, czy inicjujesz ten, który już istnieje:

Diagram przepływu pracy tworzenia szablonu azd— od wybrania punktu początkowego przez uruchomienie szablonu azd i jego konserwowanie.

  • Wybierz punkt początkowy:Rozpocznij od nowego szablonu z integracją GitHub Copilot, innym asystentem kodowania sztucznej inteligencji lub bezpośrednim tworzeniem. Alternatywnie zacznij od istniejącego szablonu od Microsoft, organizacji lub społeczności deweloperów.
  • Przeglądanie i edytowanie plików: Zobacz, jak razem działają pliki azure.yaml, Bicep lub Terraform, kod aplikacji i pomocnicza konfiguracja. Zobacz Eksplorowanie i edytowanie plików szablonów.
  • Rozszerz i ewoluuj zgodnie z potrzebami: Dodawanie, zastępowanie, usuwanie lub przeprojektowanie składników aplikacji i infrastruktury. Postępuj zgodnie z instrukcjami w sekcji Rozszerzanie szablonu, aby zobaczyć kompletny przykład dodawania zasobu platformy Azure i łączenia go z aplikacją.
  • Aprowizuj i wdróż: Uruchom polecenie azd up , aby aprowizować infrastrukturę i wdrożyć wszystkie usługi aplikacji. Aby uzyskać więcej informacji, zobacz Eksplorowanie azd up przepływu pracy.
  • Obsługa lub udostępnianie: Kontynuuj edytowanie szablonu w miarę rozwoju projektu. Jeśli planujesz go udostępnić, najpierw przetestuj go w czystym katalogu i przy użyciu nowego azd środowiska.

Note

W tym przepływie pracy możesz tworzyć, edytować lub zastępować pliki szablonów samodzielnie lub z pomocą asystenta kodowania sztucznej inteligencji. Wynik jest tym samym zestawem standardowych, edytowalnych azd zasobów.

Bloki konstrukcyjne szablonu

Każdy azd szablon obsługuje inne rozwiązanie, ale większość szablonów łączy te same typy zasobów:

  • Konfiguracja projektu: Plik azure.yaml identyfikuje projekt, wdrażalne usługi, katalogi źródłowe, cele hostingu oraz opcjonalne hooki lub przepływy pracy.
  • Infrastruktura jako kod: pliki Bicep lub Terraform definiują zasoby Azure, przypisania ról, sieć i ustawienia aplikacji wymagane przez rozwiązanie.
  • Źródło aplikacji: Szablon może zawierać jedną lub więcej wdrażalnych aplikacji albo może zawierać wyłącznie infrastrukturę.
  • Konfiguracja środowiska: Parametry przekazują wartości specyficzne dla środowiska do wdrożeń, a dane wyjściowe infrastruktury stają się wartościami w aktywnym azd środowisku.

Szablon aplikacji może używać następującej struktury folderów:

.
├── azure.yaml                # Project configuration
├── infra/                    # Infrastructure as code
│   ├── main.bicep
│   ├── main.parameters.json
│   └── modules/
├── src/                      # Application source
│   ├── api/
│   └── web/
├── .github/                  # Pipeline workflows
│   └── workflows/
└── README.md

Dokładna struktura różni się w zależności od projektu. Źródło aplikacji, moduły infrastruktury i pliki pipeline’u są opcjonalne, a azure.yaml wskazuje ścieżki używane przez azd. Te zasoby współpracują ze sobą w całym cyklu projektowania szablonu.

Następne kroki

Rozpoczynanie pracy z nowym szablonem

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ą.

  • Last updated on