A Azure fejlesztői parancssori felület konfigurációjának megismerése

A Azure fejlesztői parancssori felület (azd) lehetővé teszi a konfigurációk kezelését azd parancsok halmazávalazd config. Ezek a konfigurációs beállítások olyan hasznos alapértelmezett beállításokat tartalmaznak, mint az Azure előfizetése és helye, valamint más azd parancsok vagy szolgáltatások által használt beállítások. Saját egyéni értékeket is lekérhet és beállíthat, és szkriptekben vagy egyéni funkciókban is használhatja őket.

Ebben a cikkben a következőt ismerheti meg:

  • A Azure fejlesztői parancssori felület konfigurálásának főbb fogalmai
  • A azd config parancsok használata
  • Hogyan integrálódik a(z) azd config a többi azd funkcióval

A Azure fejlesztői parancssori felület konfigurációs fájljának megismerése

A Azure fejlesztői parancssori felület első telepítésekor a rendszer hozzáad egy elnevezett config.json fájlt a következő helyre:

  • $HOME/.azd Linux és macOS rendszeren
  • %USERPROFILE%\.azd Windows rendszeren

Tip

A konfigurációs könyvtár a AZD_CONFIG_DIR környezeti változóban egy elérési út megadásával felülírható.

A fájl beállításai a következő funkciókat kezelik:

  • Az alapértelmezett Azure előfizetés vagy hely, amelyet erőforrások kiépítésekor vagy üzembe helyezésekor kell használni
  • Mely alfafunkciók vannak engedélyezve
  • Mely sablonforrás-helyek vannak konfigurálva
  • A felhasználó által szkriptekhez vagy más célokra beállított egyéni értékek

Alapértelmezés szerint a config.json fájl csak néhány konfigurációt tartalmaz az alapértelmezett azd sablonforrás-helyekhez. A Azure fejlesztői parancssori felületének különböző funkcióinak használata során egyes értékek automatikusan ki lesznek töltveconfig.json. Például a azd up parancs első futtatásakor a létesítéshez és az üzembe helyezéshez kiválasztott előfizetés és régió a fájl defaults szakaszában tárolódik.

Egy egyszerű config.json fájl a következőhöz hasonló lehet:

{
  "defaults": {
    "location": "eastus2",
    "subscription": "your-subscription-id"
  },
  "template": {
    "sources": {
      "awesome-azd": {
        "key": "awesome-azd",
        "location": "https://aka.ms/awesome-azd/templates.json",
        "name": "Awesome AZD",
        "type": "awesome-azd"
      },
      "default": {
        "key": "default",
        "name": "default"
      }
    }
  }
}

Konfigurációs parancsok használata

A Azure fejlesztői parancssori felület parancskészletet biztosít a config.json fájl beállításainak manuális kezeléséhez:

  • azd config get: Konfigurációs érték lekérése.
  • azd config list-alpha: Az elérhető funkciók listájának megjelenítése az alfa szakaszban.
  • azd config reset: A konfiguráció alaphelyzetbe állítása alapértelmezettre.
  • azd config set: Konfiguráció beállítása.
  • azd config show: Az összes konfigurációs érték megjelenítése.
  • azd config unset: Konfiguráció törlése.

Ezeket a parancsokat a következő szakaszokban ismerheti meg részletesebben. A parancsokkal kapcsolatos további információkért látogasson el a Azure fejlesztői parancssori felület parancsainak referenciaoldaláraazd.

Konfigurációk megjelenítése

A parancs futtatásával azd config show bármikor megtekintheti a teljes config.json fájl aktuális tartalmát:

azd config show

A kimenet példája:

{
  "defaults": {
    "location": "eastus2",
    "subscription": "your-subscription-id"
  },
  "template": {
    "sources": {
      "awesome-azd": {
        "key": "awesome-azd",
        "location": "https://aka.ms/awesome-azd/templates.json",
        "name": "Awesome AZD",
        "type": "awesome-azd"
      },
      "default": {
        "key": "default",
        "name": "default"
      }
    }
  }
}

Egy adott konfigurációs érték megjelenítése a azd config get <key> parancs használatával:

azd config get defaults

A kimenet példája:

"defaults": {
    "location": "eastus2",
    "subscription": "your-subscription-id"
}

Az alfa funkciók engedélyezése vagy letiltása gyakori konfigurációs feladat, ezért azd egy egyszerű parancsot is tartalmaz az alfafunkciók aktuális állapotának megtekintéséhez:

azd config list-alpha

A kimenet példája:

Name: aca.persistDomains
Description: Do not change custom domains when deploying Azure Container Apps.
Status: Off

Name: aca.persistIngressSessionAffinity
Description: Do not change Ingress Session Affinity when deploying Azure Container Apps.
Status: Off

Name: aks.helm
Description: Enable Helm support for AKS deployments.
Status: On

Name: aks.kustomize
Description: Enable Kustomize support for AKS deployments.
Status: Off

Name: azd.operations
Description: Extends provisioning providers with azd operations.
Status: Off

Name: deployment.stacks
Description: Enables Azure deployment stacks for ARM/Bicep based deployments.
Status: Off

Name: llm
Description: Enables the use of LLMs in the CLI.
Status: Off

Konfigurációk lekérése és beállítása

A fájlban config.jsonazd config lévő értékeket parancsokkal szerezheti be, állíthatja be vagy törölheti. Bizonyos konfigurációkat más azd funkciók és parancsok is használnak, például az alfa funkciók engedélyezésekor vagy sablonforrások beállításánál, de saját egyéni értékeket is beállíthat.

A(z) azd által használt konfigurációk kezelése

azd config set <key> <value> A parancs használatával adjon hozzá konfigurációs beállítást a config.json fájlhoz.

Például a GitHub Copilot integráció által használt LLM-funkciók engedélyezéséhez:

azd config set alpha.llm on

Note

A azd init során a Beállítás a GitHub Copilottal (előzetes verzió) lehetőség kiválasztása automatikusan bekapcsolja ezt a beállítást. A . szintaxissal bejárhatja a JSON-objektumok struktúráját a konfigurációs értékek lekérdezéséhez és beállításához.

Ellenőrizze, hogy a beállítás engedélyezve van-e a azd config get <key> paranccsal, például a következővel:

azd config get alpha.llm

A kimenet példája:

"on"

Ebben az esetben a azd config get alpha futtatásával a config.json fájlban található teljes JSON-objektumot is megtekintheti:

azd config get alpha

A kimenet példája:

{
  "llm": "on"
}

Egyéni konfigurációk kezelése

Egyéni konfigurációs értékeket is beállíthat a horgokban és az ügyfélszkriptekben való használatra azd . Ezek a konfigurációs értékek alternatívát kínálnak a környezeti változók használatára.

Egyéni konfigurációs érték beállítása:

azd config get customVal hello-world

Az egyéni konfigurációs érték lekérése:

azd config get customVal

A kimenet példája:

hello-world

Konfigurációk alaphelyzetbe állítása

A(z) Azure Developer CLI config.json fájlt a(z) azd config reset paranccsal állíthatja vissza az alapértelmezett értékeire, amely törli a fájl tartalmát:

azd config reset

Ha alaphelyzetbe állítás után fut azd config show , egyszerűen csak egy üres objektum jelenik meg:

{}

Következő lépések

A sablonfejlesztés áttekintése

  • Utolsó frissítés időpontja: