Konfigurowanie i używanie źródeł szablonów

Interfejs wiersza polecenia dla deweloperów platformy Azure jest przeznaczony dla zaawansowanego systemu szablonów, który usprawnia wdrażanie i aprowizowanie zasobów platformy Azure. Podczas opracowywania za pomocą azdprogramu możesz utworzyć własny szablon lub wybrać jedną z konfigurowalnych list istniejących szablonów. Z tego artykułu dowiesz się, jak pracować z listami szablonów i skonfigurować instalację lokalną azd w celu obsługi różnych źródeł listy szablonów.

Informacje o źródłach szablonów

Źródło azd szablonu wskazuje plik konfiguracji JSON, który opisuje listę dostępnych szablonów i ich podstawowych metadanych, takich jak tytuł, opis i lokalizacja kodu źródłowego szablonu (zazwyczaj repozytorium GitHub). Po włączeniu źródła szablonu zdefiniowane przez niego szablony są udostępniane azd za pomocą innych poleceń. Na przykład poniższy fragment kodu JSON źródła szablonu definiuje dwa szablony:

[
  {
    "title": "Starter - Bicep",
    "description": "A starter template with Bicep as infrastructure provider",
    "preview": "./templates/images/test.png",
    "website": "https://github.com/Azure/azure-dev",
    "author": "Azure Dev",
    "source": "https://github.com/Azure-Samples/azd-starter-bicep",
    "tags": ["bicep", "msft"]
  },
  {
    "title": "Starter - Terraform",
    "description": "A starter template with Terraform as infrastructure provider",
    "preview": "./templates/images/test.png",
    "website": "https://github.com/Azure/azure-dev",
    "author": "Azure Dev",
    "source": "https://github.com/Azure-Samples/azd-starter-terraform",
    "tags": ["terraform", "msft"]
  }
}

azd umożliwia jednoczesne włączenie wielu źródeł szablonów. Dostępne są obecnie następujące opcje źródła szablonu:

• awesome-azd — lista szablonów z galerii Awesome AZD, która jest domyślnie włączona.
• default — mały zestaw wyselekcjonowanych szablonów do zademonstrowania różnych stosów technologicznych.
• file — ścieżka lokalna/sieciowa wskazująca źródłowy plik konfiguracji JSON szablonu.
• url — ścieżka adresowalna HTTP wskazująca źródłowy plik konfiguracji JSON szablonu.
• gh — wskazuje repozytorium GitHub.
• ade — wskazuje listę szablonów środowiska wdrażania platformy Azure. Dowiedz się więcej o obsłudze interfejsu wiersza polecenia dla deweloperów platformy Azure dla środowisk wdrażania platformy Azure.

Praca ze źródłami szablonów

azd Udostępnia kilka poleceń do konfigurowania źródeł szablonów.

Użyj polecenia , azd template source list aby wyświetlić listę wszystkich aktualnie skonfigurowanych źródeł szablonów:

azd template source list

Przykładowe dane wyjściowe z dwoma skonfigurowanymi źródłami szablonów:

Key          Name         Type         Location

awesome-azd  Awesome AZD  awesome-azd  https://aka.ms/awesome-azd/templates.json
default      Default      resource

Użyj polecenia , azd template source add aby dodać nowe źródło szablonu. To polecenie akceptuje następujące parametry:

• key: nazwa techniczna źródła szablonu.
• --type, -t: Typ źródła szablonu — prawidłowe wartości to plik, adres URL i gh dla usługi GitHub.
• --location, -l: lokalizacja źródłowa szablonu, która powinna być siecią lokalną lub identyfikatorem URI internetowym HTTP(S).
• --displayName, -n: nazwa wyświetlana źródła szablonu (opcjonalnie, będzie używać klucza , jeśli pominięto).

azd template source add <key> --type <file-or-url> --location <your-uri> --displayname <your-display-name>

Użyj polecenia , azd template source remove aby usunąć źródło szablonu:

azd template source remove <key>

Użyj polecenia , azd config reset aby zresetować konfigurację szablonu z powrotem do ustawień domyślnych:

azd config reset

Praca z listami szablonów

Po skonfigurowaniu źródeł szablonów użyj azd template list polecenia , aby wyświetlić listę dostępnych szablonów z tych źródeł:

azd template list

Na przykład domyślna instalacja listy azd następujących szablonów ze źródła szablonu awesome-azd :

Name                                                         Source       Repository Path

Event Driven Java Application with Azure Service Bus         Awesome AZD  Azure-Samples/ASA-Samples-Event-Driven-Application
Static React Web App with Java API and PostgreSQL            Awesome AZD  Azure-Samples/ASA-Samples-Web-Application
SAP CAP on Azure App Service Quickstart                      Awesome AZD  Azure-Samples/app-service-javascript-sap-cap-quickstart
SAP Cloud SDK on Azure App Service Quickstart (TypeScript)   Awesome AZD  Azure-Samples/app-service-javascript-sap-cloud-sdk-quickstart
Java Spring Apps with Azure OpenAI                           Awesome AZD  Azure-Samples/app-templates-java-openai-springapps
WordPress with Azure Container Apps                          Awesome AZD  Azure-Samples/apptemplate-wordpress-on-ACA
Bicep template to bootstrap Azure Deployment Environments    Awesome AZD  Azure-Samples/azd-deployment-environments
Starter - Bicep                                              Awesome AZD  Azure-Samples/azd-starter-bicep
Starter - Terraform                                          Awesome AZD  Azure-Samples/azd-starter-terraform
...
# Additional templates omitted 

Dołącz flagę --source do listy tylko z określonego źródła:

azd template list --source <source-name>

Aby zainicjować szablon z wyświetlonej listy, uruchom azd init polecenie i podaj ścieżkę szablonu:

azd init --template <path-value>

Praca ze środowiskami wdrażania platformy Azure

Interfejs wiersza polecenia dla deweloperów platformy Azure (azd) zapewnia również obsługę środowisk wdrażania platformy Azure. Środowisko wdrażania platformy Azure (ADE) to wstępnie skonfigurowana kolekcja zasobów platformy Azure wdrożonych w wstępnie zdefiniowanych subskrypcjach. Zarządzanie platformą Azure jest stosowane do tych subskrypcji na podstawie typu środowiska, takiego jak piaskownica, testowanie, przemieszczanie lub produkcja. Za pomocą środowisk wdrażania platformy Azure można wymuszać zasady zabezpieczeń przedsiębiorstwa i udostępniać wyselekcjonowany zestaw wstępnie zdefiniowanych szablonów infrastruktury jako kodu (IaC).

Integracja usługi ADE wykracza poza zakres tego artykułu. Dowiedz się więcej na temat konfigurowania ade obsługi interfejsu wiersza polecenia dla deweloperów platformy Azure w dokumentacji dotyczącej środowisk wdrażania platformy Azure.

Następne kroki