Aracılığıyla paylaş

Azure Geliştirici CLI şablonlarına genel bakış

  • Makale

Azure Geliştirici CLI (azd) şablonları, örnek uygulama kodunun yanı sıra azd yapılandırma ve altyapı dosyalarını içeren standart kod depolarıdır. azd şablonları Azure kaynaklarını sağlamanızı, uygulamanızı dağıtmanızı, CI/CD işlem hatlarını yapılandırmanızı ve daha fazlasını yapmanızı sağlar. Kendi şablonlarınızı oluşturabilir veya Awesome AZD gibi bir şablon deposundan mevcut bir şablonu kullanmaya başlayabilirsiniz. Bu makalede aşağıdaki kavramlar hakkında bilgi edineceksiniz:

  • Şablonlar uygulama kaynaklarını sağlamanızı ve dağıtmanızı nasıl azd sağlar?
  • Şablonlar nasıl azd yapılandırılır?
  • Var olan bir şablonu kullanmaya veya bir şablon oluşturmaya karar verme
  • Mevcut azd başlangıç şablonlarını keşfetme

Azure Geliştirici CLI şablonlarını neden kullanmalısınız?

Geliştiriciler genellikle bulut için düzgün şekilde tasarlanmış ve yapılandırılmış ortam uygulamaları oluştururken çok zaman alan ve zorlayıcı görevlerle karşı karşıya kalır. Ekipler bu ortamlarda kaynak oluşturma, yapılandırma uygulama, izleme ve günlüğe kaydetmeyi ayarlama, CI/CD işlem hatları oluşturma ve diğer görevler gibi birçok farklı sorunu hesaba katmalıdır. azd şablonlar, geliştiricinin yerel geliştirmeden Azure'da başarıyla dağıtılan bir uygulamaya yolculuğunda yardımcı olmak için bu sorumlulukları azaltır ve kolaylaştırır.

Örneğin, aşağıdaki Azure kaynaklarını gerektiren bir bilet yönetimi ve müşteri iletişim platformu çalıştıran bir şirkette çalıştığınızı varsayalım:

  • Ön uç web uygulaması ve arka uç API'sini barındırmak için iki App Service örneği ve app service planı
  • Güvenli uygulama gizli dizilerini depolamak için bir Key Vault örneği
  • Uygulama verilerini kalıcı olarak depolamak için Cosmos DB veritabanı
  • Application Insights panoları gibi Azure İzleyici kaynakları
  • Ölçeklenebilir mesajlaşmayı yönetmek için Service Bus
  • Değişikliklerin otomatik, tekrarlanabilir bir işlemle güvenilir bir şekilde dağıtılabilmesini sağlamak için CI/CD işlem hatları.

Baştan başlamak yerine, azd kaynakları sizin için sağlamak ve dağıtmak için mevcut mimari şablonlarından yararlanabilirsiniz. Geliştirme ekibi daha sonra uygulamayı oluşturmaya ve şablon mimarisinde daha küçük ayarlamalar yapmaya odaklanabilir.

Azure Geliştirici CLI şablonları nasıl çalışır?

Azure Geliştirici CLI şablonları ve azd upgibi azd init komutlarla azd çalışacak şekilde tasarlanmıştır. Şablonlar, Azure kaynaklarını sağlama ve uygulama kodunu bunlara dağıtma gibi görevleri gerçekleştirmek için komutlar tarafından kullanılan yapılandırma ve kod olarak altyapı (IaC) dosyalarını içerir.

Örneğin, mevcut şablonu kullanan tipik azd bir iş akışı aşağıdaki adımları içerir:

  1. GitHub'dan azd init var olan bir şablonu kopyalamak için komutunu parametresiyle --template çalıştırın.

    azd init --template todo-nodejs-mongo

  2. azd auth login Azure aboneliğinizde kimlik doğrulaması yapmak için komutunu çalıştırın.

    azd auth login

  3. azd up Şablon kaynaklarını sağlamak ve Azure'a dağıtmak için komutunu çalıştırın. komutu, azd up Azure kaynaklarını sağlamak ve uygulamanızı bu kaynaklara dağıtmak için şablonunuzdaki yapılandırma ve kod olarak altyapı (IaC) dosyalarından yararlanıyor.

    azd up

  4. Ortamınız Azure'da ayarlandıktan sonra uygulama özelliklerini veya Azure kaynak şablonlarını yerel olarak değiştirebilir ve değişikliklerinizi sağlamak için yeniden çalıştırabilirsiniz azd up .

Azure Geliştirici CLI şablon yapısını anlama

Tüm azd şablonlar, kurallar temelinde azd benzer bir dosya yapısını paylaşır. Gereken en düşük varlıklar genellikle aşağıdakileri içerir:

  • infra folder - Şablon için kod dosyaları olarak tüm Bicep veya Terraform altyapısını azd içerir. azd uygulamanızı barındırmak için gereken Azure kaynaklarını oluşturmak için bu dosyaları yürütür.

  • azure.yaml file - Projenizdeki bir veya daha fazla hizmeti tanımlayan ve bunları dağıtım için klasörde tanımlanan Azure kaynaklarıyla infra eşleyen bir yapılandırma dosyası. Örneğin, bir API hizmeti ve web ön uç hizmeti tanımlayabilir ve bunları dağıtım için farklı Azure kaynaklarıyla eşleyebilirsiniz.

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

  • src folder - Dağıtılabilir uygulama kaynak kodunun tümünü içerir. Bazı azd şablonlar klasörü dışlar src ve kendi uygulama kodunuzu ekleyebilmeniz için yalnızca altyapı varlıkları sağlar.

    Not

    Klasörü dışlayan src şablonlar genellikle altyapı başlangıç şablonları olarak tasarlanmıştır.

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

  • .github folder - Azd için varsayılan CI/CD sağlayıcısı olan GitHub Actions için CI/CD iş akışı dosyalarını tutar.
  • .azdo folder - CI/CD için Azure Pipelines kullanmaya karar verirseniz, bu klasördeki iş akışı yapılandırma dosyalarını tanımlayın.
  • .devcontainer folder - Uygulamanız için bir Geliştirme Kapsayıcısı ortamı ayarlamanıza olanak tanır.

Örneğin, ortak azd bir şablon aşağıdaki klasör yapısıyla eşleşebilir:

Azure Geliştirici CLI şablon yapısını gösteren ekran görüntüsü.

Var olan bir şablonla başlayın veya sahip olduğunuz şablonu oluşturun

Şablonlarla azd çalışmaya yönelik iki ana yaklaşım vardır:

  • Var olan azd bir şablonla başlayın.
    • Yeni kullanmaya başlıyorsanız azd veya benzer mimariye ve çerçevelere sahip yeni bir uygulama için derlemek üzere bir şablon arıyorsanız bu iyi bir seçimdir.
  • Var olan bir projeyi şablona azd dönüştürün.
    • Zaten bir uygulamanız varsa ancak bunu özelliklerle azd uyumlu hale getirmek istediğinizde bu iyi bir seçimdir.

Aşağıdaki bölümlerde bu iki seçenek hakkında daha fazla bilgi sağlanır.

Var olan bir şablonla başlayın

Awesome-azd şablon galerisinde çok çeşitli azd şablonlar mevcuttur. Bu şablonlar çeşitli geliştirme senaryoları, dil çerçeveleri ve Azure hizmetleri için altyapı ve uygulama kodu sağlar. Yerel uygulama yığınınızla veya istediğiniz mimariyle uyumlu bir şablon bulursanız, şablon kodunu kendinizle genişletebilir ve değiştirebilirsiniz

Örneğin, aşağıdaki azd şablonlar yaygın uygulama mimarileri ve çerçeveleri için başlangıç noktaları sağlar:

Template Uygulama konağı Teknik yığın
Azure'da C# API ve MongoDB ile React Web App Azure App Service NoSQL için Azure Cosmos DB, Bicep
Azure'da C# API ve SQL Veritabanı ile React Web App Azure App Service Azure SQL Veritabanı, Bicep
Azure'da Static React Web App + C# API ve SQL Veritabanı ile İşlevler Azure Static Web Apps, Azure İşlevleri Azure SQL Veritabanı, Bicep

Uygulamanız için yeni azd şablon oluşturma

Ayrıca, depoyu sağlama ve dağıtım özellikleriyle geliştirmek için mevcut bir azd uygulamayı şablona dönüştürebilirsiniz. Bu yaklaşım en fazla denetimi sağlar ve uygulamada gelecekteki geliştirme çalışmaları için yeniden kullanılabilir bir çözüm üretir. Kendi şablonunuzu oluşturmanın üst düzey adımları şunlardır:

  • proje şablonunu ile azd initbaşlatın.
  • Bicep veya Terraform altyapısını infra klasörde kod dosyaları olarak oluşturun.
  • azure.yaml Uygulama hizmetlerini Azure kaynaklarıyla ilişkilendirmek için dosyayı güncelleştirin.
  • ile azd upsağlama ve dağıtma.

Aşağıdaki kaynaklar kendi şablonlarınızı oluşturma hakkında daha fazla bilgi sağlar:

Şablonları kullanma azd yönergeleri

Azure Geliştirici CLI ile kullandığınız her şablonun, şablona eşlik eden sözleşme kapsamında ilgili sahibi (Microsoft olabilir veya olmayabilir) tarafından lisanslandığını lütfen unutmayın. Hangi lisansın kullanmayı seçtiğiniz herhangi bir şablon için geçerli olduğunu belirlemek sizin sorumluluğunuzdadır.

Microsoft, Microsoft dışı şablonlardan sorumlu değildir ve bu şablonları güvenlik, gizlilik, uyumluluk veya performans sorunları için taramaz. Microsoft'tan sağlananlar da dahil olmak üzere Azure Geliştirici CLI ile kullandığınız şablonlar herhangi bir Microsoft destek programı veya hizmeti tarafından desteklenmez. Microsoft tarafından sağlanan tüm şablonlar, hiçbir garanti olmadan OLDUĞU GIBI sağlanır.

Sonraki adımlar

Şablon seçme ve dağıtma