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

Makale
11/16/2023

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:

Yerel olarak yüklenmiş azd veya Cloud Shell üzerinden erişimi azd olan
Geliştirme merkezi, proje ve şablon kataloğu ile Azure Dağıtım Ortamı oluşturma ve yapılandırma
Geliştirme merkezi düzeyinde ve proje düzeyinde yapılandırılan ortam türleri
Geliştiricinin projede Dağıtım Ortamları Kullanıcı rolüne sahip olduğundan emin olun

Bahşiş

Azure Dağıtım Ortamları hakkındaki temel kavramları anlamak, aracılığıyla azdbunlarla çalışmak için gereklidir.

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

veya azd provisiongibi azd up standart komutları kullanarak dağıtım ortamlarınıza kaynak sağlamak ve dağıtmak için yapılandırabilirsinizazd. 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 yararlanacaktır. Bu yapılandırma, yerel şablonlarınızdaki klasörün etkili bir şekilde yoksayılacağı 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 Kısaltmaları ile çalışma

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

azd init

azd init Geliştirme merkezi modundaki 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, şablon kodu kopyalandıktan sonra azd dosya, azure.yaml 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 Komutu uygulamanızı paketleyecek, sağlayacak ve Azure Dağıtım Ortamlarına dağıtacaktı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 kaynakları 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

A screenshot showing the updated template gallery.

azd sağlama

azd provision komutu yeni geliştirme merkezi ortamları oluşturur. Komut, ortam türü veya proje gibi eksik değerleri girmenizi ister. Komut çalıştırıldığında, ilgili ortam için doğru Azure kaynakları kümesini sağlamak için 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 kaynakları sağlar.

azd provision

azd env list

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

azd env list

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

azd Azure Dağıtım Ortamları için sağlama, geliştirme merkezi kataloğundaki seçilmiş şablonlara dayanır. Katalogdaki şablonlar, uygulama hizmetlerinizi dosyada azure.yaml 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ı dosyanızda azure.yaml 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.

Etiket kullanmak yerine dosyanızda azure.yaml öğesini resoureName 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 ayarları birden çok yerde tanımlayabilirsiniz azd . Ayarlar, son yapılandırma kümesini aşağıdaki öncelik sırasına göre oluşturmak için bu konumlardan birleştirilir:

Ortam değişkenleri
Azd ortam yapılandırması
Proje yapılandırması
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

Aşağıdaki ortam değişkenleri tarafından azdbulunur ve kullanılı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ı dosyadaki azd ortam kapsamında .azure/<env>/config.json tanımlayın:

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

Proje kapsamı

Geliştirme merkezleriniz azd için yapılandırmaları dosyanın düğümündeki platformazure.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ı dosyadaki kullanıcı kapsamında ~/<user_profile>/.azd/config.json tanımlayın:

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

Aracılığıyla paylaş