Tworzenie struktury szablonu

Ukończone

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.

  1. W pustym katalogu na komputerze lokalnym uruchom azd init polecenie .

    azd init
    
  2. Dane wyjściowe polecenia wyświetla trzy różne opcje inicjowania szablonu azd:

  • Użyj kodu w bieżącym katalogu: Analizuje on kod Twojej aplikacji, aby utworzyć i skonfigurować określone zasoby szablonu.

  • pl-PL: Wybierz szablon: wybierz istniejący szablon startowy zawierający podstawową strukturę folderów, pliki infrastruktury jako kodu oraz inne standardowe pliki konfiguracyjne, aby usprawnić tworzenie szablonów.

  • Utwórz minimalny projekt: generuje minimalne pliki konfiguracji, aby rozpocząć pracę.

    Przeczytaj więcej na temat tych różnych opcji w dokumentacji Tworzenie szablonów interfejsu wiersza polecenia dla deweloperów platformy Azure.

  1. Wybierz opcję Wybierz szablon, a azd wyświetla wstępnie skonfigurowaną listę dostępnych szablonów.

  2. Wyszukaj Starter, a następnie wybierz opcję Starter — Bicep z listy wyników. 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.

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

  4. Zestaw folderów jest tworzony wewnątrz bieżącego katalogu:

    Struktura szablonu początkowego.

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 :

  • .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.
  • 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.
  • .gitignore — początkowy plik gitignore wykluczający niepożądane pliki z kontroli wersji usługi Git.
  • README.md — początkowy plik README zawierający ogólne wskazówki dla użytkownika końcowego szablonu.

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.