Sdílet prostřednictvím

Konfigurace a využívání zdrojů šablon

Azure Developer CLI je navržený na výkonném systému šablon, který zjednodušuje nasazování a zřizování prostředků Azure. Při vývoji pomocí azdnástroje máte možnost buď vytvořit vlastní šablonu, nebo si vybrat z konfigurovatelného seznamu existujících šablon. V tomto článku se dozvíte, jak pracovat se seznamy šablon a nakonfigurovat místní azd instalaci tak, aby podporovala různé zdroje seznamů šablon.

Principy zdrojů šablon

Zdroj šablony azd odkazuje na konfigurační soubor JSON, který popisuje seznam dostupných šablon a jejich základní metadata, jako je název, popis a umístění zdrojového kódu šablony (obvykle úložiště GitHub). Když povolíte zdroj šablony, budou šablony, které azd definuje, zpřístupněny prostřednictvím jiných příkazů. Následující fragment kódu JSON zdroje šablony například definuje dvě šablony:

[
  {
    "name": "Starter - Bicep",
    "description": "A starter template with Bicep as infrastructure provider",
    "repositoryPath": "azd-starter-bicep",
    "tags": ["bicep"]
  },
  {
    "name": "Starter - Terraform",
    "description": "A starter template with Terraform as infrastructure provider",
    "repositoryPath": "azd-starter-terraform",
    "tags": ["terraform"]
  }
]

Každá položka šablony v konfiguračním souboru JSON obsahuje následující vlastnosti:

  • název: Zobrazovaný název šablony.
  • popis: Stručný souhrn toho, co šablona dělá.
  • repositoryPath: Cesta ke zdrojovému kódu šablony, což může být:
    • Plně kvalifikovaný identifikátor URI úložiště Git, například "https://dev.azure.com/org/project/_git/repo".
    • {owner}/{repo} pro úložiště GitHub.
    • „{repo}“ pro repozitáře GitHub v rámci organizace Azure-Samples.
  • značky: Klíčová slova, která uživatelům pomáhají filtrovat šablony pomocí azd init --filter <tag> a azd template list --filter <tag>.

Úplný příklad najdete v tomto souboru JSON, což je výchozí zdroj šablony zahrnutý v azd.

azd umožňuje povolit více zdrojů šablon najednou. V současné době jsou k dispozici následující možnosti zdroje šablony, ze které si můžete vybrat:

  • awesome-azd - Seznam šablon z galerie Awesome AZD, která je ve výchozím nastavení povolena.
  • výchozí – malá sada kurátorovaných šablon pro předvedení různých technologických zásobníků
  • soubor – místní nebo síťová cesta, která odkazuje na zdrojový konfigurační soubor JSON šablony.
  • url – adresa URL (S) adresovatelná cesta, která odkazuje na zdrojový konfigurační soubor JSON šablony.
  • gh – odkazuje na úložiště GitHub.
  • ade – odkazuje na seznam šablon prostředí nasazení Azure. Přečtěte si další informace o podpoře Azure Developer CLI pro prostředí nasazení Azure.

Práce se zdroji šablon

azd poskytuje několik příkazů pro konfiguraci zdrojů šablon.

azd template source list Pomocí příkazu zobrazte seznam všech aktuálně nakonfigurovaných zdrojů šablon:

azd template source list

Příklad výstupu se dvěma nakonfigurovanými zdroji šablon:

Key          Name         Type         Location

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

azd template source add Pomocí příkazu přidejte nový zdroj šablony. Tento příkaz přijímá následující parametry:

  • key: Technický název zdroje šablony.
  • --type, -t: Typ zdroje šablony – platné hodnoty jsou soubor, adresa URL a gh pro GitHub.
  • --location, -l: Zdrojové umístění šablony, což by mělo být místní síť nebo identifikátor URI webu HTTP(S).
  • --name, -n: Zobrazovaný název zdroje šablony (volitelné, pokud je vynechán, používá klíč ).
azd template source add <key> --type <file-or-url-or-gh> --location <your-uri> --name <your-display-name>

azd template source remove Pomocí příkazu odeberte zdroj šablony:

azd template source remove <key>

azd config reset Pomocí příkazu obnovte konfiguraci šablony zpět na výchozí nastavení:

azd config reset

Práce se seznamy šablon

Po nakonfigurování zdrojů šablon použijte azd template list příkaz k výpisu dostupných šablon z těchto zdrojů:

azd template list

Například výchozí instalace azd seznamů následujících šablon ze zdroje šablon 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

--source Příznak zahrňte pouze do seznamu šablon z konkrétního zdroje:

azd template list --source <source-name>

Pokud chcete inicializovat šablonu ze zobrazeného seznamu, spusťte příkaz azd init a zadejte cestu k úložišti šablony:

azd init --template <path-value>

Práce s prostředími nasazení Azure

Azure Developer CLI (azd) také poskytuje podporu pro prostředí nasazení Azure. Prostředí nasazení Azure (ADE) je předem nakonfigurovaná kolekce prostředků Azure nasazených v předdefinovaných předplatných. Zásady správného řízení Azure se použijí na tato předplatná na základě typu prostředí, jako je sandbox, testování, příprava nebo produkční prostředí. V prostředích nasazení Azure můžete vynutit podnikové zásady zabezpečení a poskytnout kurátorovanou sadu předdefinovaných šablon infrastruktury jako kódu (IaC).

Integrace ADE je nad rámec tohoto článku. Přečtěte si další informace o konfiguraci ade podpory v dokumentaci k prostředím nasazení Azure v azure developer CLI.

Další kroky

Podpora azure Developer CLI pro referenční informace k příkazům pro seznam šablon prostředínasazení Azure

  • Last updated on