Aracılığıyla paylaş

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

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

  • Python web çerçevesini, Azure veritabanı platformunu ve üzerinde oluşturmak istediğiniz Azure web barındırma platformunu temel alan bir azd şablonu seçin.
  • Cli komutlarını kullanarak azd şablonu çalıştırarak örnek bir web uygulaması ve veritabanı oluşturun ve gerekli Azure kaynaklarını oluşturun ve yapılandırın. Ardından örnek web uygulamasını Azure 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 komutu kullanın.

Bu dersin tamamlanması 15 dakikadan az sürmelidir. bitirdiğinizde, ö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 bkz:

Önkoşullar

Azure aboneliği - Ücretsiz bir abonelik oluştur

Yerel bilgisayarınıza aşağıdaki araçları yükleyin:

Şablon seçin

Python web çerçevesi, Azure web barındırma platformu ve üzerinde oluşturmak istediğiniz Azure veritabanı platformunu temel alan bir azd şablonu seçin.

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

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

Şablonu çalıştırma

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

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

    mkdir azdtest
cd azdtest

    Bu hızlı başlangıç için Visual Studio Code 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ı elde için kısa bir ad, küçük harf kullanın ve özel karakter kullanmayın.

  3. Azure hesabınızda azd kimliğini doğrulamak için terminalinize aşağıdaki komutları girin ve istemi izleyin:

    azd auth login

    "Hesap seçin" sorulduğunda yönergeleri izleyin veya Azure hesabınızda oturum açın. Başarıyla kimlik doğrulaması yaptı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

    azd up başarıyla tamamlandığında, örnek web uygulaması genel İnternet'te kullanılabilir ve Azure Aboneliğiniz oluşturulan tüm kaynaklar için ücret tahakkuk eder. Ş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 seçmeniz istendiğinde yönergeleri izleyin ve ardından kullanılacak Azure konumu seçin. Coğrafi olarak size yakın bir bölge seçin.

    azd up yürütüldüğünde, birden çok Azure hizmetinin sağlanıp dağıtılması 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ı bitirdiğinizde, azd up tarafından oluşturulan tüm hizmetleri kaldırmak için azd down kullanın.

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

    azd komut satırı arabiriminden alınan başarılı çıkışın ekran görüntüsü; Azure'de dağıtılan çalışan Relecloud uygulamasını görüntülemek için uç nokta URL'sinin etrafında bir açıklama balonu ile.

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

  7. Web tarayıcınızda yeni bir sekme açın.

    1. Önceki adımdaki ikinci URL'yi kopyalayın ve konum çubuğuna yapıştırın.
    2. 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

Ardından, web uygulamasında küçük bir değişiklik yapın ve sonra yeniden dağıtın.

  1. Visual Studio Code açın ve 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. Geliştirme Kapsayıcısı bildirimi Visual Studio Code'de göründüğünde, Kapsayıcıda Yeniden Aç düğmesini seçin.

  3. src/templates klasörüne gitmek için Visual Studio Code 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, azd komutlarını çalıştırmak için Visual Studio Code Terminal bölmesini kullanmayın.

  5. Komut tamamlandığında, güncelleştirmeyi görmek için web tarayıcınızı yenileyin. Kullandığınız 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:

  • komutunun oluşturduğu kaynakları kaldırmak için komutunu çalıştırın azd down . Alternatif olarak, Azure portalında oluşturduğunuz 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. Adı kısa tutun, küçük harfler kullanın, sayı, büyük harf ve özel karakter kullanmayın.
  • 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 bkz. SSS.

İlgili içerik

  • Last updated on