Tworzenie struktury szablonu
Interfejs wiersza polecenia dla deweloperów platformy Azure (azd
) ułatwia tworzenie nowych szablonów dla aplikacji przy użyciu azd init
szablonów poleceń i szablonów startowych. W tej lekcji utworzysz podstawowy szkielet lub strukturę nowego szablonu, który zostanie utworzony w pozostałej części modułu.
W pustym katalogu na komputerze lokalnym uruchom
azd init
polecenie .azd init
W danych wyjściowych polecenia zostanie wyświetlona lista szablonów startowych i opcji pełnej przykładowej aplikacji. Szablony początkowe obejmują podstawową strukturę folderów, infrastrukturę początkową jako pliki kodu i inne pliki konfiguracji standardowy, aby rozpocząć tworzenie szablonów. Pełne przykładowe szablony obejmują również kod aplikacji zastępczych i pliki potrzebne do ich wdrożenia. W tym module dowiesz się, jak utworzyć własny szablon zamiast modyfikować istniejący kod aplikacji, więc wybierz opcję Starter — Bicep z listy. Interfejs wiersza polecenia dla deweloperów platformy Azure obsługuje również korzystanie z narzędzia Terraform , jeśli wolisz tę opcję. Obsługa narzędzia Terraform jest obecnie w wersji alfa i musi być włączona ręcznie.
Po wyświetleniu monitu o nazwę środowiska wprowadź azdlearn lub nazwę wybranej nazwy. Nazwa środowiska ma wpływ na nazewnictwo zaaprowizowanych zasobów na platformie Azure.
Zestaw folderów jest tworzony wewnątrz bieżącego katalogu:
Uwaga
Być może azd init
polecenie zawiera również szablon projektu o nazwie Minimum, który zawiera najprostszą strukturę szablonu. Jednak wybrany szablon Starter — Bicep zawiera dodatkowy kod szkieletu, który jest bardzo przydatny, ale nadal niezależny od technologii, dlatego często jest doskonałym wyborem do rozpoczęcia pracy.
Wygenerowane foldery zawierają wszystkie podstawowe bloki konstrukcyjne szablonu azd
:
- .azdo — folder zawierający pliki konfiguracji początkowej
.yml
ciągłej integracji/ciągłego wdrażania za pomocą usługi Azure Pipelines. - .azure — folder zawierający podstawowe ustawienia dla środowiska platformy Azure szablonu, taki jak nazwa środowiska.
- .devcontainer — folder zawierający pliki konfiguracji używane do uruchamiania szablonu w środowisku kontenera deweloperskiego.
- .github — folder zawierający szablon konfiguracji początkowej
.yml
do skonfigurowania potoku ciągłej integracji/ciągłego wdrażania za pomocą akcji usługi GitHub. - infra — folder zawierający początkowe pliki Bicep dla infrastruktury szablonu jako kod. W przypadku wybrania szablonu startowego narzędzia Terraform ten folder zawiera zamiast tego pliki Terraform.
- azure.yaml — plik opisujący sposób mapowania części aplikacji na usługi na platformie Azure.
Ten szablon początkowy zawiera większość elementów potrzebnych do utworzenia własnego azd
szablonu. W kolejnych kilku lekcjach dowiesz się, jak zaktualizować te istniejące pliki i dodać nowe zasoby w celu utworzenia kompletnego szablonu.