Aracılığıyla paylaş

Python web azd şablonlarına genel bakış

Python web Azure Geliştirici CLI (azd) şablonları, Python web uygulamaları oluşturmanın, yapılandırmanın ve Azure'a dağıtmanın en hızlı ve en kolay yoludur. Bu makalede, söz konusu bileşenleri ve şablonların dağıtımı nasıl kolaylaştırdığınızı anlamanıza yardımcı olacak bağlamsal arka plan bilgileri sağlanır.

Başlamanın en iyi yolu , hızlı başlangıcı izleyerek ilk Python web uygulamanızı oluşturmak ve şablonlarla azd dakikalar içinde Azure'a dağıtmaktır. Yerel bir geliştirme ortamı ayarlamayı tercih etmiyorsanız, önceden yapılandırılmış tüm araçlarla tamamen bulut tabanlı bir deneyim için GitHub Codespaces'i kullanarak hızlı başlangaç kılavuzunu izleyebilirsiniz.

Python web azd şablonları nelerdir?

Şablonlar, Azure'da azd minimum kurulum süresiyle ölçeklenebilir, buluta hazır uygulamalar dağıtmak isteyen deneyimli Python web geliştiricileri için tasarlanmıştır.

Bu şablonlar python web uygulamalarını oluşturmak ve dağıtmak için şu şekilde mümkün olan en kolay başlangıç noktasını sunar:

  • Eksiksiz bir yerel geliştirme ve barındırma ortamını hızla ayarlama.
  • Eşleşen bir Azure dağıtım ortamının oluşturulmasını otomatikleştirme.
  • Basit ve akılda kalıcı bir CLI iş akışı kullanma.

Ortamlarınız ayarlandıktan sonra şablonlar, Python web uygulamanızı oluşturmaya başlamanın en hızlı yolunu sağlar. Şunları yapabilirsiniz:

  • Sağlanan kod dosyalarını uygulamanızın gereksinimlerine uyacak şekilde değiştirin.
  • Azd komutlarını kullanarak güncelleştirmeleri en az çabayla dağıtın.
  • Şablonu mimarinize uyacak şekilde genişletin.

Bu şablonlar kanıtlanmış tasarım desenlerini ve en iyi uygulamaları yansıtarak şunları gerçekleştirmenizi sağlar:

  • Sağlam bir mimari temel üzerinde güvenle oluşturun.
  • Python ve Azure'da derin deneyime sahip sektör uzmanları tarafından geliştirilen yönergeleri izleyin.
  • Başlangıçtan itibaren sürdürülebilirliği, ölçeklenebilirliği ve güvenliği sağlayın.

Şablonlarla hangi görevleri gerçekleştirebilirim?

Bir Python web azd şablonu çalıştırdığınızda birkaç görevi hızla tamamlarsınız:

  • Başlangıç uygulaması oluşturun. Relecloud adlı kurgusal bir şirket için bir web sitesi oluşturursunuz. Bu başlangıç projesi şunları içerir:

    • İyi düzenlenmiş, üretime hazır kod
    • Python web çerçeveleri için en iyi yöntemler (Flask, Django gibi).
    • Bağımlılıkların, yapılandırmanın ve yapının düzgün kullanımı.

    Şablon bir başlangıç noktası olacak şekilde tasarlanmıştır; mantığı serbestçe özelleştirebilir ve Azure kaynaklarını projenize uyacak şekilde genişletebilir veya kaldırabilirsiniz.

  • Azure kaynaklarını sağlama. Şablon, kod olarak altyapı (IaC) dili olan Bicep'i kullanarak aşağıdakiler için gerekli tüm Azure kaynaklarını sağlar:

    • Web uygulamanızı barındırma (App Service, Container Apps gibi)
    • Veritabanlarına bağlanma (PostgreSQL, Cosmos DB gibi)

    Bicep dosyaları tamamen düzenlenebilir; uygulamanız geliştikçe Azure hizmetlerini ekleyebilir veya özelleştirebilirsiniz. Önceki göreve benzer şekilde, gerektiğinde daha fazla Azure hizmeti eklemek için Bicep şablonlarını değiştirebilirsiniz .

  • Sağlanan Azure kaynaklarına başlangıç uygulaması dağıtın. Kaynaklar sağlandıktan sonra uygulamanız otomatik olarak Azure ortamına dağıtılır. Şimdi şunları yapabilirsiniz:

    • Birkaç dakika içinde bulutta çalışan uygulamanızı görün.
    • Davranışını test edin.
    • Bir sonraki güncellemede hangi işlevselliği veya yapılandırmayı güncelleyeceğinize karar verin.

  • (İsteğe bağlı) GitHub deposunu ve CI/CD işlem hattını ayarlayın. İsteğe bağlı olarak GitHub Actions sürekli entegrasyon/sürekli teslimat (CI/CD) ardışık düzeniyle bir GitHub deposu başlatabilirsiniz:

    • Kod değişikliklerinde dağıtımları otomatikleştirme.
    • Ekip üyeleriyle işbirliği yapma.
    • Ana dala birleştirerek güncelleştirmeleri Azure'a gönderin.

    Bu tümleştirme, en baştan DevOps en iyi yöntemlerini benimsemenize yardımcı olur.

Şablonlara nereden erişebilirim?

Harika Azure Geliştirici CLI Şablonları galerisinde birçok azd şablon mevcuttur. Bu şablonlar, Azure hizmetlerinin ve Python web çerçevelerinin popüler birleşimleri arasında özellik eşliği ile kullanıma hazır Python web uygulaması projeleri sağlar.

Her şablon şunları içerir:

  • Temiz, bakım yapılabilir koda sahip örnek bir uygulama.
  • Bicep kullanarak kod şeklinde önceden yapılandırılmış altyapı.
  • Azure Geliştirici CLI'sını kullanarak sorunsuz dağıtım iş akışları.
  • GitHub Actions aracılığıyla isteğe bağlı CI/CD tümleştirmesi

Aşağıdaki tablolarda, azd komutuyla birlikte kullanılabilecek Python web şablon adları azd init listelenmektedir. Tablolar, her şablonda uygulanan teknolojileri tanımlar ve değişikliklere katkıda bulunabileceğiniz ilgili GitHub deposuna bir bağlantı sağlar.

azd Aşağıdaki şablonlar Django web çerçevesi için kullanılabilir.

Şablon Veritabanı Barındırma platformu GitHub depo alanı
azure-django-postgres-flexible-aca PostgreSQL için Azure Veritabanı Esnek Sunucusu Azure Container Apps https://github.com/Azure-Samples/azure-django-postgres-flexible-aca
azure-django-postgres-flexible-appservice esnek sunucu PostgreSQL için Azure Veritabanı Azure App Service https://github.com/Azure-Samples/azure-django-postgres-flexible-appservice
Azure-Django-Cosmos-Postgres-ACA PostgreSQL için Azure Veritabanı için Azure Cosmos DB Azure Konteyner Uygulamaları https://github.com/Azure-Samples/azure-django-cosmos-postgres-aca
azure-django-cosmos-postgres-uygulama servisi PostgreSQL için Azure Veritabanı için Azure Cosmos DB Azure App Service https://github.com/Azure-Samples/azure-django-cosmos-postgres-appservice
Azure-Django-Postgres-Eklenti-ACA PostgreSQL için Azure Veritabanı ile Azure Container Apps Azure Konteyner Uygulamaları https://github.com/Azure-Samples/azure-django-postgres-addon-aca

Şablonları nasıl kullanmalıyım?

Her azd şablon, Azure kaynaklarını oluşturmak için uygulama kodunu (popüler bir web çerçevesi kullanan Python kodu) ve kod olarak altyapı (yani Bicep) dosyalarını içeren bir GitHub deposundan oluşur. Şablon, CI/CD işlem hattıyla GitHub deposu ayarlamak için gereken yapılandırmayı da içerir.

Her şablonun temel bileşenleri şunlardır:

  • Uygulama Kodu: Python'da yazılır ve popüler bir web çerçevesi (Flask, Django, FastAPI gibi) kullanılarak derlenir. Örnek uygulama yönlendirme, veri erişimi ve yapılandırma ile ilgili en iyi yöntemleri gösterir.

  • Kod Olarak Altyapı (IaC): Aşağıdakiler gibi gerekli Azure kaynaklarını tanımlamak ve sağlamak için Bicep dosyaları aracılığıyla sağlanır:

    • Uygulama Hizmeti veya Kapsayıcı Uygulamalar
    • Azure Veritabanları (PostgreSQL, Cosmos DB gibi)
    • Azure AI hizmetleri, Depolama ve daha fazlası

  • CI/CD Yapılandırması (İsteğe bağlı): GitHub Actions CI/CD işlem hattıyla GitHub deposu ayarlamak için dosyaları içerir ve şunları etkinleştirir:

    • Ana dala yapılan her gönderme veya çekme isteğinde Azure'a otomatik dağıtım.
    • DevOps iş akışınızla sorunsuz tümleştirme

    Bu şablonlar tamamen özelleştirilebilir ve projenizin özel ihtiyaçlarına göre derlemeniz ve bunlara uyum sağlamanız için güçlü bir temel sağlar.

Bir azd web şablonu tarafından tanımlanan görevleri gerçekleştirmek için çeşitli Python azd komutlarını kullanırsınız. Bu komutların ayrıntılı açıklamaları için bkz . Hızlı Başlangıç: Azure Geliştirici CLI şablonu dağıtma. Hızlı başlangıç, belirli azd bir şablonu kullanma adımlarını gösterir. Üretim barındırma ortamına ve yerel geliştirme ortamına yalnızca beş temel komut satırı yönergesi çalıştırmanız gerekir.

Aşağıdaki tabloda beş temel komut özetlemektedir:

Komut Görev açıklaması
azd init --template <template name> Şablondan yeni bir proje oluşturun ve yerel bilgisayarınızda uygulama kodunun bir kopyasını oluşturun. Komut, dağıtılan kaynakların adlandırmasında ön ek olarak kullanılan bir ortam adı ("myapp" gibi) sağlamanızı ister.
azd auth login Azure'da oturum açın. Komut, Azure'da oturum açabileceğiniz bir tarayıcı penceresi açar. Oturum açıldıktan sonra tarayıcı penceresi kapatılıp komut tamamlanmıştır. Komut azd auth login yalnızca oturum başına Azure Geliştirici CLI'sini (azd) ilk kez kullandığınızda gereklidir.
azd up Bulut kaynaklarını sağlayın ve uygulamayı bu kaynaklara dağıtın.
azd deploy Uygulama kaynak kodundaki değişiklikleri komut tarafından önceden sağlanan kaynaklara dağıtın azd up .
azd down Kullanıldıysa Azure kaynaklarını ve CI/CD işlem hattını silin.

Tavsiye

Komutlarla azd çalışırken, daha fazla bilgi girmeniz gerektiğinde çıkan istemlere dikkat edin. Komutu yürüttkten azd up sonra, birden fazla aboneliğiniz varsa bir abonelik seçmeniz istenebilir. Bölgenizi belirtmeniz de istenebilir. Şablonun /.azure/ klasöründe depolanan ortam değişkenlerini düzenleyerek istemlerin yanıtlarını değiştirebilirsiniz.

Şablon tarafından azd sağlanan temel görevleri tamamladıktan sonra, istediğiniz dosyayı gerektiği gibi değiştirebileceğiniz özgün şablonun kişisel bir kopyasına sahip olursunuz.

  • Uygulama Kodu: Kendi tasarımınızı, yollarınızı ve iş mantığınızı uygulamak için Python proje kodunu özelleştirin.
  • Kod Olarak Altyapı (Bicep): Ek Azure hizmetleri sağlamak, yapılandırmaları değiştirmek veya gereksiz kaynakları kaldırmak için Bicep dosyalarını güncelleştirin.

Bu esnek başlangıç noktası, uygulamayı gerçek dünya kullanım örneğiniz için uyarlarken iyi yapılandırılmış bir temel üzerine oluşturmanıza olanak tanır.

Azure kaynaklarını değiştirmeniz gerekiyorsa kod olarak altyapı yapılandırmasını da değiştirebilirsiniz. Daha fazla bilgi için bu makalenin devamında yer alan Neleri düzenleyebilirim veya silebilirim bölümüne bakın.

İsteğe bağlı şablon görevleri

Beş temel komutun yanı sıra, şablonlarla azd tamamlayabileceğiniz isteğe bağlı görevler de vardır.

Azure kaynaklarını yeniden sağlama ve değiştirme

Azure kaynaklarını bir azd şablonla sağladıktan sonra, bir kaynağı değiştirebilir ve yeniden sağlayabilirsiniz.

CI/CD işlem hattını ayarlama

Azure Geliştirici CLI'si (azd), yeni Python web uygulamanız için CI/CD işlem hattı ayarlamanın kolay bir yolunu sağlar. İşlemeleri veya çekme isteklerini ana dalınızla birleştirdiğinizde işlem hattı değişiklikleri otomatik olarak oluşturur ve Azure kaynaklarınızda yayımlar.

  • CI/CD işlem hattını ayarlamak için GitHub deposunu ve işlem hattını etkinleştirmek için istediğiniz ayarları belirlersiniz.
  • İşlem hattını oluşturmak için komutunu kullanın azd pipeline config .

İşlem hattını yapılandırdıktan sonra, kod değişiklikleri deponun ana dalına her birleştirildiğinde, işlem hattı bu değişiklikleri sağlanmış Azure hizmetlerinize dağıtır.

Şablonlara alternatifler

Python web şablonlarını kullanmamak isterseniz, Python web azd uygulamalarını Azure'a dağıtmak ve Azure kaynaklarını sağlamak için alternatif yöntemler vardır.

Çeşitli araçları kullanarak birçok kaynak oluşturabilir ve dağıtım adımlarını tamamlayabilirsiniz:

Python web geliştirme çerçevelerini içeren uçtan uca bir öğreticiyi de izleyebilirsiniz:

Sıkça sorulan sorular

Aşağıdaki bölümlerde Python web azd şablonlarıyla çalışma hakkında sık sorulan soruların yanıtları özetlemektedir.

Geliştirme Kapsayıcıları'nı kullanmam gerekiyor mu?

Hayır. Python web azd şablonları varsayılan olarak Visual Studio Code Geliştirme Kapsayıcıları'nı kullanır. Geliştirme Kapsayıcıları birçok avantaj sağlar, ancak bazı önkoşul bilgi ve yazılım gerektirir. Geliştirme Kapsayıcıları'nı kullanmamak ve bunun yerine yerel geliştirme ortamınızı kullanmak istiyorsanız, ortam kurulum yönergeleri için örnek uygulamanın kök dizinindeki README.md dosyasına bakın.

Neleri düzenleyebilir veya silebilirim?

Her Python web azd şablonunun içeriği, projenin türüne ve kullanılan temel teknoloji yığınına bağlı olarak farklılık gösterebilir. Bu makalede tanımlanan şablonlar, aşağıdaki tabloda açıklandığı gibi ortak bir klasör ve dosya kuralına uyar.

Klasör/dosya Amaç Açıklama
/ Kök dizin Her şablonun kök klasörü, farklı amaçlar için birçok farklı türde dosya ve klasör içerir.
/.azure azd yapılandırma dosyaları .azure klasörü, komutu çalıştırıldıktan azd init sonra oluşturulur. klasörü, komutlar tarafından azd kullanılan ortam değişkenleri için yapılandırma dosyalarını depolar. Uygulamayı ve Azure kaynaklarını özelleştirmek için ortam değişkenlerinin değerlerini değiştirebilirsiniz. Daha fazla bilgi için bkz . Ortama özgü .env dosyası.
/.devcontainer Geliştirme Kapsayıcısı yapılandırma dosyaları Geliştirme Kapsayıcıları, Visual Studio Code içinde yazılım geliştirme için ihtiyacınız olan tüm kaynakları içeren kapsayıcı tabanlı bir geliştirme ortamı oluşturmanıza olanak tanır. .devcontainer klasörü, Visual Studio Code şablon komutuna yanıt olarak bir Geliştirme Kapsayıcısı yapılandırma dosyası oluşturduktan sonra oluşturulur.
/.github GitHub Actions yapılandırma dosyaları Bu klasör isteğe bağlı GitHub Actions CI/CD işlem hattı, lint ve testler için yapılandırma ayarlarını içerir. Komutunu kullanarak azd pipeline config GitHub Actions işlem hattını ayarlamak istemiyorsanız azure-dev.yaml dosyasını değiştirebilir veya silebilirsiniz.
/infra Bicep dosyaları infra klasöründe Bicep yapılandırma dosyaları bulunur. Bicep, ortamınıza dağıtılmasını istediğiniz Azure kaynaklarını bildirmenize olanak tanır. Yalnızca main.bicep ve web.bicep dosyalarını değiştirmeniz gerekir. Daha fazla bilgi için bkz: Hızlı Başlangıç: Azd Python web şablonlarıyla dağıtılan hizmetleri Bicep kullanarak ölçeklendirme.
/Src Başlangıç proje kodu dosyaları src klasörü, başlangıç projesini hazırlamak için gereken çeşitli kod dosyalarını içerir. Dosyalara örnek olarak web çerçevesinin gerektirdiği şablonlar, statik dosyalar, kod mantığı ve veri modelleri için Python (.py) dosyaları, requirements.txt dosyası ve daha fazlası verilebilir. Belirli dosyalar web çerçevesine, veri erişim çerçevesine vb. bağlıdır. Bu dosyaları proje gereksinimlerinize uyacak şekilde değiştirebilirsiniz.
/.cruft.json Şablon oluşturma dosyası .cruft JSON dosyası, Python web azd şablonlarını oluşturmak için dahili olarak kullanılır. Gerektiğinde bu dosyayı güvenle silebilirsiniz.
/.gitattributes Git için öznitelik ayarlarına sahip dosya Bu dosya, git'e dosya ve klasörleri işlemek için önemli yapılandırma ayarları sağlar. Bu dosyayı gerektiği gibi değiştirebilirsiniz.
/.gitignore Git için yoksayılan öğeleri içeren dosya .gitignore dosyası, şablonun GitHub deposuna yazarken hariç tutulacak (yoksayılan) dosya ve klasörler hakkında git'e bilgi sağlar. Bu dosyayı gerektiği gibi değiştirebilirsiniz.
/azure.yaml azd up yapılandırma dosyası Bu yapılandırma dosyası, komutun yapılandırma ayarlarını azd up içerir. Dağıtılacak hizmetleri ve proje klasörlerini belirtir. Önemli: Bu dosya silinmemelidir.
/*.md Markdown biçim dosyaları Şablon, farklı amaçlar için çeşitli Markdown (.md) biçim dosyalarını içerebilir. Markdown dosyalarını güvenle silebilirsiniz.
/docker-compose.yml Docker compose ayarları Bu YML dosyası, uygulama Azure'a dağıtmadan önce Python web uygulaması için kapsayıcı paketini oluşturur.
/pyproject.toml Python yapı ayar dosyası TOML dosyası, Python projelerinin derleme sistemi gereksinimlerini içerir. Belirli bir linter veya birim testi çerçevesi gibi araç tercihlerinizi belirlemek için bu dosyayı değiştirebilirsiniz.
/requirements-dev.in pip gereksinim dosyası Bu dosya, komutunu kullanarak pip install -r gereksinimlerin geliştirme ortamı sürümünü oluşturmak için kullanılır. Bu dosyayı gerektiği gibi diğer paketleri içerecek şekilde değiştirebilirsiniz.

Tavsiye

Programınız için şablon dosyalarını değiştirirken iyi bir sürüm denetimi uygulamayı unutmayın. Bu yaklaşım, yeni değişiklikler program sorunlarına neden olursa deponuzu önceki bir çalışma sürümüne geri yüklemenize yardımcı olabilir.

Şablon hatalarını nasıl işleyebilirim?

Şablon kullanırken azd hata alırsanız Azure Geliştirici CLI sorunlarını giderme makalesinde açıklanan seçenekleri gözden geçirin. Ayrıca, şablonla azd ilişkilendirilmiş GitHub deposundaki sorunları bildirebilirsiniz.

İlgili içerik

  • Last updated on