Azure Geliştirici CLI'sı (azd) şablonu geliştirmeye genel bakış

Azure Geliştirici CLI (azd) şablonları, Azure'da bir çözüm sağlamak ve dağıtmak için gereken yapılandırmayı, altyapıyı ve isteğe bağlı uygulama kodunu paketlemektedir. Bir uygulama, yalnızca altyapı projesi veya gelecekteki projeler için yeniden kullanılabilir bir başlangıç noktası için şablon kullanabilirsiniz.

Note

Başlamadan önce şablon yapısının, gerekli ve isteğe bağlı varlıkların, hizmet-kaynak ilişkilendirmelerinin ve komutların her dosyayı nasıl azd kullandığının tam açıklaması için Geliştirici CLI şablonları Azure okuyun.

Şablon geliştirme iş akışı

Aşağıdaki iş akışı, ister bir şablon oluşturun ister mevcut bir şablonu başlatın, geçerlidir:

Azure Geliştirici CLI şablonu geliştirme iş akışının diyagramı. Sol tarafta , "Başlangıç noktası seçin" etiketli bir kutu iki seçenek içerir: "Yeni bir şablonla başlayın" ve "Var olan bir şablondan başla." Her iki seçenek de "Şablon dosyalarını keşfetme ve düzenleme" seçeneğine yol açar. Buradan, isteğe bağlı bir yol aşağıda "Şablonu genişlet"e gider ve ana yol "azd up" komutunu çalıştırma adımıyla devam eder. "Şablonu genişlet" adımı da "Azd up'ı çalıştır"a yol açar. Son olarak, "azd up komutunu çalıştır" ifadesi "Şablonu koru veya paylaş"a yönlendirir.

• Bir başlangıç noktası seçin:GitHub Copilot tümleştirmesi, başka bir yapay zeka kodlama yardımcısı veya doğrudan yazma ile yeni bir şablonla başlayın. Alternatif olarak, Microsoft, kuruluşunuz veya geliştirici topluluğundan mevcut bir şablondan başlayın.
• Dosyaları keşfedin ve düzenleyin: , Bicep veya Terraform dosyalarının, uygulama kodunun ve destekleyici yapılandırmanın birlikte nasıl azure.yamlçalıştığını gözden geçirin. Bkz . Şablon dosyalarını keşfetme ve düzenleme.
• Gerektiğinde genişletin ve geliştirin: Uygulama ve altyapı bileşenlerini ekleyin, değiştirin, kaldırın veya yeniden tasarlayın. Azure kaynağı ekleyip bir uygulamaya bağlayan uçtan uca bir örnek için Şablonu genişletme bölümünü izleyin.
• Sağlama ve dağıtma: Altyapıyı sağlamak ve tüm uygulama hizmetlerini dağıtmak için komutunu çalıştırın azd up . Daha fazla bilgi için bkz. İş akışını keşfetmeazd up.
• Bakım veya paylaşım: Projeniz geliştikçe şablonu düzenlemeye devam edin. Paylaşmayı planlıyorsanız, önce temiz bir dizinde ve yeni azd bir ortamla test edin.

Note

Bu iş akışı boyunca şablon dosyalarını kendiniz veya yapay zeka kodlama yardımcısı yardımıyla oluşturabilir, düzenleyebilir veya değiştirebilirsiniz. Sonuç aynı standart, düzenlenebilir azd varlıklar kümesidir.

Şablon yapı taşları

Her azd şablon farklı bir çözümü destekler, ancak çoğu şablon aynı varlık türlerini birleştirir:

• Project yapılandırması: Dosya azure.yaml project, dağıtılabilir hizmetleri, kaynak dizinleri, barındırma hedeflerini ve isteğe bağlı kancaları veya iş akışlarını tanımlar.
• Kod olarak altyapı: Bicep veya Terraform dosyaları çözümün gerektirdiği Azure kaynaklarını, rol atamalarını, ağ ve uygulama ayarlarını tanımlar.
• Uygulama kaynağı: Bir şablon bir veya daha fazla dağıtılabilir uygulama veya yalnızca altyapı içerebilir.
• Ortam yapılandırması: Parametreler ortama özgü değerleri dağıtımlara geçirir ve altyapı çıkışları etkin azd ortamdaki değerlere dönüşür.

Bir uygulama şablonu aşağıdaki klasör yapısını kullanabilir:

.
├── azure.yaml                # Project configuration
├── infra/                    # Infrastructure as code
│   ├── main.bicep
│   ├── main.parameters.json
│   └── modules/
├── src/                      # Application source
│   ├── api/
│   └── web/
├── .github/                  # Pipeline workflows
│   └── workflows/
└── README.md

Tam yapı projeye göre değişir. Uygulama kaynağı, altyapı modülleri ve işlem hattı dosyaları isteğe bağlıdır ve azure.yaml kullanan azd yolları tanımlar. Bu varlıklar şablon geliştirme yaşam döngüsü boyunca birlikte çalışır.

Sonraki Adımlar

Yeni bir şablonla başlayın

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.