Udostępnij za pośrednictwem

Poradnik: Tworzenie i wdrażanie pierwszego szablonu ARM

W tym samouczku przedstawiono szablony usługi Azure Resource Manager (szablony usługi ARM). Pokazano w nim, jak utworzyć szablon startowy i wdrożyć go na platformie Azure. Uczy cię o strukturze szablonu i narzędziach potrzebnych do pracy z szablonami. Wykonanie tej instrukcji trwa 12 minut , ale rzeczywisty czas zakończenia zależy od liczby narzędzi, które należy zainstalować.

Ten samouczek jest pierwszy z serii. Podczas przechodzenia przez serię zmodyfikujesz szablon początkowy krok po kroku, aż do eksploracji wszystkich podstawowych części szablonu ARM. Te elementy są blokami konstrukcyjnymi dla bardziej złożonych szablonów. Mamy nadzieję, że do końca serii będziesz mieć pewność, że utworzysz własne szablony i wszystko będzie gotowe do zautomatyzowania wdrożeń przy użyciu szablonów.

Jeśli chcesz dowiedzieć się więcej na temat zalet korzystania z szablonów i dlaczego należy zautomatyzować wdrożenia przy użyciu szablonów, zobacz Omówienie szablonu usługi ARM. Aby dowiedzieć się więcej o szablonach usługi ARM za pomocą zestawu modułów platformy Learn, zobacz Wdrażanie zasobów na platformie Azure i zarządzanie nimi przy użyciu szablonów usługi ARM w formacie JSON.

Jeśli nie masz subskrypcji platformy Microsoft Azure, przed rozpoczęciem utwórz bezpłatne konto .

Wskazówka

Jeśli dopiero zaczynasz korzystać z szablonów ARM, możesz rozważyć uczenie się Bicep. Bicep to nowy język, który oferuje takie same możliwości jak szablony ARM, ale z łatwiejszą składnią. Aby rozpocząć naukę aplikacji Bicep, zobacz Szybki start: tworzenie plików Bicep przy użyciu programu Visual Studio Code.

Pobieranie narzędzi

Zacznijmy od upewnienia się, że masz narzędzia potrzebne do tworzenia i wdrażania szablonów. Zainstaluj te narzędzia na komputerze lokalnym.

Editor

Szablony są plikami JavaScript Object Notation (JSON). Aby utworzyć szablony, możesz użyć programu Visual Studio Code.

Wdrażanie przy użyciu wiersza poleceń

Do wdrożenia szablonu potrzebny jest również program Azure PowerShell lub interfejs azure Command-Line (CLI). Jeśli używasz interfejsu wiersza polecenia platformy Azure, musisz mieć wersję 2.37.0 lub nowszą. Aby uzyskać instrukcje dotyczące instalacji, zobacz:

Po zainstalowaniu programu Azure PowerShell lub interfejsu wiersza polecenia platformy Azure upewnij się, że logujesz się po raz pierwszy. Aby uzyskać pomoc, zobacz Logowanie — PowerShell lub Logowanie — interfejs wiersza polecenia platformy Azure.

Ważne

Jeśli używasz interfejsu wiersza polecenia platformy Azure, upewnij się, że masz wersję 2.37.0 lub nowszą. Jeśli używasz programu Azure PowerShell, upewnij się, że masz wersję 7.2.4 lub nowszą. Polecenia przedstawione w tym samouczku nie działają, jeśli używasz wcześniejszych wersji. Aby sprawdzić zainstalowaną wersję, użyj polecenia: az --version.

W porządku, jesteś gotowy, aby zacząć uczyć się o szablonach.

Tworzenie pierwszego szablonu

  1. Otwórz program Visual Studio Code.

  2. W menu Plik wybierz pozycję Nowy plik , aby utworzyć nowy plik.

  3. W menu Plik wybierz pozycję Zapisz jako.

  4. Nadaj plikowi nazwę azuredeploy i wybierz rozszerzenie pliku json . Pełną nazwą pliku jest azuredeploy.json.

  5. Zapisz plik na stacji roboczej. Wybierz ścieżkę, która jest łatwa do zapamiętania, ponieważ musisz podać tę ścieżkę później podczas wdrażania szablonu.

  6. Skopiuj i wklej następujący kod JSON do pliku:

    {
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": []
}

    Oto jak wygląda środowisko programu Visual Studio Code:

    Zrzut ekranu programu Visual Studio Code, w którym w edytorze przedstawiono pusty szablon ARM z strukturą JSON.

    Ten szablon nie wdraża żadnych zasobów. Zaczynamy od pustego szablonu, aby zapoznać się z krokami wdrażania szablonu przy jednoczesnym zminimalizowaniu prawdopodobieństwa wystąpienia błędu.

    Plik JSON zawiera następujące elementy:

    • $schema: określa lokalizację pliku schematu JSON. W pliku schematu opisano właściwości, które są dostępne w szablonie. Schemat, na przykład, definiuje resources jako jedną z prawidłowych właściwości szablonu. Nie martw się, że data schematu to 2019-04-01. Ta wersja schematu jest aktualna i zawiera wszystkie najnowsze funkcje. Data definicji schematu nie została zmieniona, ponieważ od czasu wprowadzenia nie nastąpiły żadne zmiany łamiące kompatybilność.
    • contentVersion: określa wersję szablonu, taką jak 1.0.0.0. Możesz podać dowolną wartość dla tego elementu. Ta wartość służy do dokumentowania znaczących zmian w szablonie. Podczas wdrażania zasobów przy użyciu szablonu możesz użyć tej wartości, aby upewnić się, że używasz odpowiedniego szablonu.
    • resources: zawiera zasoby, które chcesz wdrożyć lub zaktualizować. Obecnie jest ona pusta, ale możesz dodać zasoby później.

  7. Zapisz plik.

Gratulacje. Udało Ci się utworzyć pierwszy szablon.

Zaloguj się do Azure

Aby rozpocząć pracę z programem Azure PowerShell lub interfejsem wiersza polecenia platformy Azure, zaloguj się przy użyciu poświadczeń platformy Azure.

Wybierz karty w poniższych sekcjach kodu, aby wybrać między programem Azure PowerShell i interfejsem wiersza polecenia platformy Azure. Przykłady CLI w tym artykule są napisane dla powłoki Bash.

Connect-AzAccount

Jeśli masz wiele subskrypcji platformy Azure, wybierz subskrypcję, której chcesz użyć. Zastąp SubscriptionName nazwą swojej subskrypcji. Możesz również użyć identyfikatora subskrypcji zamiast nazwy subskrypcji.

Set-AzContext SubscriptionName

Utwórz grupę zasobów

Podczas wdrażania szablonu można określić grupę zasobów, która będzie zawierać zasoby. Przed uruchomieniem polecenia wdrożenia utwórz grupę zasobów przy użyciu interfejsu wiersza polecenia platformy Azure Bash lub programu Azure PowerShell.

Uwaga / Notatka

Przykłady dla interfejsu wiersza polecenia platformy Azure są napisane dla powłoki bash. Aby uruchomić ten przykład w programie Windows PowerShell lub wierszu polecenia, może być konieczne usunięcie ukośników wstecznych i zapisanie polecenia jako jednego wiersza, takiego jak:

New-AzResourceGroup `
  -Name myResourceGroup `
  -Location "Central US"

Wdrażanie szablonu

Aby wdrożyć szablon, użyj interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell. Użyj utworzonej grupy zasobów. Nadaj nazwę wdrożeniu, aby można je było łatwo zidentyfikować w historii wdrożenia. Dla wygody utwórz również zmienną, która przechowuje ścieżkę do pliku szablonu. Ta zmienna ułatwia uruchamianie poleceń wdrażania, ponieważ nie trzeba ponownie wpisywać ścieżki za każdym razem, gdy wdrażasz. Zastąp {provide-the-path-to-the-template-file} i {} ścieżką do swojego pliku szablonu.

$templateFile = "{provide-the-path-to-the-template-file}"
New-AzResourceGroupDeployment `
  -Name blanktemplate `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

Polecenie wdrożenia zwraca wyniki. Sprawdź ProvisioningState, czy wdrożenie zakończyło się pomyślnie.

Uwaga / Notatka

Jeśli wdrożenie zakończy się niepowodzeniem, użyj przełącznika verbose , aby uzyskać informacje o tworzonych zasobach. Użyj przełącznika debug , aby uzyskać więcej informacji na temat debugowania.

Weryfikowanie wdrożenia

Wdrożenie można zweryfikować, eksplorując grupę zasobów w witrynie Azure Portal.

  1. Zaloguj się do witryny Azure Portal.

  2. W menu po lewej stronie wybierz pozycję Grupy zasobów.

  3. Zaznacz pole wyboru po lewej stronie grupy myResourceGroup i wybierz pozycję myResourceGroup.

  4. Wybierz grupę zasobów utworzoną we wcześniejszej procedurze. Domyślną nazwą jest myResourceGroup. Grupa zasobów nie ma jeszcze żadnych zasobów, ponieważ wdrożono pusty szablon.

  5. Zwróć uwagę, że w środku przeglądu, w sekcji Podstawowe, strona wyświetla stan wdrożenia obok Wdrożenia. Wybierz pozycję 1 Powiodło się.

    Zrzut ekranu witryny Azure Portal przedstawiający stan wdrożenia w sekcji Podstawy grupy zasobów.

  6. Zostanie wyświetlona historia wdrożenia dla grupy zasobów. Zaznacz pole wyboru po lewej stronie blanktemplate i wybierz blanktemplate.

    Zrzut ekranu portalu Azure przedstawiający historię wdrażania z wybranym wdrożeniem

  7. Zostanie wyświetlone podsumowanie wdrożenia. W takim przypadku nie ma zbyt wiele do wyświetlenia, ponieważ nie są wdrażane żadne zasoby. W dalszej części tej serii warto przejrzeć podsumowanie w historii wdrażania. Zwróć uwagę, że po lewej stronie widać dane wejściowe, dane wyjściowe i szablon używany przez wdrożenie.

    Zrzut ekranu portalu Azure przedstawiający podsumowanie wdrożenia dla szablonu blanktemplate.

Uprzątnij zasoby

Jeśli przejdziesz do następnego samouczka, nie musisz usuwać grupy zasobów.

Jeśli teraz zatrzymasz się, możesz usunąć grupę zasobów.

  1. W witrynie Azure Portal wybierz pozycję Grupy zasobów z menu po lewej stronie.

  2. Wpisz nazwę grupy zasobów w polu tekstowym Filtruj dla dowolnego pola ...

  3. Zaznacz pole wyboru obok pozycji myResourceGroup i wybierz pozycję myResourceGroup lub nazwę grupy zasobów.

  4. Wybierz pozycję Usuń grupę zasobów z górnego menu.

    Zrzut ekranu witryny Azure Portal z wyróżnioną opcją Usuń grupę zasobów w widoku grupy zasobów.

Dalsze kroki

Utworzono prosty szablon do wdrożenia na platformie Azure. W następnym samouczku dowiesz się, jak dodać konto magazynowe do szablonu i wdrożyć je do grupy zasobów.

Dodaj zasób

  • Last updated on