Azure'da PostgreSQL ile Python (Django veya Flask) web uygulaması dağıtma

• Etkin aboneliği olan bir Azure hesabı. Azure hesabınız yoksa ücretsiz olarak bir hesap oluşturabilirsiniz.
• Flask geliştirmesi ile Python veya Django geliştirme ile Python bilgisi

• Etkin aboneliği olan bir Azure hesabı. Azure hesabınız yoksa ücretsiz olarak bir hesap oluşturabilirsiniz.
• Azure Geliştirici CLI'sı yüklü. Azure Geliştirici CLI'sı zaten yüklü olduğundan Azure Cloud Shell ile adımları izleyebilirsiniz.
• Flask geliştirmesi ile Python veya Django geliştirme ile Python bilgisi

1. App Service ve PostgreSQL oluşturma

Bu adımda Azure kaynaklarını oluşturursunuz. Bu öğreticide kullanılan adımlar, App Service ve PostgreSQL için Azure Veritabanı içeren varsayılan olarak güvenli bir kaynak kümesi oluşturur. Oluşturma işlemi için şunları belirteceksiniz:

• Web uygulamasının Adı. Web uygulamanızın DNS adının bir parçası olarak biçiminde kullanılan addır https://<app-name>.azurewebsites.net.
• Uygulamayı dünyada fiziksel olarak çalıştırılacak Bölge.
• Uygulamanın Çalışma Zamanı yığını . Burası, uygulamanız için kullanılacak Python sürümünü seçtiğiniz yerdir.
• Uygulama için Barındırma planı . Bu, uygulamanız için özellik kümesini ve ölçeklendirme kapasitesini içeren fiyatlandırma katmanıdır.
• Uygulamanın Kaynak Grubu . Kaynak grubu, uygulama için gereken tüm Azure kaynaklarını gruplandırmanıza (mantıksal bir kapsayıcıda) olanak tanır.

Azure portalında oturum açın ve Azure Uygulaması Hizmeti kaynaklarınızı oluşturmak için bu adımları izleyin.

2. Bağlantı gizli dizilerinin güvenliğini sağlama

Oluşturma sihirbazı sizin için zaten bir uygulama ayarı olarak veritabanı bağlantı dizesini oluşturdu. Ancak en iyi güvenlik uygulaması, gizli dizileri App Service'in dışında tutmaktır. Gizli dizilerinizi bir anahtar kasasına taşır ve Hizmet Bağlayıcıları'nın yardımıyla uygulama ayarınızı Key Vault başvurusu olarak değiştirirsiniz.

Özetlemek gerekirse, App Service'in ortam değişkenlerinden PostgreSQL bağlantı dizesi alma, özel erişimle güvenli gizli dizi yönetimi için bir Azure Key Vault oluşturma ve anahtar kasasında parolayı depolamak için hizmet bağlayıcısını güncelleştirme işlemi gerçekleştirilir. Sistem tarafından atanan yönetilen kimlik kullanılarak App Service uygulaması ile anahtar kasası arasında güvenli bir bağlantı kuruldu ve bağlantı dizesi bir Key Vault başvurusu kullandığı onaylanarak kurulum doğrulandı.

Sorun mu yaşıyorsunuz? Sorun Giderme bölümüne bakın.

3. Örnek kodu dağıtma

Bu adımda GitHub Actions'ı kullanarak GitHub dağıtımını yapılandıracaksınız. App Service'e dağıtmanın birçok yolundan yalnızca biridir, aynı zamanda dağıtım sürecinizde sürekli tümleştirmeye sahip olmanın harika bir yoludur. Varsayılan olarak, GitHub deponuzun her git push örneği derleme ve dağıtma eylemini başlatacaktır.

Sorun mu yaşıyorsunuz? Sorun giderme kılavuzuna bakın.

4. Veritabanı şeması oluşturma

5. Uygulamaya göz atın

6. Tanılama günlüklerini akışla aktarma

Azure Uygulaması Hizmeti, uygulamanızla ilgili sorunları tanılamanıza yardımcı olmak için konsola gönderilen tüm iletileri yakalar. Örnek uygulama, aşağıda gösterildiği gibi bu özelliği gösteren deyimler içerir print() .

@app.route('/', methods=['GET'])
def index():
    print('Request for index page received')
    restaurants = Restaurant.query.all()
    return render_template('index.html', restaurants=restaurants)

def index(request):
    print('Request for index page received')
    restaurants = Restaurant.objects.annotate(avg_rating=Avg('review__rating')).annotate(review_count=Count('review'))
    lastViewedRestaurant = request.session.get("lastViewedRestaurant", False)

Python uygulamanız için Azure İzleyici'yi ayarlama konusundaki serideki Python uygulamalarında oturum açma hakkında daha fazla bilgi edinin.

7. Kaynakları temizleme

İşiniz bittiğinde, kaynak grubunu silerek Azure aboneliğinizdeki tüm kaynakları silebilirsiniz.

1. Azure kaynakları oluşturma ve örnek uygulama dağıtma

Bu adımda Azure kaynaklarını oluşturur ve Linux üzerinde App Service için örnek bir uygulama dağıtırsınız. Bu öğreticide kullanılan adımlar, App Service ve PostgreSQL için Azure Veritabanı içeren varsayılan olarak güvenli bir kaynak kümesi oluşturur.

1. Henüz yapmadıysanız, örnek deponun dalını starter-no-infra yerel terminalde kopyalayın.

   • Şişe
   • Django

   git clone -b starter-no-infra https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app
   cd msdocs-flask-postgresql-sample-app
   

   Bu kopyalanan dal başlangıç noktanızdır. Basit bir veri sürücüsü Flask uygulaması içerir.

2. Depo kökünden komutunu çalıştırın azd init.

   azd init --template python-app-service-postgresql-infra
   

3. İstendiğinde aşağıdaki yanıtları verin:

   Soru	Yanıt
   Geçerli dizin boş değil. Burada '<your-directory>' içinde bir proje başlatmak istiyor musunuz?	Y
   Bu dosyalarla ne yapmak istiyorsunuz?	Mevcut dosyalarımı değiştirmeden tut
   Yeni bir ortam adı girin	Benzersiz bir ad yazın. azd şablonu, Azure'da (<app-name>.azurewebsites.net) web uygulamanızın DNS adının bir parçası olarak bu adı kullanır. Alfasayısal karakterlere ve kısa çizgilere izin verilir.

4. azd up Gerekli Azure kaynaklarını sağlamak ve uygulama kodunu dağıtmak için komutunu çalıştırın. Azure'da henüz oturum açmadıysanız tarayıcı başlatılır ve oturum açmanızı ister. Komut azd up ayrıca, dağıtılacak istenen aboneliği ve konumu seçmenizi ister.

   azd up
   

   Komutun azd up tamamlanması birkaç dakika sürebilir. Ayrıca uygulama kodunuzu derleyip dağıtır, ancak kodunuzu daha sonra App Service ile çalışacak şekilde değiştireceksiniz. Komutu çalışırken, Azure'daki dağıtıma bir bağlantı da dahil olmak üzere sağlama ve dağıtım işlemiyle ilgili iletiler sağlar. Tamamlandığında, komut dağıtım uygulamasının bağlantısını da görüntüler.

   Bu azd şablonu, aşağıdaki Azure kaynaklarıyla varsayılan olarak güvenli bir mimari oluşturan dosyaları (azure.yaml ve infra dizini) içerir:

   • Şişe
   • Django

   • Kaynak grubu → Oluşturulan tüm kaynaklar için kapsayıcı.
   • App Service planı → App Service için işlem kaynaklarını tanımlar. B1 katmanında bir Linux planı belirtilir.
   • App Service → Uygulamanızı temsil eder ve App Service planında çalışır.
   • Sanal ağ → App Service uygulamasıyla tümleşiktir ve arka uç ağ trafiğini yalıttır.
   • PostgreSQL için Azure Veritabanı esnek sunucu → Yalnızca sanal ağ içinden erişilebilir. Sunucuda sizin için bir veritabanı ve kullanıcı oluşturulur.
   • Özel DNS bölge → Sanal ağdaki PostgreSQL sunucusunun DNS çözümlemesini etkinleştirir.
   • Log Analytics çalışma alanı →, uygulamanızın günlüklerini göndermesi için hedef kapsayıcı görevi görür ve burada günlükleri de sorgulayabilirsiniz.

2. Veritabanı bağlantı dizesi kullanın

Kullandığınız azd şablonu sizin için zaten uygulama ayarları olarak bağlantı değişkenlerini oluşturmuş ve kolaylık sağlamak için bunları terminale çıkış olarak göndermektedir. Uygulama ayarları, bağlantı gizli dizilerini kod deponuzun dışında tutmanın bir yoludur.

1. azd çıkışında uygulama ayarlarını bulun ve ve AZURE_REDIS_CONNECTIONSTRINGayarlarını AZURE_POSTGRESQL_CONNECTIONSTRING bulun. Gizli dizileri güvende tutmak için yalnızca ayar adları görüntülenir. Bunlar azd çıkışında şöyle görünür:

    App Service app has the following settings:
   
            - AZURE_POSTGRESQL_CONNECTIONSTRING
            - AZURE_REDIS_CONNECTIONSTRING
            - FLASK_DEBUG
            - SCM_DO_BUILD_DURING_DEPLOYMENT
            - SECRET_KEY
    

2. AZURE_POSTGRESQL_CONNECTIONSTRINGAzure'daki Postgres veritabanına bağlantı dizesi ve AZURE_REDIS_CONNECTIONSTRING Azure'daki Redis önbelleğine bağlantı dizesi içerir. Bunlara bağlanmak için kodunuzu kullanmanız gerekir. azureproject/production.py açın, aşağıdaki satırları açın ve dosyayı kaydedin:

   • Şişe
   • Django

   conn_str = os.environ['AZURE_POSTGRESQL_CONNECTIONSTRING']
   conn_str_params = {pair.split('=')[0]: pair.split('=')[1] for pair in conn_str.split(' ')}
   DATABASE_URI = 'postgresql+psycopg2://{dbuser}:{dbpass}@{dbhost}/{dbname}'.format(
       dbuser=conn_str_params['user'],
       dbpass=conn_str_params['password'],
       dbhost=conn_str_params['host'],
       dbname=conn_str_params['dbname']
   )
   

   Uygulama kodunuz artık Azure'daki PostgreSQL veritabanına bağlanacak şekilde yapılandırılmıştır. İstersen, açın app.py ve ortam değişkeninin DATABASE_URI nasıl kullanıldığını görün.

3. Terminalde azd deploy komutunu çalıştırın.

   azd deploy
   

4. Veritabanı şeması oluşturma

PostgreSQL veritabanı sanal ağ tarafından korunduğunda, Flask veritabanı geçişlerini çalıştırmanın en kolay yolu App Service kapsayıcısı ile bir SSH oturumudur.

5. Uygulamaya göz atın

1. azd çıkışında uygulamanızın URL'sini bulun ve tarayıcıda bu URL'ye gidin. URL, AZD çıkışında şöyle görünür:

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: https://<app-name>.azurewebsites.net/
    

2. Listeye birkaç restoran ekleyin.

   • Şişe
   • Django

   

   Tebrikler, Azure Uygulaması Hizmeti'nde PostgreSQL için Azure Veritabanı güvenli bağlantısı olan bir web uygulaması çalıştırıyorsunuz.

6. Tanılama günlüklerini akışla aktarma

Azure Uygulaması Hizmeti, uygulamanızla ilgili sorunları tanılamanıza yardımcı olmak için konsol günlüklerini yakalayabilir. Kolaylık olması için azd şablonu yerel dosya sisteminde günlüğe kaydetmeyi ve bunları Log Analytics çalışma alanına göndermeyi zaten etkinleştirmiştir.

Örnek uygulama, aşağıdaki kod parçacığında gösterildiği gibi bu özelliği göstermek için deyimler içerir print() .

@app.route('/', methods=['GET'])
def index():
    print('Request for index page received')
    restaurants = Restaurant.query.all()
    return render_template('index.html', restaurants=restaurants)

def index(request):
    print('Request for index page received')
    restaurants = Restaurant.objects.annotate(avg_rating=Avg('review__rating')).annotate(review_count=Count('review'))
    lastViewedRestaurant = request.session.get("lastViewedRestaurant", False)

azd çıkışında App Service günlüklerinin akışının bağlantısını bulun ve tarayıcıda bu bağlantıya gidin. Bağlantı, azd çıkışında şöyle görünür:

Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

Python uygulamanız için Azure İzleyici'yi ayarlama konusundaki serideki Python uygulamalarında oturum açma hakkında daha fazla bilgi edinin.

7. Kaynakları temizleme

Geçerli dağıtım ortamındaki tüm Azure kaynaklarını silmek için komutunu çalıştırın azd down.

azd down