Aracılığıyla paylaş

Hızlı Başlangıç: Azd şablonu kullanarak Python web uygulaması oluşturma ve Azure'a dağıtma

Bu hızlı başlangıç, Bir Python web ve veritabanı çözümü oluşturmanın ve Azure'a dağıtmanın en kolay ve en hızlı yolu boyunca size yol gösterir. Bu hızlı başlangıçtaki yönergeleri izleyerek şunları yapacaksınız:

  • Python web çerçevesini, Azure veritabanı platformunu ve üzerinde derlemek istediğiniz Azure web barındırma platformunu temel alan bir azd şablon seçin.
  • Cli komutlarını kullanarak şablon azd çalıştırarak örnek bir web uygulaması ve veritabanı oluşturun, gerekli Azure kaynaklarını oluşturun ve yapılandırın, ardından örnek web uygulamasını Azure'a dağıtın.
  • Yerel bilgisayarınızda web uygulamasını düzenleyin ve yeniden dağıtmak için bir azd komut kullanın.
  • Azure kaynaklarını temizlemek için bir azd komut kullanın.

Bu dersin tamamlanması 15 dakikadan az sürmelidir. Tamamlandıktan sonra, özel kodunuzla yeni projeyi değiştirmeye başlayabilirsiniz.

Python web uygulaması geliştirmeye yönelik bu azd şablonlar hakkında daha fazla bilgi edinmek için:

Önkoşullar

Azure aboneliği - Ücretsiz bir tane oluşturun

Yerel bilgisayarınızda aşağıdakilerin yüklü olması gerekir:

Şablon seçin

Python web çerçevesini, Azure web barındırma platformunu ve üzerinde derlemek istediğiniz Azure veritabanı platformunu temel alan bir azd şablon seçin.

  1. Aşağıdaki tablolardaki şablon listesinden bir şablon adı (ilk sütun) seçin. Sonraki bölümdeki adım sırasında azd init şablon adını kullanacaksınız.

    Şablon Web Çerçevesi Veritabanı Barındırma Platformu GitHub Deposu
    azure-django-postgres-flexible-aca Django (Türkçe) PostgreSQL Esnek Sunucusu Azure Konteyner Uygulamaları depo
    azure-django-postgres-flexible-appservice Django (Türkçe) PostgreSQL Esnek Sunucusu Azure App Service depo
    Azure-Django-Cosmos-Postgres-ACA Django (Türkçe) Cosmos DB (PostgreSQL Bağdaştırıcısı) Azure Konteyner Uygulamaları depo
    azure-django-cosmos-postgres-uygulama servisi Django (Türkçe) Cosmos DB (PostgreSQL Bağdaştırıcısı) Azure App Service depo
    Azure-Django-Postgres-Eklenti-ACA Django (Türkçe) Azure Container Apps PostgreSQL Eklentisi Azure Konteyner Uygulamaları depo

GitHub deposu (son sütun) yalnızca başvuru amacıyla sağlanır. Yalnızca şablonda değişikliklere katkıda bulunmak istiyorsanız depoyu doğrudan kopyalamanız gerekir. Aksi takdirde, normal bir iş akışında şablonla etkileşime geçmek için azd CLI'yı kullanmak amacıyla bu hızlı başlangıç kılavuzundaki yönergeleri izleyin.

Şablonu çalıştırma

azd Şablon çalıştırmak, diller ve çerçeveler arasında aynıdır. Ayrıca, aynı temel adımlar tüm şablonlar için de geçerlidir. Adımlar şunlardır:

  1. Terminalde, yerel bilgisayarınızda normalde yerel git depolarınızı depoladığınız bir klasöre gidin, ardından azdtest adlı yeni bir klasör oluşturun. Ardından cd komutunu kullanarak o dizine geçin.

    mkdir azdtest
cd azdtest

    Bu hızlı başlangıç için Visual Studio Code'un Terminali'ni kullanmayın.

  2. Yerel geliştirme ortamını ayarlamak için terminalinize aşağıdaki komutları girin ve tüm istemleri yanıtlayın:

    azd init --template <template name>

    <template name> Yerine önceki adımda seçtiğiniz tablolardan birini (örneğin azure-django-postgres-aca) yazın.

    Ortam adı istendiğinde azdtest veya başka bir ad kullanın. Ortam adı, Azure kaynak gruplarını ve kaynaklarını adlandırırken kullanılır. En iyi sonuçlar için kısa bir ad, küçük harfler kullanın, özel karakterler kullanmayın.

  3. Azure hesabınızda kimlik doğrulaması azd yapmak için terminalinize aşağıdaki komutları girin ve istemi izleyin:

    azd auth login

    "Hesap seçin" sorulduğunda veya Azure hesabınızda oturum açmanız istendiğinde yönergeleri izleyin. Kimliğiniz başarıyla doğrulandıktan sonra, bir web sayfasında şu ileti görüntülenir: "Kimlik doğrulaması tamamlandı. Uygulamaya dönebilirsiniz. Bu tarayıcı sekmesini kapatmaktan çekinmeyin."

    Sekmeyi kapattığınızda kabuk şu iletiyi görüntüler:

    Logged in to Azure.

  4. Sonraki adımı denemeden önce Docker Desktop'ın açık ve arka planda çalıştığından emin olun.

  5. Gerekli Azure kaynaklarını oluşturmak için terminalinize aşağıdaki komutları girin ve tüm istemleri yanıtlayın:

    azd up

    Önemli

    Başarıyla azd up tamamlandığında, örnek web uygulaması genel internette erişilebilir hale gelecek ve Azure Aboneliğiniz, oluşturulan tüm kaynaklar için ücret tahakkuk etmeye başlayacak. Şablonları oluşturanlar, ücretsiz katmanların azd genellikle kullanılabilirliği kısıtlanmış olduğundan, kasıtlı olarak uygun maliyetli katmanları seçtiler ancak ücretsiz katmanları seçmeleri zorunlu değildir.

    Ödeme için kullanılacak Azure Aboneliği'ni seçmeniz istendiğinde yönergeleri izleyin ve ardından kullanılacak azure konumunu seçin. Coğrafi olarak size yakın bir bölge seçin.

    azd up çalıştırmak, birden çok Azure hizmeti sağladığı ve dağıttığı için birkaç dakika sürebilir. İlerleme durumu görüntülendiğinde hataları izleyin. Hatalar görürseniz sorunu çözmek için aşağıdakileri deneyin:

    • azd-quickstart klasörünü ve hızlı başlangıç yönergelerini baştan silin.
    • İstendiğinde ortamınız için daha basit bir ad seçin. Yalnızca küçük harfler ve kısa çizgiler kullanın. Sayı, büyük harf veya özel karakter yok.
    • Farklı bir konum seçin.

    Sorun yaşamaya devam ediyorsanız, bu belgenin en altındaki Sorun Giderme bölümüne bakın.

    Önemli

    Örnek web uygulamasıyla çalışmayı tamamladıktan sonra, azd down tarafından oluşturulan tüm hizmetleri kaldırmak için azd up kullanın.

  6. azd up Başarıyla tamamlandığında aşağıdaki çıkış görüntülenir:

    Azure'da dağıtılan Relecloud uygulamasının çalıştığını görüntülemek için uç nokta URL'sinin çevresinde bir ek açıklamayla azd komut satırı arabiriminden alınan başarılı çıkışın ekran görüntüsü.

    Azure'da canlı çalışan örnek web uygulaması projesini görmek için sözcüğün - Endpoint: ardından ilk URL'yi kopyalayın ve bir web tarayıcısının konum çubuğuna yapıştırın.

  7. Web tarayıcınızda yeni bir sekme açın, önceki adımdaki ikinci URL'yi kopyalayın ve konum çubuğuna yapıştırın. Azure portalı, örnek web uygulaması projesini barındırmak için dağıtılan yeni kaynak grubunuzdaki tüm hizmetleri görüntüler.

Düzenleme ve yeniden dağıtma

Sonraki adım, web uygulamasında küçük bir değişiklik yapmak ve sonra yeniden dağıtmaktır.

  1. Visual Studio Code'ı açın ve daha önce oluşturulan azdtest klasörünü açın.

  2. Bu şablon isteğe bağlı olarak Geliştirme Kapsayıcıları kullanacak şekilde yapılandırılmıştır. Visual Studio Code'da Geliştirme Kapsayıcısı bildiriminin göründüğünü gördüğünüzde "Kapsayıcıda Yeniden Aç" düğmesini seçin.

  3. src/templates klasörüne gitmek için Visual Studio Code'un Explorer görünümünü kullanın ve index.html dosyasını açın. Aşağıdaki kod satırını bulun:

    <h1 id="pagte-title">Welcome to ReleCloud</h1>

    H1 içindeki metni değiştirin:

    <h1 id="pagte-title">Welcome to ReleCloud - UPDATED</h1>

    Değişikliklerinizi kaydedin.

  4. Değişikliğinizle uygulamayı yeniden dağıtmak için terminalinizde aşağıdaki komutu çalıştırın:

    azd deploy

    Dev Kapsayıcıları'nı kullandığınızdan ve kapsayıcının kabuğuna uzaktan bağlandığınızdan, komutları çalıştırmak azd için Visual Studio Code'un Terminal bölmesini kullanmayın.

  5. Komut tamamlandıktan sonra, güncelleştirmeyi görmek için web tarayıcınızı yenileyin. Kullanılan web barındırma platformuna bağlı olarak, değişikliklerinizin görünmesi birkaç dakika sürebilir.

    Artık şablondaki dosyaları düzenlemeye ve silmeye hazırsınız. Daha fazla bilgi için bkz. Şablonda neleri düzenleyebilir veya silebilirim?

Kaynakları temizle

  1. komutunu çalıştırarak azd down şablon tarafından oluşturulan kaynakları temizleyin.

    azd down

    azd down komutu Azure kaynaklarını ve GitHub Actions iş akışını siler. İstendiğinde, kaynak grubuyla ilişkili tüm kaynakları silmeyi kabul edin.

    Ayrıca azdtest klasörünü silebilir veya projenin dosyalarını değiştirerek kendi uygulamanızın temeli olarak kullanabilirsiniz.

Sorun giderme

sırasında azd uphatalar görürseniz aşağıdaki adımları deneyin:

  • Oluşturulmuş olabilecek tüm kaynakları kaldırmak için komutunu çalıştırın azd down . Alternatif olarak, Azure portalında oluşturulan kaynak grubunu silebilirsiniz.
  • Yerel bilgisayarınızdaki azdtest klasörünü silin.
  • Azure portalında Anahtar Kasalarını arayın. Silinen kasaları yönet'i seçin, aboneliğinizi seçin, azdtest adını veya ortamınızı adlandırdığınız her şeyi içeren tüm anahtar kasalarını seçin ve Temizle'yi seçin.
  • Bu hızlı başlangıçtaki adımları yeniden deneyin. Bu kez istendiğinde ortamınız için daha basit bir ad seçin. Kısa bir ad deneyin, küçük harflerle, sayı yok, büyük harf yok, özel karakter yok.
  • Hızlı başlangıç adımlarını yeniden denerken farklı bir konum seçin.

Olası sorunların ve çözümlerin daha kapsamlı bir listesi için SSS bölümüne bakın.

İlgili İçerik

  • Last updated on