Azure Developer CLI şablonlarının oluşturulmasına genel bakış

Azure Geliştirici CLI'si (azd), uygulama kaynaklarını sağlamak ve buluta dağıtmak için templates kullanır. Geliştiriciler uygulamalarını şablonlara dönüştürerek komutlar ve özellikler için azd destek ekleyebilir. Bu makalede şablon oluşturmaya azd yönelik farklı seçeneklere bağlamsal bir genel bakış sağlanır. Bu makaledeki kavramları anladıktan sonra daha ayrıntılı uygulama kılavuzları için aşağıdaki kaynakları ziyaret edin:

Uyarı

Bu makalede, şablonların genel olarak anlaşılması varsayılır azd . Şablonlar hakkında daha fazla bilgi için şablona genel bakış belgesini ziyaret edin.

Şablon oluşturma kavramları

azd Şablon oluşturmak için mevcut kod tabanınıza belirli yapılandırma ve altyapı varlıkları eklenmesi veya mevcut bir şablondan bu aynı varlıklardan yeni bir uygulama başlatılması gerekir. Her iki iş akışı da sonraki bölümlerde açıklanmıştır. Tüm azd şablonlar, kurallar temelinde azd benzer bir dosya yapısını paylaşır. Aşağıdaki diyagramda şablon oluşturma işlemine hızlı bir azd genel bakış sağlanır:

Azure Geliştirici CLI şablon akışı diyagramı.

Her azd şablon için aşağıdaki en düşük kaynaklar gerekir:

  • Kod olarak altyapı dosyalarını (Bicep veya Terraform) tutan bir infra klasörü.
  • azure.yaml Uygulama hizmetlerinizi sağlanan altyapı kaynaklarına eşleyen bir yapılandırma dosyası.

Ci/CD işlem hattı oluşturmak için varlıkları olan bir .github klasör gibi diğer isteğe bağlı dizinler de genellikle dahil edilir. Şablonlar hakkında daha fazla bilgi için şablona genel bakış belgesini ziyaret edin.

Aşağıdaki örnek uygulama deposunu göz önünde bulundurun:

Örnek uygulamanın yapısını gösteren ekran görüntüsü.

Bu örnek uygulamayı şablona azd dönüştürdükten sonra, aynı uygulama deposu aşağıdakileri içerir:

azd şablonunun tamamlanmış yapısını gösteren ekran görüntüsü.

Özgün uygulama kaynakları değiştirilmedi, ancak azd gibi komutlara dayanan azd up yeni varlıklar eklenmiştir:

  • Azure kaynakları oluşturmak için Bicep dosyaları içeren bir infra klasörü eklendi.
  • azure.yaml dizinindeki uygulama kodunu Azure sağlama kaynaklarına eşleştirmek için bir src yapılandırma dosyası eklendi.
  • .azure Ortam değişkenlerini tutmak azd için bir klasör oluşturuldu.
  • GitHub eylemleriyle CI/CD işlem hatlarını desteklemek için bir .github klasörü (isteğe bağlı) eklendi.

Şablon oluşturma iş akışları

azd init komutu, uygulama kaynaklarının Azure sağlanması ve dağıtılması için bir azd şablonu başlatmak için kullanılır. Komut, aşağıdaki bölümlerde özetlenen bir şablonu başlatmak için iki farklı iş akışı arasında seçim yapmanız istenir: Geçerli dizindeki kodu kullanma ve Var olan bir şablonu kullan.

Dizini bir azd template öğesine dönüştürmek için azd init komutunu dizinin kökünde çalıştırın:

azd init

Şablon başlatma işlemini gösteren ekran görüntüsü.

Geçerli dizinde kod kullanma

Bu seçenek, dizininizdeki kodu analiz ederek programlama dili, çerçeve ve veritabanı sistemi gibi hangi teknolojileri kullandığını tanımlamanızı sağlar azd . azd hizmet tanımı dosyası ve kod olarak altyapı dosyalarını içeren azure.yamlinfra klasör gibi şablon varlıklarını sizin için otomatik olarak oluşturur. Oluşturulan varlıklar, ek değişiklikler için bir başlangıç noktasıdır. azd iskele özellikleri tarafından desteklenen yaygın Azure hizmetlerini kullanmayı planlıyorsanız bu yaklaşımı kullanın.

Bu yaklaşımın nasıl uygulanacağı ve hangi Azure kaynaklarının otomatik algılama ve yapı iskelesini desteklediği hakkında ayrıntılı bilgi için Uygulama kodunuzla şablon oluşturma öğreticisini ziyaret edin.

Şablon seçme

Başlangıç noktası olarak birçok Azure kaynağınızı ve mimari hedeflerinizi tanımlayan mevcut bir şablonu kullanmak için bu seçeneği belirleyin. azd , awesome-azd galerisinden bir başlangıç şablonu veya başka bir şablon seçmenizi ister. Bir şablon seçtiğinizde, bu şablonun varlıkları başlangıç noktası olarak kullanmak üzere mevcut proje dizininize eklenir. Bazı şablonlar kendi şablonlarınızla değiştirebileceğiniz örnek uygulama kodu içerirken, bazıları ("başlangıç şablonları" olarak adlandırılır) yalnızca altyapıdır.

azd init Mevcut bir şablonu boş bir dizine çekmek ve kendi uygulamanız için başlangıç noktası olarak kullanmak için komutunu kullanın. Şablonda uygulama kaynak kodu varsa, bu kodu derleyebilir veya kaynak kod dizinini kendinizle değiştirebilirsiniz.

Bu yaklaşımı uygulama hakkında ayrıntılı bilgi için Mevcut şablonla başlama öğreticisini ziyaret edin.

Ayrıca bakınız

Yardım isteme

Azure Geliştirici CLI'si için hata oluşturma, yardım isteme veya yeni bir özellik önerme hakkında bilgi için lütfen troubleshooting and support sayfasını ziyaret edin.

Sonraki Adımlar

Azure Developer CLI Sıkça Sorulan Sorular

  • Last updated on