Sablonforrások konfigurálása és felhasználása

Az Azure Developer CLI egy hatékony sablonrendszer köré van kialakítva, amely leegyszerűsíti az Azure-erőforrások üzembe helyezését és kiépítését. A fejlesztés azdsorán saját sablont hozhat létre, vagy választhat a meglévő sablonok konfigurálható listájából. Ebből a cikkből megtudhatja, hogyan használhat sablonlistákat, és hogyan konfigurálhatja a helyi azd telepítést a különböző sablonlista-források támogatásához.

Sablonforrások ismertetése

A azd sablonforrás egy JSON-konfigurációs fájlra mutat, amely leírja az elérhető sablonok listáját és alapvető metaadatait, például a sablon forráskódjának nevét, leírását és helyét (általában egy GitHub adattárat). Amikor engedélyezi a sablonforrást, az általa definiált sablonok más parancsokkal is elérhetővé azd válnak. Az alábbi sablonforrás JSON-kódrészlete például két sablont határoz meg:

[
  {
    "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"]
  }
]

A JSON-konfigurációs fájl minden sablonbejegyzése a következő tulajdonságokat tartalmazza:

  • név: A sablon megjelenítendő neve.
  • leírás: A sablon rövid összefoglalása.
  • repositoryPath: A sablon forráskódjának elérési útja, amely a következő lehet:
    • Egy git-adattár teljes URI-ja, például "https://dev.azure.com/org/project/_git/repo".
    • "{owner}/{repo}" GitHub adattárakhoz.
    • "{repo}" a Azure-Samples szervezet GitHub adattáraihoz.
  • címkék: Kulcsszavak, amelyek segítenek a felhasználóknak szűrni a sablonokat és azd template list --filter <tag>a azd init --filter <tag> .

Egy teljes példáért tekintse meg ezt a JSON-fájlt, amely az alapértelmezett sablonforrás a fájlban azd.

azd lehetővé teszi egyszerre több sablonforrás engedélyezését. Jelenleg a következő sablonforrás-beállítások közül választhat:

Sablonforrások használata

azd számos parancsot biztosít a sablonforrások konfigurálásához.

A parancs használatával listázhatja az azd template source list összes jelenleg konfigurált sablonforrást:

azd template source list

Példakimenet két konfigurált sablonforrással:

Key          Name         Type         Location

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

azd template source add A parancs használatával adjon hozzá egy új sablonforrást. Ez a parancs a következő paramétereket fogadja el:

  • kulcs: A sablon forrásának technikai neve.
  • --type, -t: A sablon forrástípusa – az érvényes értékek a GitHub esetében fájl, URL ésgh .
  • --location, -l: A sablon forráshelye, amelynek helyi hálózatnak vagy HTTP(S) webes URI-nak kell lennie.
  • --name, -n: A sablon forrásának megjelenítendő neve (nem kötelező, kihagyás esetén a kulcsot használja).
azd template source add <key> --type <file-or-url-or-gh> --location <your-uri> --name <your-display-name>

azd template source remove A parancs használatával távolítsa el a sablonforrást:

azd template source remove <key>

azd config reset A parancs használatával állítsa vissza a sablonkonfigurációt az alapértelmezett beállításokra:

azd config reset

Sablonlisták használata

Miután konfigurálta a sablonforrásokat, a azd template list paranccsal listázhatja a forrásból elérhető sablonokat:

azd template list

A azd template list parancs csak az üres vagy hiányzó templateTypestandard sablonokat tartalmazza. Kizárja a bővítményspecifikus sablonokat, például a következőre extension.ai.agentbeállított sablonokattemplateType. Bővítményspecifikus sablon inicializálásához kövesse a bővítmény vagy a sablon dokumentációját.

Egy alapértelmezett telepítés például a következő sablonokat listázza azd az awesome-azd sablonforrásból:

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

Adja meg a jelölőt --source , hogy csak egy adott forrásból származó sablonokat listázzon:

azd template list --source <source-name>

Ha egy szabványos sablont szeretne inicializálni a megjelenített listából, futtassa a azd init parancsot, és adja meg a sablon adattárának elérési útját:

azd init --template <path-value>

Azure-beli üzembehelyezési környezetek használata

Az Azure Developer CLI (azd) az Azure-beli üzembehelyezési környezetek támogatását is biztosítja. Az Azure Deployment Environment (ADE) az előre meghatározott előfizetésekben üzembe helyezett Azure-erőforrások előre konfigurált gyűjteménye. Az Azure-szabályozás azokra az előfizetésekre vonatkozik, amelyek a környezet típusa, például tesztkörnyezet, tesztelés, előkészítés vagy éles környezet alapján vannak alkalmazva. Az Azure Deployment Environments használatával vállalati biztonsági szabályzatokat kényszeríthet ki, és előre definiált infrastruktúra-sablonokat (IaC) biztosít.

Az ADE-integráció túlmutat a jelen cikk hatókörén. További információ az Azure Developer CLI támogatásának ade dokumentációjában való konfigurálásáról.

Következő lépések

Azure Developer CLI-támogatás az Azure Deployment EnvironmentsSablonlista parancslistájához

  • Last updated on