Azure Geliştirici CLI yapılandırmasını keşfetme

Azure Geliştirici CLI'sı (azd), yapılandırmaları bir komut kümesi azd config kullanarak yönetmenize azd olanak tanır. Bu yapılandırma ayarları, Azure aboneliğiniz ve konumunuz gibi kullanışlı varsayılan ayarların yanı sıra diğer azd komutlar veya özellikler tarafından kullanılan ayarları içerir. Ayrıca kendi özel değerlerinizi alıp ayarlayabilir ve bunları betiklerde veya özel işlevlerde kullanabilirsiniz.

Bu makalede şunları öğreneceksiniz:

  • Azure Geliştirici CLI yapılandırmasıyla ilgili temel kavramlar
  • azd config komutlarıyla nasıl çalışılır
  • azd diğer azd config özelliklerle nasıl bütünleşir

Azure Geliştirici CLI yapılandırma dosyasını keşfetme

Azure Geliştirici CLI'sini ilk yüklediğinizde, adlı config.json bir dosya aşağıdaki konuma eklenir:

  • $HOME/.azd Linux ve macOS'ta
  • %USERPROFILE%\.azd Windows'ta

Tip

Yapılandırma dizini, ortam değişkeninde AZD_CONFIG_DIR bir yol belirtilerek geçersiz kılınabilir.

Bu dosyadaki ayarlar aşağıdaki gibi işlevleri yönetir:

  • Kaynakları sağlarken veya dağıtırken kullanılacak varsayılan Azure aboneliği veya konumu
  • Hangi alfa özellikleri etkinleştirilir?
  • Hangi şablon kaynak konumlarının yapılandırıldığı
  • Kullanıcı tarafından betikler veya başka amaçlarla ayarlanan özel değerler

Varsayılan olarak, config.json dosya varsayılan azd şablon kaynak konumları için yalnızca birkaç yapılandırma içerir. Azure Geliştirici CLI'sının çeşitli özelliklerini kullandığınızda, bazı değerler otomatik olarak doldurulurconfig.json. Örneğin, azd up komutunu ilk kez çalıştırdığınızda, sağlama ve dağıtım için seçtiğiniz abonelik ve konum dosyanın defaults bölümünde depolanır.

Basit config.json bir dosya aşağıdakine benzer olabilir:

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

Yapılandırma komutlarıyla çalışma

Azure Geliştirici CLI'sı, dosyadaki config.json ayarları el ile yönetmek için bir dizi komut sağlar:

  • azd config get: Bir yapılandırma değeri alın.
  • azd config list-alpha: Alfa aşamasındaki kullanılabilir özelliklerin listesini görüntüleyin.
  • azd config reset: Yapılandırmayı varsayılana sıfırlayın.
  • azd config set: Bir yapılandırma ayarlayın.
  • azd config show: Tüm yapılandırma değerlerini gösterir.
  • azd config unset: Bir yapılandırmanın ayarını kaldırın.

Bu komutlar aşağıdaki bölümlerde daha fazla incelenir. Komutlar hakkında azd daha fazla bilgi edinmek için Azure Geliştirici CLI komutları başvuru sayfasını da ziyaret edebilirsiniz.

Ekran yapılandırmaları

komutunu çalıştırarak azd config show dosyanın tamamının config.json geçerli içeriğini istediğiniz zaman görüntüleyin:

azd config show

Örnek çıkış:

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

komutunu kullanarak azd config get <key> belirli bir yapılandırma değerini görüntüleyin:

azd config get defaults

Örnek çıkış:

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

Alfa özelliklerini etkinleştirme veya devre dışı bırakma yaygın bir yapılandırma görevidir, bu nedenle azd alfa özelliklerinin geçerli durumunu görüntülemek için bir kolaylık komutu da içerir:

azd config list-alpha

Örnek çıkış:

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

Yapılandırmaları alma ve ayarlama

Komutları kullanarak azd config dosyadaki config.json değerleri alabilir, ayarlayabilir veya kaldırabilirsiniz. Bazı özel yapılandırmalar, alfa özelliklerini etkinleştirirken veya şablon kaynaklarını ayarlarken olduğu gibi diğer azd özellikler ve komutlar tarafından kullanılır, ancak kendi özel değerlerinizi de ayarlayabilirsiniz.

azd tarafından kullanılan yapılandırmaları yönetin

Dosyaya azd config set <key> <value> bir yapılandırma ayarı eklemek için config.json komutunu kullanın.

Örneğin, GitHub Copilot tümleştirmesi tarafından kullanılan LLM özelliklerini etkinleştirmek için:

azd config set alpha.llm on

Note

sırasında azd init seçeneğinin belirlenmesi, bu ayarı otomatik olarak etkinleştirir. Yapılandırma değerlerini alırken ve ayarlarken JSON nesne yapılarında dolaşmak için . söz dizimini kullanın.

Aşağıdaki gibi komutu kullanarak ayarın azd config get <key> etkinleştirildiğini doğrulayın:

azd config get alpha.llm

Örnek çıkış:

"on"

Bu senaryoda, dosyasındaki JSON nesnesinin config.json tamamını görüntülemek için komutunu da çalıştırabilirsinizazd config get alpha:

azd config get alpha

Örnek çıkış:

{
  "llm": "on"
}

Özel yapılandırmaları yönetme

Ayrıca, azd hook'larında ve müşteri betiklerinde kullanmak üzere özel yapılandırma değerleri ayarlayabilirsiniz. Bu yapılandırma değerleri, ortam değişkenlerini kullanmaya bir alternatif sağlar.

Özel yapılandırma değeri ayarlamak için:

azd config get customVal hello-world

Özel yapılandırma değerini alın:

azd config get customVal

Örnek çıkış:

hello-world

Yapılandırmaları sıfırlama

Azure Geliştirici CLI config.json dosyasını, dosyanın içeriğini silen komutunu kullanarak azd config reset varsayılan ayarlarına geri sıfırlayabilirsiniz:

azd config reset

Sıfırlamadan sonra çalıştırdığınızda azd config show yalnızca boş bir nesne görürsünüz:

{}

Sonraki Adımlar

Şablon geliştirmeye genel bakış

  • Last updated on