Aracılığıyla paylaş

Azure Dağıtım Ortamları ile Azure Geliştirici CLI'sı kullanma

  • Makale

Bu makalede Azure Geliştirici CLI'sı (azd) ve uygulama altyapısı sağlamak ve uygulama kodunu yeni altyapıya dağıtmak için Azure Dağıtım Ortamları (ADE) ile nasıl çalıştığı hakkında bilgi edineceksiniz.

Azure Geliştirici CLI'sı (azd), iş akışınızdaki önemli aşamalara eşleyen geliştirici dostu komutlar sağlayan bir açık kaynak komut satırı aracıdır. Makinenize yerel olarak yükleyebilir azd veya diğer ortamlarda kullanabilirsiniz.

ADE ile geliştirme merkezinize bağlı bir katalogdaki ortam tanımından ortamlar oluşturabilirsiniz. ekleyerek azduygulama kodunuzu yeni altyapıya dağıtabilirsiniz.

ADE ile nasıl azd çalışır?

azd , çalıştığınız yerden ortamlar oluşturmanıza olanak tanımak için ADE ile birlikte çalışır.

ADE ve azdile, buluta yüklemek istedikleri benzersiz altyapı ve kodla çalışan tek tek geliştiriciler yerel bir klasörden ortam oluşturabilir. Bir ortam sağlamak ve kodlarını sorunsuz bir şekilde dağıtmak için kullanabilirler azd .

Büyük ölçekte, ADE ve azd birlikte kullanmak, geliştiricilerin uygulama altyapısı ve kodu oluşturması için bir yol sağlamanıza olanak tanır. Ekibiniz aynı azd uyumlu ortam tanımından birden çok ADE ortamı oluşturabilir ve kodu buluta tutarlı bir şekilde sağlayabilir.

Şablonları anlama azd

Azure Geliştirici CLI komutları standartlaştırılmış şablonlarla çalışacak şekilde tasarlanmıştır. Her şablon, belirli dosya ve klasör kurallarına uygun bir kod deposudur. Şablonlar, bir Azure Dağıtım Ortamı ortamı sağlamak için gereken varlıkları azd içerir. gibi azd upbir komut çalıştırdığınızda, araç kaynak sağlama veya Azure'a dağıtma gibi çeşitli iş akışı adımlarını yürütmek için şablon varlıklarını kullanır.

Tipik bir şablon yapısı aşağıda verilmiştir:

├── infra                                        [ Contains infrastructure as code files ]
├── .azdo                                        [ Configures an Azure Pipeline ]
├── .devcontainer                                [ For DevContainer ]
├── .github                                      [ Configures a GitHub workflow ]
├── .vscode                                      [ VS Code workspace configurations ]
├── .azure                                       [ Stores Azure configurations and environment variables ]
├── src                                          [ Contains all of the deployable app source code ]
└── azure.yaml                                   [ Describes the app and type of Azure resources]

Tüm azd şablonlar aşağıdaki varlıkları içerir:

  • infra klasörü - infra klasörü içinde ADE ile kullanılmaz azd . Azd şablonunun kod dosyaları olarak tüm Bicep veya Terraform altyapısını içerir. ADE, şablon için kod dosyaları olarak altyapıyı azd sağlar. Bu dosyaları şablonunuz azd içinde eklemeniz gerekmez.

  • azure.yaml dosyası - Projenizdeki bir veya daha fazla hizmeti tanımlayan ve bunları dağıtım için Azure kaynaklarına eşleyen bir yapılandırma dosyası. Örneğin, her birinde bunları dağıtım için farklı Azure kaynaklarına eşleyen özniteliklere sahip bir API hizmeti ve web ön uç hizmeti tanımlayabilirsiniz.

  • .azure klasörü - Kaynakları dağıtma konumu veya diğer abonelik bilgileri gibi temel Azure yapılandırmalarını ve ortam değişkenlerini içerir.

  • src klasörü - Dağıtılabilir tüm uygulama kaynak kodunu içerir. Bazı azd şablonlar yalnızca altyapı varlıkları sağlar ve kendi uygulama kodunuzu eklemeniz için src dizinini boş bırakır.

Şablonların çoğu azd isteğe bağlı olarak aşağıdaki klasörlerden birini veya daha fazlasını içerir:

  • .devcontainer klasörü - Uygulamanız için bir Geliştirme Kapsayıcısı ortamı ayarlamanıza olanak tanır. Bu, azd'e özgü olmayan yaygın bir geliştirme ortamı yaklaşımıdır.

  • .github klasörü - Azd için varsayılan CI/CD sağlayıcısı olan GitHub Actions için CI/CD iş akışı dosyalarını tutar.

  • .azdo klasörü - CI/CD için Azure Pipelines kullanmaya karar verirseniz, bu klasördeki iş akışı yapılandırma dosyalarını tanımlayın.

azd uyumlu kataloglar

Azure Dağıtım Ortamları katalogları ortam tanımlarından oluşur: Dağıtım ortamı için sağlanan altyapı kaynaklarını tanımlayan IaC şablonları. Azure Geliştirici CLI'sı, yeni ortamlar sağlamak için geliştirme merkezine eklenen katalogdaki ortam tanımlarını kullanır.

Not

Şu anda Azure Geliştirici CLI'sı, Azure Dağıtım Ortamları geliştirme merkezi kataloğunda depolanan ARM şablonlarıyla çalışmaktadır.

Azure Geliştirici CLI'sı, belirli Azure İşlem hizmetlerini düzgün bir şekilde desteklemek için IaC şablonunda daha fazla yapılandırma ayarı gerektirir. Örneğin, konakları bulmayı ve uygulamayı onlara dağıtmayı bilebilmek azd için app service konaklarını belirli bilgilerle etiketlemeniz gerekir.

Desteklenen Azure hizmetlerinin listesini burada görebilirsiniz: Desteklenen Azure işlem hizmetleri (konak).

ADE kataloğunuzu ile uyumlu hale getirme azd

Geliştirme ekiplerinizi ADE ile bize azd etkinleştirmek için kataloğunuzda ile azduyumlu bir ortam tanımı oluşturmanız gerekir. Yeni azduyumlu bir ortam tanımı oluşturabilir veya Azure Dağıtım Ortamları geliştirme merkezi kataloğundan var olan bir ortam tanımını kullanabilirsiniz. Mevcut bir ortam tanımını kullanmayı seçerseniz, ile azduyumlu hale getirmek için birkaç değişiklik yapmanız gerekir.

Değişiklikler şunları içerir:

  • Var olan azd bir şablonu değiştiriyorsanız klasörü kaldırın infra . ADE, altyapıyı oluşturmak için aşağıdaki dosyaları kullanır:
    • ARM şablonu (azuredeploy.json.)
    • Parametreleri tanımlayan yapılandırma dosyası (environment.yaml veya manifest.yaml)
  • Konakları bulmayı ve uygulamayı bunlara dağıtmayı öğrenmek için azure.yaml'deki kaynakları belirli bilgilerle azd etiketleyin.
  • Ortam değişkenleri, ortam yapılandırması, azd proje yapılandırması ve kullanıcı yapılandırması azd gibi geliştirme merkezi ayarlarını yapılandırın.

ADE ortam tanımınızı ile azduyumlu hale getirme hakkında daha fazla bilgi edinmek için bkz . Projenizi Azure Geliştirici CLI ile uyumlu hale getirme.

ADE'de desteği etkinleştirme azd

ADE ile desteği etkinleştirmek azd için öğesini devcenter olarak ayarlamanız platform.type gerekir. Bu yapılandırma, uzak ortam durumu ve sağlama için yeni geliştirme merkezi bileşenlerinden yararlanmaya olanak tanır azd ve şablonlarınızdaki infra klasörünün etkili bir şekilde yoksayılacağı anlamına gelir. Bunun yerine, azd kaynak sağlama için geliştirme merkezi kataloğunuzda tanımlanan altyapı şablonlarından birini kullanır.

Desteği etkinleştirmek azd için aşağıdaki komutu çalıştırın:

 azd config set platform.type devcenter

Komutları keşfetme azd

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. Daha fazla bilgi için bkz . Azure Dağıtım Ortamları ile çalışma.

İlgili içerik