Azure Geliştirici CLI şablonunu keşfetme ve özelleştirme

Bu hızlı başlangıçta bir Azure Geliştirici CLI şablonunu keşfedip özelleştirebilirsiniz. hello-azd şablonu, Azure Geliştirici CLI'sını (azd ) kullanarak uygulama oluşturmak ve Azure'a dağıtmak için basit bir başlangıç noktası sağlar. Bu hızlı başlangıç, Hızlı Başlangıç - Azd şablonu dağıtma makalesinde açıklanan kavramlar üzerinde genişler.

Önkoşullar

Bu hızlı başlangıcı tarayıcınızda tamamlamak için aşağıdakiler gerekir:

• GitHub Codespaces'a erişim

Alternatif olarak, yerel araçları kullanarak bu hızlı başlangıcı tamamlamak için:

• Yerel makinenizde yüklü Azure Geliştirici CLI'sı
• Visual Studio Code veya seçtiğiniz düzenleyici
• Yerel makinenizde yüklü Docker masaüstü

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

azd şablonlar, ek varlıklar içeren 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 uygulamanızın gerektirdiği Azure kaynaklarını oluşturmak için bu dosyaları yürütür.
• src folder - Uygulama kaynak kodunu içerir. azd içindeki yapılandırmaları azure.yamltemel alarak kodu paketler ve dağıtır.
• 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 folder - Kaynakların dağıtılacağı konum gibi temel Azure yapılandırmalarını içerir.

Örneğin çoğu azd şablon aşağıdaki klasör yapısıyla eşleşti:

Şablon yapısı hakkında daha fazla ayrıntı için azd makalesini ziyaret edin.

Örnek şablonu ayarlama

hello-azd , tek bir komut kullanarak Azure'a azd dağıtabileceğiniz temel özelliklerini göstermek için tasarlanmış örnek bir şablondur. Şablon, hakkında azd bilgi içeren kolay bir kullanıcı arabirimi ve destek biletlerini karşıya yükleyip görüntülemenizi sağlayan küçük bir tanıtım aracı sağlar.

Şablon aşağıdaki özellikleri destekler:

• Kapsayıcılı bir uygulamayı Azure Container Apps'e paketler ve dağıtır
• Azure Cosmos DB veritabanı gibi uygulamanın ihtiyaç duyduğu Azure kaynaklarını oluşturur
• komutunu kullanarak azd pipeline config

Şablonu ayarlamak için şu adımları izleyin:

Şablonu keşfetme

Şablon seçtiğiniz araçta açıkken, şablonların nasıl azd çalıştığını keşfetmek için klasör yapısına göz atabilirsiniz:

1. src Uygulamanın kaynak kodunu görüntülemek için klasörü genişletin.

   • Şablon, hello-azd örnek bilet verileri hakkında azd bilgi edinmek ve yönetmek için basit bir kullanıcı arabirimi sağlayan kapsayıcılı bir .NET uygulaması içerir. azd ayrıca JavaScript ve Python gibi diğer dilleri de destekler.
   • komutunu çalıştırdığınızda azd up, uygulama kapsayıcı görüntüsü olarak paketlenmiş ve Azure Container Apps'e dağıtılır.

2. infra Kod dosyası olarak altyapıyı keşfetmek için klasörü genişletin.

   • Bu şablon, Azure kaynakları oluşturmak için Bicep dosyalarını (.bicep) kullanır, ancak Terraform (.tf) da kullanabilirsiniz.

   • main.bicep dosyası, infra klasöründe bulunan bir Azure Depolama hesabı gibi diğer Bicep modüllerine referans vererek Azure kaynakları oluşturur.

     // Omitted...
     
     // Create a storage account
     module storage './core/storage/storage-account.bicep' = {
         name: 'storage'
         scope: rg
         params: {
         name: !empty(storageAccountName) ? storageAccountName : '${abbrs.storageStorageAccounts}${resourceToken}'
         location: location
         tags: tags
         containers: [
             {
             name: 'attachments'
             }
         ]
         }
     }
     
     // Omitted...
     

3. Şablonun kökünde, temel şablon yapılandırmalarını görüntülemek için dosyayı açın azure.yaml :

   • Şablon adlı acabir hizmet tanımlar.

   • aca hizmet yapılandırması, azd için src klasöründeki kaynak kodu paketleyip daha önce incelediğiniz Bicep modülleri tarafından sağlanan Azure Container App'e dağıtmasını belirtir.

   • docker yapılandırmaları, azd'e uygulamayı kapsayıcı olarak paketlemesi ve dağıtması talimatını verir.

     metadata:
       template: hello-azd-dotnet  # Specifies the template being used
     name: azd-starter  # Name of the project
     services:
       aca:  # Define the Azure Container App service
         project: ./src  # Path to the source code
         language: csharp  # Programming language
         host: containerapp  # Hosting service
         docker:
           path: ./Dockerfile  # Location of the Dockerfile
     

Şablonu Güncelleştirme

Dağıtılan uygulamayı ve kaynakları etkilemek için şablonda değişiklik yapabilirsiniz. Bu örnekte uygulamada iki küçük değişiklik yapar ve dağıtılan sonuçları keşfedersiniz:

• Uygulama başlığı karşılama metnini kendi iletinize güncelleyin
• Oluşturulan depolama hesabını güncelleştirerek bir yerine iki blob kapsayıcısı oluşturmasını sağlayın

Bu değişiklikleri yapmak için aşağıdaki adımları tamamlayın:

1. src > Components > Pages klasöründe bileşeni açınHome.razor.

2. Sayfanın üst kısmındaki Hello, Azure Developer CLI! üst bilgi metnini Hello, özelleştirilmiş şablon gibi farklı bir iletiyle değiştirin ve değişikliklerinizi kaydedin.

   <MudText Typo="Typo.h2" GutterBottom="true">Hello, customized template!</MudText>
   

3. infra klasöründe main.bicep dosyasını açın.

4. 75. satırda depolama hesabı ve blob kapsayıcısı oluşturan Bicep kodu bloğunu bulun:

   // Create a storage account
   module storage './core/storage/storage-account.bicep' = {
     name: 'storage'
     scope: rg
     params: {
       name: !empty(storageAccountName) ? storageAccountName : '${abbrs.storageStorageAccounts}${resourceToken}'
       location: location
       tags: tags
       containers: [
         {
           name: 'attachments'
         }
       ]
     }
   }
   

   Kodu aşağıdaki kod parçacığıyla değiştirin:

   // Create a storage account
   module storage './core/storage/storage-account.bicep' = {
     name: 'storage'
     scope: rg
     params: {
       name: !empty(storageAccountName) ? storageAccountName : '${abbrs.storageStorageAccounts}${resourceToken}'
       location: location
       tags: tags
       containers: [
         {
           name: 'attachments'
         },
         {
           name: 'archive'
         }
       ]
     }
   }
   
   

Şablonu Çalıştırma

Değişikliklerinizi yaptıktan sonra, uygulama kaynaklarını sağlamak ve dağıtmak için komutunu kullanın azd up :

1. Proje dizininde bir terminal açın.

2. Şablonu sağlamak ve dağıtmak için komutunu azd up çalıştırın:

   azd up
   

   Bu komut:

   • Uygulamayı dağıtım için paketleme
   • Gerekli Azure kaynaklarını sağlama
   • Uygulamanızı güncelleştirilmiş değişikliklerle dağıtma
   • Dağıtılan uygulamanın URL'sini yazdırma

3. Güncelleştirilmiş uygulamanızı canlı olarak görmek için tarayıcınızdaki konsol çıkış günlüklerinde azd yazdırılan URL'yi açın.

   

4. Oluşturulan iki blob kapsayıcısını görüntülemek için Azure portalında oluşturulan depolama hesabına gidin.

   

Sonuç

Bu hızlı başlangıçta şablonun hello-azd yapısını keşfettiniz, uygulamasını ve altyapısını özelleştirip Azure Geliştirici CLI'sini kullanarak Azure'a dağıttınız. Daha gelişmiş senaryolar için diğer şablonları keşfedin veya belgelere azd daha yakından bakın.

Sonraki adımlar

• Azure Geliştirici CLI komutları nelerdir?
• Azure Geliştirici CLI şablonları nedir?
• Azure Geliştirici CLI Şablonlarına Genel Bakış