Aracılığıyla paylaş

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

Azure Geliştirici CLI (azd) şablonları, örnek uygulama kodunun yanı sıra azd yapılandırma ve altyapı dosyalarını içeren normal 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 uygun şekilde tasarlanmış ve yapılandırılmış ortam kullanan 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ı
  • Azure Monitor kaynakları, örneğin Application Insights gösterge tabloları
  • Ö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 mevcut mimari şablonlardan faydalanarak kaynakları sağlamak ve dağıtmak için kullanabilirsiniz. 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ı, azd komutları ile azd init ve azd up gibi ç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 bir azd iş akışı aşağıdaki adımları içerir:

  1. GitHub'dan mevcut bir şablonu klonlamak için azd init komutunu --template parametresiyle ç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. Şablon kaynaklarını sağlamak ve Azure'a dağıtmak için azd up 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 azd up yeniden çalıştırabilirsiniz.

Azure Geliştirici CLI şablon yapısını keşfetme

azd şablonlar, bazı ek varlıkların dahil olduğu standart kod depolarıdır. Tüm azd şablonlar, kurallar temelinde azd benzer bir dosya yapısını paylaşır:

  • infra klasör - azd şablonu için kod dosyaları olarak tüm Bicep veya Terraform altyapısını içerir. azd bu dosyaları yürüterek uygulamanızı barındırmak için gereken Azure kaynaklarını oluşturur.
  • azure.yaml file - Projenizdeki kaynak kod klasörlerini dağıtım için klasörde tanımlanan Azure kaynaklarıyla infra eşleyen bir yapılandırma dosyası. Örneğin, ayrı klasörlerde bir API hizmeti ve web ön uç hizmeti tanımlayabilir ve bunları dağıtım için farklı Azure kaynaklarına eşleyebilirsiniz.
  • .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 folder - Dağıtılabilir uygulama kaynak kodunun tümünü içerir. Bazı azd şablonlar src klasörünü dışlar ve yalnızca kendi uygulama kodunuzu ekleyebilmeniz için altyapı varlıkları sağlar.

Ö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ü.

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 klasör - 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.

Mevcut bir şablonla başlayın veya kendi şablonunuzu oluşturun

azd şablonlarıyla ç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

azd şablon galerisinde çok çeşitli ş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:

Şablon 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 C# API ve SQL Veritabanı ile Static React Web App + İş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 azd initile başlatın.
  • Bicep veya Terraform altyapısını infra klasörde kod dosyaları olarak oluşturun.
  • uygulama hizmetlerini Azure kaynaklarıyla ilişkilendirmek için azure.yaml dosyasını güncelleştirin.
  • & sağlama azd upile dağıt.

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

  • Last updated on