Aracılığıyla paylaş

Şablon kaynaklarını yapılandırma ve kullanma

Azure Geliştirici CLI'sı, Azure kaynaklarını dağıtmayı ve sağlamayı kolaylaştıran güçlü bir şablon sistemi etrafında tasarlanmıştır. ile azdgeliştirme yaparken kendi şablonunuzu oluşturma veya mevcut şablonların yapılandırılabilir listesinden seçim yapma seçeneğiniz vardır. Bu makalede, şablon listeleriyle çalışmayı ve yerel azd yüklemenizi farklı şablon listesi kaynaklarını destekleyecek şekilde yapılandırmayı öğreneceksiniz.

Şablon kaynaklarını anlama

azd şablon kaynağı, kullanılabilir şablonların listesini ve şablon kaynak kodunun adı, açıklaması ve konumu (genellikle GitHub deposu) gibi temel meta verilerini açıklayan bir JSON yapılandırma dosyasına işaret eder. Şablon kaynağını etkinleştirdiğinizde, tanımladığı şablonlar diğer komutlar aracılığıyla kullanılabilir azd hale getirilir. Örneğin, aşağıdaki şablon kaynağı JSON parçacığı iki şablon tanımlar:

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

JSON yapılandırma dosyasındaki her şablon girdisi aşağıdaki özellikleri içerir:

  • adı: Şablonun görünen adı.
  • açıklama: Şablonun ne yaptığının kısa bir özeti.
  • repositoryPath: Şablonun kaynak kodunun yolu, şu olabilir:
    • Git deposuna tam nitelikli bir URI, örneğin "https://dev.azure.com/org/project/_git/repo"".
    • GitHub depoları için "{owner}/{repo}".
    • Azure-Samples kuruluşu altındaki GitHub depoları için "{repo}".
  • etiketleri: Kullanıcıların şablonları azd init --filter <tag> ve azd template list --filter <tag>ile filtrelemelerine yardımcı olan anahtar sözcükler.

Tam bir örnek için, 'de bulunan varsayılan şablon kaynağıolan bu JSON dosyasını inceleyin.

azd aynı anda birden çok şablon kaynağını etkinleştirmenizi sağlar. Şu anda aşağıdaki şablon kaynağı seçeneklerinden birini seçebilirsiniz:

  • awesome-azd - Varsayılan olarak etkin olan Awesome AZD galerisindeki şablonların listesi.
  • default - Farklı teknoloji yığınlarını göstermek için özel olarak seçilmiş küçük bir şablon kümesi.
  • file - Şablon kaynağı JSON yapılandırma dosyasına işaret eden yerel/ağ yolu.
  • url - Şablon kaynağı JSON yapılandırma dosyasını gösteren HTTP(S) adreslenebilir bir yol.
  • gh - GitHub deposuna işaret eder.
  • ade - Azure Dağıtım Ortamı şablon listesini gösterir. Azure Dağıtım Ortamları için Azure Geliştirici CLI desteği hakkında daha fazla bilgi edinin.

Şablon kaynaklarıyla çalışma

azd şablon kaynaklarını yapılandırmak için çeşitli komutlar sağlar.

azd template source list Şu anda yapılandırılmış olan tüm şablon kaynaklarını listelemek için komutunu kullanın:

azd template source list

İki yapılandırılmış şablon kaynağını içeren örnek çıktı:

Key          Name         Type         Location

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

Komutunu kullanarak azd template source add yeni bir şablon kaynağı ekleyin. Bu komut aşağıdaki parametreleri kabul eder:

  • key: Şablon kaynağının teknik adı.
  • --type, -t: Şablon kaynak türü - Geçerli değerler GitHub için dosya, url ve gh değerleridir.
  • --location, -l: Yerel ağ veya HTTP(S) web URI'sı olması gereken şablon kaynak konumu.
  • --name, -n: Şablon kaynağının görünen adı (isteğe bağlı, atlanırsa anahtar kullanılır).
azd template source add <key> --type <file-or-url-or-gh> --location <your-uri> --name <your-display-name>

azd template source remove Şablon kaynağını kaldırmak için komutunu kullanın:

azd template source remove <key>

azd config reset Şablon yapılandırmasını varsayılan ayarlara geri sıfırlamak için komutunu kullanın:

azd config reset

Şablon listeleriyle çalışma

Şablon kaynaklarınızı yapılandırdıktan sonra, bu kaynaklardan kullanılabilir şablonları listelemek için komutunu kullanın azd template list :

azd template list

Örneğin, varsayılan yüklemesinde azd awesome-azd şablon kaynağından aşağıdaki şablonlar listelenir:

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

Bayrağı yalnızca --source belirli bir kaynaktan gelen şablonları listelemek için ekleyin:

azd template list --source <source-name>

Görüntülenen listeden bir şablon başlatmak için azd init komutunu çalıştırın ve şablonun depo yolunu sağlayın:

azd init --template <path-value>

Azure Dağıtım Ortamları ile çalışma

Azure Geliştirici CLI'sı (azd), Azure Dağıtım Ortamları için de destek sağlar. Azure Dağıtım Ortamı (ADE), önceden yapılandırılmış aboneliklerde dağıtılan Azure kaynaklarının önceden yapılandırılmış bir koleksiyonudur. Azure idaresi, korumalı alan, test, hazırlama veya üretim gibi ortam türüne göre bu aboneliklere uygulanır. Azure Dağıtım Ortamları ile kurumsal güvenlik ilkelerini zorunlu kılabilir ve önceden tanımlanmış kod olarak altyapı (IaC) şablonları kümesi sağlayabilirsiniz.

ADE tümleştirmesi bu makalenin kapsamı dışındadır. Azure Dağıtım Ortamlarıadedesteği yapılandırma hakkında daha fazla bilgi edinin.

Sonraki adımlar

Azure Dağıtım OrtamlarıIçin Azure Geliştirici CLI desteği Şablon listesi komut başvurusu

  • Last updated on