Azure Geliştirici CLI şablonları oluşturmaya genel bakış

Azure Geliştirici CLI'sı (azd), uygulama kaynaklarını sağlamak ve buluta dağıtmak için şablonlar 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:

• Uygulamanız için mevcut bir şablonu kullanın.
• Uygulama kodunuzdan şablon oluşturma
• Eğitim - şablon oluşturma ve dağıtma azd

Not

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:

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

• infra Kod olarak altyapı (Bicep veya Terraform) dosyalarını barındıran bir 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:

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

Özgün uygulama kaynakları değiştirilmez, ancak gibi azd upkomutlara bağlı olan azd yeni varlıklar eklenmiştir:

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

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

Komutu, Azure'da azd init uygulama kaynaklarını sağlamak ve dağıtmak için bir azd şablon 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.

komutuna azd init dönüştürmek azd templateistediğiniz dizinin kökünde çalıştırın:

azd init

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. yapı iskelesi özellikleri tarafından azd desteklenen yaygın Azure hizmetlerini kullanmayı planlıyorsanız bu yaklaşımı kullanın.

Bu yaklaşımın nasıl uygulanacağı hakkında ayrıntılı bilgi edinmek ve hangi Azure kaynaklarının otomatik algılamayı ve iskeleyi desteklediği hakkında daha fazla bilgi için Uygulama kodunuzla başlayın şablon öğreticisini oluşturun.

Şablon seçme

Birçok Azure kaynağınızı ve mimari hedeflerinizi başlangıç noktası olarak 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 bkz.

• Uygulamanız için mevcut bir şablonu kullanın.
• Uygulama kodunuzdan şablon oluşturma

Yardım isteme

Azure Geliştirici CLI'sı için hata oluşturma, yardım isteme veya yeni bir özellik önerme hakkında bilgi için lütfen sorun giderme ve destek sayfasını ziyaret edin.

Sonraki adımlar

Azure Developer CLI hakkında SSS