Cli-configuratie voor Azure ontwikkelaars verkennen

Met de Azure Developer CLI (azd) kunt u de configuraties van azd beheren met een reeks azd config-opdrachten. Deze configuratie-instellingen omvatten nuttige standaardinstellingen, zoals uw Azure abonnement en locatie, evenals instellingen die worden gebruikt door andere azd opdrachten of functies. U kunt ook uw eigen aangepaste waarden ophalen en instellen en gebruiken in scripts of aangepaste functionaliteit.

In dit artikel leert u het volgende:

• Belangrijkste concepten over Azure Cli-configuratie voor ontwikkelaars
• Werken met azd config opdrachten
• Hoe azd config kan worden geïntegreerd met andere azd functies

Het configuratiebestand van de Azure Developer CLI verkennen

Wanneer u de Azure Developer CLI voor het eerst installeert, wordt een bestand met de naam config.json toegevoegd op de volgende locatie:

• $HOME/.azd onder Linux en macOS
• %USERPROFILE%\.azd op Windows

De instellingen in dit bestand beheren functionaliteit zoals:

• Het standaard-Azure-abonnement of de standaardlocatie die u gebruikt wanneer u resources inricht of implementeert
• Welke alfafuncties zijn ingeschakeld
• Welke sjabloonbronlocaties zijn geconfigureerd
• Aangepaste waarden die door de gebruiker zijn ingesteld voor scripts of andere doeleinden

Standaard bevat het config.json bestand slechts enkele configuraties voor de standaardlocatie azd van de sjabloonbron. Wanneer u verschillende functies van de Azure Developer CLI gebruikt, worden sommige waarden automatisch ingevuldconfig.json. De eerste keer dat u de azd up opdracht uitvoert, worden bijvoorbeeld het abonnement en de locatie die u selecteert voor inrichting en implementatie opgeslagen in de defaults sectie van het bestand.

Een eenvoudig config.json bestand kan er ongeveer als volgt uitzien:

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

Werken met configuratieopdrachten

De Azure Developer CLI biedt een set opdrachten voor het handmatig beheren van de instellingen in het config.json bestand:

• azd config get: Haal een configuratiewaarde op.
• azd config list-alpha: De lijst met beschikbare functies weergeven in de alfafase.
• azd config reset: Stel de standaardconfiguratie opnieuw in.
• azd config set: Stel een configuratie in.
• azd config show: Alle configuratiewaarden weergeven.
• azd config unset: Een configuratie ongedaan maken.

Deze commando's worden in de volgende paragrafen verder besproken. U kunt ook de naslagpagina voor Azure Developer CLI-opdrachten bezoeken voor meer informatie over azd opdrachten.

Configuraties weergeven

Bekijk de huidige inhoud van het hele config.json bestand op elk gewenst moment door de opdracht uit te azd config show voeren:

azd config show

Voorbeelduitvoer:

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

Geef een specifieke configuratiewaarde weer met behulp van de azd config get <key> opdracht:

azd config get defaults

Voorbeelduitvoer:

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

Het in- of uitschakelen van alfafuncties is een algemene configuratietaak, dus azd bevat ook een handige opdracht om de huidige status van alfafuncties weer te geven:

azd config list-alpha

Voorbeelduitvoer:

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

Configuraties ophalen en instellen

U kunt waarden in het config.json bestand ophalen, instellen of opheffen met behulp van azd config opdrachten. Sommige specifieke configuraties worden gebruikt door andere azd functies en opdrachten, zoals bij het inschakelen van alfafuncties of het instellen van sjabloonbronnen, maar u kunt ook uw eigen aangepaste waarden instellen.

Configuraties beheren die worden gebruikt door azd

Gebruik de azd config set <key> <value> opdracht om een configuratie-instelling toe te voegen aan het config.json bestand.

Als u bijvoorbeeld de LLM-functies wilt inschakelen die worden gebruikt door de GitHub Copilot-integratie:

azd config set alpha.llm on

Controleer of de instelling is ingeschakeld met behulp van de azd config get <key> opdracht, zoals de volgende:

azd config get alpha.llm

Voorbeelduitvoer:

"on"

In dit scenario kunt u ook uitvoeren azd config get alpha om het hele JSON-object in het config.json bestand weer te geven:

azd config get alpha

Voorbeelduitvoer:

{
  "llm": "on"
}

Aangepaste configuraties beheren

U kunt ook aangepaste configuratiewaarden instellen voor gebruik in azd hooks en klantscripts. Deze configuratiewaarden bieden een alternatief voor het gebruik van omgevingsvariabelen.

Een aangepaste configuratiewaarde instellen:

azd config get customVal hello-world

Haal de aangepaste configuratiewaarde op:

azd config get customVal

Voorbeelduitvoer:

hello-world

Configuraties opnieuw instellen

U kunt het Azure Developer CLI-bestand config.json terugzetten op de standaardwaarden met behulp van de azd config reset opdracht, waarmee de inhoud van het bestand wordt verwijderd:

azd config reset

Wanneer u azd config show na een reset uitvoert, ziet u gewoon een leeg object:

{}

Volgende stappen