Az Azure Developer CLI-bővítmények áttekintése

Az Azure Developer CLI (azd) bővítmények moduláris összetevők, amelyek kibővítik az Azure Developer CLI funkcióit. Lehetővé teszik új képességek hozzáadását, munkafolyamatok automatizálását és más szolgáltatásokkal való integrálást közvetlenül a parancssori felületről. A bővítményekkel a fejlődő csapat igényeihez és Azure forgatókönyvekhez igazíthatjaazd.

Megjegyzés:

A azd bővítmény keretrendszere általánosan elérhető. Az egyes bővítmények vagy képességek saját előzetes verziós állapotúak lehetnek.

Bővítményforrások kezelése

A követelmények növekedésével felderítheti, telepítheti és frissítheti a bővítményeket. A bővítményforrások kezelik a terjesztést és a felügyeletet.

  • A bővítményforrások olyan fájl- vagy URL-alapú jegyzékek, amelyek az elérhető azd bővítmények listáját biztosítják.
  • Hozzáadhat egyéni bővítményforrásokat, amelyek privát, helyi vagy nyilvános adatbázisokhoz csatlakoznak.
  • A bővítményforrások egyenértékűek a NuGet- vagy Node Csomagkezelő-hírcsatornákkal, és be kell tartaniuk a hivatalos bővítményregisztrációs sémát.

azd a bővítmények megoldásának számos módját támogatja:

  • A hivatalos bővítményforrás-beállításjegyzék előre konfigurálva azd van, és a következő helyen https://aka.ms/azd/extensions/registrytalálható: .
  • Az URL-alapú források olyan távoli beállításjegyzék-jegyzékekre hivatkoznak, amelyeket a csapat nyilvános vagy privát terjesztés céljából üzemeltet.
  • A fájlalapú források helyi beállításjegyzék-jegyzékekre hivatkoznak offline használatra vagy helyi fejlesztésre.
  • A fejlesztői és éjszakai regiszterek választható források a fejlesztés alatt álló és az automatikusan összeállított, saját fejlesztésű bővítményekhez. Éles munkafolyamatok helyett tesztelési forgatókönyvekhez használhatók.
  • A saját csomagfájlok hordozható .zip csomagokat biztosítanak a helyi fájlból vagy HTTPS URL-címről történő közvetlen telepítéshez, ha nem szeretne adatbázist üzemeltetni.

azd az egyéni bővítményforrásnevek szigorú érvényesítését kényszeríti ki. A neveknek 1–64 kis ASCII-betűt vagy számjegyet kell tartalmazniuk. Betűk vagy számjegyek között kötőjeleket (-) és aláhúzásjeleket (_) is tartalmazhat. A neveknek betűvel vagy számjegygel kell kezdődniük és végződniük. azd érvénytelen nevekre vonatkozó hibát ad vissza; nem normalizálja őket. A nevek azdbundle fenntartottak, és nem használhatók egyéni forrásokhoz. A forrásnévnek érvényesnek kell lennie, amikor a(z) --source elemmel használja.

Az előre beállított azd forrás a hivatalos regiszter. Nem távolíthatja el és nem módosíthatja a helyét.

A fejlesztési beállításjegyzékbe való bejelentkezéshez futtassa a következő parancsot:

# Add a new extension source name 'dev' to your `azd` configuration.
azd extension source add -n dev -t url -l "https://aka.ms/azd/extensions/registry/dev"

Figyelmeztetés

A fejlesztői beállításjegyzékben üzemeltetett bővítmények aláíratlanok, nem fedik le a Azure-támogatás, és értesítés nélkül módosíthatók vagy eltávolíthatók.

Bővítmény forrásparancsai

A következő parancsokkal kezelheti a telepítés bővítményforrásait azd .

Telepített bővítményforrások listázása

azd extension source list

Új bővítményforrás hozzáadása

azd extension source add -n <name> -t url -l <registry-url>
  • -l, --location: A bővítmény forrásának helye.
  • -n, --name: A bővítmény forrásának neve. Használjon érvényes egyéni forrásnevet.
  • -t, --type: A bővítményforrás típusa. A támogatott típusok a fájlok és az URL-címek.

Bővítményforrás eltávolítása

azd extension source remove <name>

Az előre konfigurált azd forrás nem távolítható el.

Ha egy frissítés egy régi, érvénytelen forrásnév ~/.azd/config.jsonáltal okozott forrásbetöltési hibát jelez, távolítsa el a jogsértő forrást azd extension source remove, majd adja hozzá ismét érvényes névvel.

Bővítmények kezelése

Miután engedélyezte a bővítményeket, és konfigurálta a bővítményforrásokat, telepítse a bővítményeket, hogy új képességeket adjon hozzá a bővítményekhez azd. A bővítmények használatára vonatkozó példa: Rövid útmutató – használja az AI-bővítményt.

Bővítmények listázása

azd extension list [flags]
  • --installed Megjeleníti a telepített bővítmények listáját.
  • --source Csak a megadott forrásból származó bővítményeket listázza. A forrásnévnek érvényes regisztrált forrásnévnek kell lennie.
  • --tags Címkék, például AI vagy teszt alapján szűri a bővítményeket.

Bővítmény telepítése

azd extension install <extension-names> [flags]

Cserélje le <extension-name> a telepíteni kívánt bővítmény nevét.

  • -v, --version Megadja a telepíteni kívánt verziót. Ez a beállítás nem fogadja el a verziótartományokat és a korlátozásokat, és nem használható önálló csomag (.zip fájl elérési útja vagy URL-címe) telepítésekor.
  • -s, --source A telepítésekhez használt bővítményforrást adja meg. A forrásnévnek érvényes regisztrált forrásnévnek kell lennie.

Ha https URL-címről szeretne telepíteni egy önálló csomagot, adja meg a csomag helyét bővítménynévként:

azd extension install https://example.com/extensions/example.zip
  • --all Az összes korábban telepített bővítményt frissíti, ha meg van adva.
  • -v, --version Adott bővítményt frissít a pontos verzióra, ha meg van adva. Ez a beállítás nem fogadja el a verziótartományokat és a korlátozásokat.
  • -s, --source A telepítésekhez használt bővítményforrást adja meg. A forrásnévnek érvényes regisztrált forrásnévnek kell lennie.
  • --no-dependency-updates Megakadályozza a függőségek frissítését, ha meg van adva.

Bővítmény eltávolítása

azd extension uninstall <extension-name>
  • --all Ha meg van adva, eltávolítja az összes telepített bővítményt.

Szükséges bővítmények deklarálása egy projektben

A projektek deklarálhatják a azure.yaml szükséges bővítményeket, így azd megoldhatják és telepíthetik a projekt által igényelt bővítményverziókat. Adjon hozzá bővítménykövetelményeket a(z) requiredVersions.extensions alatt, és használja a(z) latest elemet, egy pontos verziót vagy egy támogatott szemantikusverzió-megszorítást.

requiredVersions:
  extensions:
    azure.ai.agents: "latest"
    contoso.azd.tagger: "^2.0.0"

Használjon projektszintű követelményeket, ha egy sablon a bővítmény által biztosított szolgáltatásgazdáktól, életciklus-kezelőktől, ellenőrzési szolgáltatóktól vagy parancsoktól függ. A séma és a verziókényszerítés teljes részleteiért lásd: requiredVersions.

Bővítményintegrációs pontok ismertetése

A bővítmények többféleképpen integrálhatók azd :

  • Adjon hozzá metaadatokat, súgót és példákat tartalmazó parancsnévtereket.
  • Adja meg a konfigurációs sémákat és az IntelliSense metaadatait a projektfájlokhoz.
  • Az életciklus eseménykezelőinek regisztrálása olyan munkafolyamatokhoz, mint a kiépítés, a csomag és az üzembe helyezés.
  • Adjon hozzá szolgáltatókat az egyéni kiépítéshez, az ellenőrzéshez, a szolgáltatási célokhoz, valamint a nyelvi vagy keretrendszer-támogatáshoz.
  • A Model Context Protocol (MCP) kiszolgálói képességeinek felfedése ügynökök és fejlesztői eszközök számára.

A megvalósítással kapcsolatos útmutatásért tekintse meg a bővítményfejlesztési fogalmakat.

Azd-bővítmények használata fejlesztői tárolókban

A azd Dev Container Feature támogat egy extensions opciót, amely automatikusan telepíti a azd bővítményeket tartalmazó vesszővel elválasztott listát a tároló felépítése során. Az ilyen módon telepített bővítmények a tároló elindításakor azonnal elérhetők, csökkentve a manuális beállítást, és lehetővé teszik azd a parancsok futtatását a már telepített szükséges bővítményekkel.

Bővítmények automatikus telepítéséhez adja hozzá a extensions opciót a azd funkcióbejegyzéshez a devcontainer.json fájlban:

{
    "name": "Azure Developer CLI",
    "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
    "features": {
        "ghcr.io/azure/azure-dev/azd:latest": {
            "extensions": "my-ext-1,my-ext-2"
        }
    }
}

Az extensions érték a bővítménynevek vesszővel tagolt listája azd . A telepítés a tároló összeállítása során történik, így a bővítmények a tároló indításakor azonnal használatra készek. A bővítmények listájának módosítása után a Visual Studio Code Build and Reopen in Dev Container parancsával újraépítheti a tárolót a frissített bővítményekkel.

További információ az azd Dev Container funkcióról.

Következő lépések

  • Last updated on