Azure Dağıtım Ortamları için Azure Geliştirici CLI desteği

Azure Geliştirici CLI'sı (azd),Azure Dağıtım Ortamları için 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.

Önkoşullar

kullanarak azdAzure Dağıtım Ortamları ile çalışmak için aşağıdaki önkoşulları tamamladığınızdan emin olun:

Azure Dağıtım Ortamı desteğini etkinleştirme

azd veya azd upgibi standart komutları kullanarak dağıtım ortamlarınıza kaynak sağlamak ve dağıtmak için azd provision yapılandırabilirsiniz. Azure Dağıtım Ortamları desteğini etkinleştirmek için aşağıdaki komutu çalıştırın:

azd config set platform.type devcenter

platform.type olarak ayarlandığındadevcenter, tüm azd uzak ortam durumu ve sağlama yeni geliştirme merkezi bileşenlerinden yararlanılır. Bu yapılandırma, yerel şablonlarınızdaki klasörün yoksayıldığı anlamına da gelir infra . Bunun yerine, azd kaynak sağlama için geliştirme merkezi kataloğunuzda tanımlanan altyapı şablonlarından birini kullanır.

Geliştirme merkezi desteğini aşağıdaki komutla da devre dışı bırakabilirsiniz:

azd config unset platform

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

Geliştirme merkezi özelliği etkinleştirildiğinde, bazı yaygın azd komutlarının varsayılan davranışı bu uzak ortamlarla çalışacak şekilde değişir. Geliştirme merkezi özelliği, standart azduzak ortam desteğitarafından sağlanan işlevleri genişletir.

azd init

Geliştirme merkezi modundaki azd init komut deneyimi, yapılandırılmış kataloğunuzdan seçim için tüm azd uyumlu ADE şablonlarını gösterir. başlatma işlemi sırasında, azd şablon kodunu kopyaladıktan sonra, azure.yaml dosyası seçilen şablona göre seçilen yapılandırmaya sahip bir platform bölümü içerecek şekilde otomatik olarak güncelleştirilir. Yapılandırma geliştirme merkezi adını, kataloğu ve ortam tanımını içerir.

azd init

Azd Up

azd up Komut, uygulamanızı paketler, sağlar ve Azure Dağıtım Ortamlarına dağıtır. Ancak, komutun azd up sağlama aşamasında uzak geliştirme merkezinizdeki kod olarak altyapı şablonları kullanılırken dağıtım aşaması kaynak kodu şablonunuza azd dağıtır. Geliştirme merkezi modu etkinken, azd yerel azd şablonunuzdaki klasörü yoksayar infra ve yalnızca geliştirme merkezi şablonlarını kullanarak kaynak sağlar. Komut, Azure Dağıtım Ortamı projesi veya ortam türü gibi gerekli değerleri de ister.

azd up

azd şablon listesi

Komut, azd template list varsayılan AZD Awesome galerisindeki şablonları göstermek yerine geliştirme merkezi kataloğunuzda kullanılabilir altyapı şablonlarını görüntüler. Kataloglar geliştirme ekiplerinizin ortam oluşturmak için kullanabileceği bir dizi seçilmiş ve onaylı kod olarak altyapı şablonu sağlar.

azd template list

Güncelleştirilmiş şablon galerisini gösteren ekran görüntüsü.

azd sağlama

komutu azd provision yeni geliştirme merkezi ortamları oluşturur. Komut sizden ortam türü veya proje gibi eksik değerleri ister. Komut çalıştırıldığında, ilgili ortam için doğru Azure kaynakları kümesini sağlamak üzere ilişkili altyapı şablonunu kullanır. Geliştirme merkezi modu etkinken, azd yerel azd şablonunuzdaki klasörü yoksayar infra ve yalnızca geliştirme merkezi şablonlarını kullanarak kaynak sağlar.

azd provision

azd env list (Çevre listeleme komutu)

Komut, azd env list geliştirici portalında görebileceğiniz ortamların listesini görüntüler.

azd env list

Azure Dağıtım Ortamları için kaynakları etiketleme

Azure Dağıtım Ortamları için azd sağlama, geliştirme merkezi kataloğundaki seçilmiş şablonlara dayanır. Katalogdaki şablonlar, uygulama hizmetlerinizi azure.yaml dosyasında ilişkilendirmeniz için sağlanan Azure kaynaklarına etiketler atayabilir veya atamayabilir. Şablonlar etiket atamazsa, bu sorunu iki yoldan biriyle çözebilirsiniz:

  • Sağlanan Azure kaynaklarının bunları azure.yaml dosyanızda tanımlanan hizmetlerle ilişkilendirmek için etiketler içerdiğinden emin olmak için geliştirme merkezi kataloğu yöneticinizle birlikte çalışın.

  • etiketleri kullanmak yerine resourceName dosyanızdaki azure.yaml belirtin:

    services:
    api:
        project: ./src/api
        host: containerapp
        language: js
        resourceName: sample-api-containerapp
    web:
        project: ./src/web
        host: containerapp
        language: js
        resourceName: sample-web-containerapp

Geliştirme merkezi ayarlarını yapılandırma

Geliştirme merkezleriniz için azd ayarlarını birden çok yerde tanımlayabilirsiniz. Ayarlar, son yapılandırma kümesini aşağıdaki öncelik sırasına göre oluşturmak için bu konumlardan birleştirilir:

  1. Ortam değişkenleri
  2. Azd ortam yapılandırması
  3. Proje yapılandırması
  4. Kullanıcı yapılandırması

azd, bu kaynaklarda eksik olan yapılandırma değerlerini otomatik olarak sorar. Bu yapılandırma seçeneklerinin her biri aşağıdaki bölümlerde ayrıntılı olarak anlatılır.

Ortam değişkenleri

azd aşağıdaki ortam değişkenlerini bulur ve kullanır:

  • AZURE_DEVCENTER_NAME
  • AZURE_DEVCENTER_PROJECT
  • AZURE_DEVCENTER_CATALOG
  • AZURE_DEVCENTER_ENVIRONMENT_DEFINITION
  • AZURE_DEVCENTER_ENVIRONMENT_TYPE
  • AZURE_DEVCENTER_ENVIRONMENT_USER

Yapılandırmaları tanımlama

Geliştirme merkezleriniz için yapılandırmaları azd dosyasındaki .azure/<env>/config.json ortam kapsamında tanımlayın:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}

Proje kapsamı

Geliştirme merkezleriniz için yapılandırmaları azd dosyasının platform düğümündeki azure.yaml proje kapsamında tanımlayın:

name: todo-nodejs-mongo-aca
metadata:
    template: todo-nodejs-mongo-aca@0.0.1-beta
platform:
    type: devcenter
    config:
        catalog: SampleCatalog
        environmentDefinition: Todo
        name: sample-devcenter
        project: SampleProject
services:
    api:
        project: ./src/api
        host: containerapp
        language: js
    web:
        project: ./src/web
        host: containerapp
        language: js

Kullanıcı kapsamı

geliştirme merkezleriniz için yapılandırmaları ~/<user_profile>/.azd/config.json dosyasındaki kullanıcı kapsamında tanımlayın:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}
  • Last updated on