Azure Uygulaması Hizmeti'ne python web uygulaması derlemek ve dağıtmak için Azure Pipelines'ı kullanma

Azure DevOps Services

Sürekli tümleştirme ve sürekli teslim (CI/CD) için Azure Pipelines'ı kullanarak Linux üzerinde Azure Uygulaması Hizmeti'ne bir Python web uygulaması oluşturun ve dağıtın. İşlem hattınız, depoya yönelik bir işleme olduğunda Python web uygulamanızı otomatik olarak derleyip App Service'e dağıtır.

Bu makalede şunları öğreneceksiniz:

• Azure Uygulama Hizmeti'nde bir web uygulaması oluşturun.
• Azure DevOps'ta proje oluşturma.
• DevOps projenizi Azure'a Bağlan.
• Python'a özgü bir işlem hattı oluşturun.
• Uygulamanızı derlemek ve App Service'te web uygulamanıza dağıtmak için işlem hattını çalıştırın.

Önkoşullar

• Azure aboneliği. Aboneliğiniz yoksa ücretsiz bir hesap oluşturun.
• Bir GitHub hesabı. Yoksa ücretsiz bir tane oluşturun.
• Azure DevOps Services kuruluşu. Ücretsiz bir tane oluşturun.

Uygulama kodunuz için depo oluşturma

GitHub hesabınıza konumundaki örnek deponun https://github.com/Microsoft/python-sample-vscode-flask-tutorial çatalını oluşturun.

Yerel ana bilgisayarınızda GitHub deponuzu kopyalayın. öğesini çatallanmış deponuzun URL'si ile değiştirerek <repository-url> aşağıdaki komutu kullanın.

git clone <repository-url>

Uygulamanızı yerel olarak test edin

Çalıştığından emin olmak için uygulamayı yerel olarak derleyin ve çalıştırın.

1. Kopyalanan depo klasörüne geçin.

   cd python-sample-vscode-flask-tutorial
   

2. Uygulamayı derleyin ve çalıştırın

   Linux

   python -m venv .env
   source .env/bin/activate
   pip install --upgrade pip
   pip install -r ./requirements.txt
   export set FLASK_APP=hello_app.webapp
   python3 -m flask run
   

   PowerShell

   py -m venv .env
   .env\scripts\activate
   pip install -r ./requirements.txt
   $env:FLASK_APP = "hello_app.webapp"
   flask run
   

3. Uygulamayı görüntülemek için bir tarayıcı penceresi açın ve adresine http://localhost:5000gidin. başlığını Visual Studio Flask Tutorialgördüğünüzden emin olun.

4. İşiniz bittiğinde tarayıcı penceresini kapatın ve Ctrl+C ile Flask sunucusunu durdurun.

Bir Cloud Shell açma

1. https://portal.azure.com adresinden Azure portalında oturum açın.

2. Portal araç çubuğunda Cloud Shell düğmesini seçerek Azure CLI'yi açın.

   

3. Cloud Shell, tarayıcının alt kısmında görünür. Açılan menüden Bash'i seçin.

   

4. Size daha fazla çalışma alanı sağlamak için ekranı kapla düğmesini seçin.

Azure Uygulaması Hizmeti web uygulaması oluşturma

Azure portalında Cloud Shell'den Azure Uygulaması Service web uygulamanızı oluşturun.

İpucu

Cloud Shell'e yapıştırmak için Ctrl+Shift+V kullanın veya sağ tıklayıp bağlam menüsünden Yapıştır'ı seçin.

1. Deponuzu aşağıdaki komutla kopyalayın ve yerine <repository-url> çatallanmış deponuzun URL'sini yazın.

   git clone <repository-url>
   

2. Komutun uygulamayı Python uygulaması olarak tanıması için dizini kopyalanmış depo klasörüne az webapp up değiştirin.

   cd python-sample-vscode-flask-tutorial
   

3. App Service'i sağlamak ve uygulamanızın ilk dağıtımını yapmak için az webapp up komutunu kullanın. değerini Azure genelinde benzersiz bir adla değiştirin <your-web-app-name> . Genellikle, gibi <your-name>-flaskpipelinesbir uygulama tanımlayıcısı ile birlikte kişisel veya şirket adı kullanırsınız. Uygulama URL'si your-appservice.azurewebsites.net> olur<.

   az webapp up --name <your-web-app-name>
   

   Komutun JSON çıkışı şunları az webapp up gösterir:

   {
     "URL": <your-web-app-url>,
     "appserviceplan": <your-app-service-plan-name>,
     "location": <your-azure-location>,
     "name": <your-web-app-name>,
     "os": "Linux",
     "resourcegroup": <your-resource-group>,
     "runtime_version": "python|3.11",
     "runtime_version_detected": "-",
     "sku": <sku>,
     "src_path": <repository-source-path>
   }
   

   URL ve runtime_version değerlerini not edin. İşlem hattı YAML dosyasında öğesini runtime_version kullanırsınız. URL, web uygulamanızın URL'sidir. Uygulamanın çalıştığını doğrulamak için bunu kullanabilirsiniz.

   Not

   az webapp up komutu şu eylemleri gerçekleştirir:

   • Varsayılan bir kaynak grubu oluşturun.

   • Varsayılan bir App Service planı oluşturun.

   • Belirtilen ada sahip bir uygulama oluşturun.

   • Zip, derleme otomasyonu etkinleştirilmiş olarak geçerli çalışma dizinindeki tüm dosyaları dağıtın .

   • Parametreleri yerel olarak .azure/config dosyasında önbelleğe alın; böylece daha sonra proje klasöründen veya diğer az webapp komutlarla az webapp up dağıtırken bunları yeniden belirtmeniz gerekmez. Önbelleğe alınan değerler varsayılan olarak otomatik olarak kullanılır.

   Komut parametrelerini kullanarak varsayılan eylemi kendi değerlerinizle geçersiz kılabilirsiniz. Daha fazla bilgi için bkz . az webapp up.

4. python-sample-vscode-flask-tutorial uygulamasında web uygulaması için belirli başlangıç komutunu içeren bir startup.txt dosyası vardır. Web uygulaması startup-file yapılandırma özelliğini olarak startup.txtayarlayın.

   1. Komut çıktısından az webapp up değeri kopyalayın resourcegroup .

   2. Kaynak grubunu ve uygulamanızın adını kullanarak aşağıdaki komutu girin.

   az webapp config set --resource-group <your-resource-group> --name <your-web-app-name> --startup-file startup.txt
   

   Komut tamamlandığında, web uygulamanızın tüm yapılandırma ayarlarını içeren JSON çıkışını gösterir.

5. Çalışan uygulamayı görmek için bir tarayıcı açın ve komut çıkışında gösterilene URLaz webapp up gidin. Genel bir sayfa görürseniz App Service'in başlatılması için birkaç saniye bekleyin ve sayfayı yenileyin. başlığını Visual Studio Flask Tutorialgördüğünüzden emin olun.

Azure DevOps projesi oluşturma

Yeni bir Azure DevOps projesi oluşturun.

1. Tarayıcıda dev.azure.com gidin ve oturum açın.
2. Kuruluşunuzu seçin.
3. Kuruluştaki ilk projeyi oluşturuyorsanız Yeni proje'yi veya Proje oluştur'u seçerek yeni bir proje oluşturun.
4. Bir Proje adı girin.
5. Projenizin Görünürlüğünü seçin.
6. Oluştur'u belirleyin.

Hizmet bağlantısı oluşturma

Hizmet bağlantısı, Azure Pipelines'tan dış ve uzak hizmetlere kimliği doğrulanmış erişim sağlamak için bir bağlantı oluşturmanıza olanak tanır. Azure Uygulaması Hizmeti web uygulamanıza dağıtmak için web uygulamasını içeren kaynak grubuna bir hizmet bağlantısı oluşturun.

1. Proje sayfasında Proje ayarları'nı seçin.

   

2. Menünün İşlem Hatları bölümünde Hizmet bağlantıları'nı seçin.

3. Hizmet bağlantısı oluştur’u seçin.

4. Azure Resource Manager'ı ve ardından İleri'yi seçin.

   

5. Kimlik doğrulama yönteminizi seçin ve İleri'yi seçin.

6. Yeni Azure hizmeti bağlantısı iletişim kutusunda, seçili kimlik doğrulama yöntemine özgü bilgileri girin. Kimlik doğrulama yöntemleri hakkında daha fazla bilgi için bkz. Azure Resource Manager hizmet bağlantısı kullanarak Azure'a Bağlan.

   Örneğin, İş Yükü Kimliği federasyonu (otomatik) veya Hizmet sorumlusu (otomatik) kimlik doğrulama yöntemi kullanıyorsanız, gerekli bilgileri girin.

   

   Alan	Açıklama
   Kapsam düzeyi	Abonelik seçin.
   Abonelik	Azure aboneliğinizin adı.
   Kaynak grubu	Web uygulamanızı içeren kaynak grubunun adı.
   Hizmet bağlantısı adı	Bağlantı için açıklayıcı bir ad.
   Tüm işlem hatlarına erişim izinleri verme	Tüm işlem hatlarına erişim vermek için bu seçeneği belirleyin.

7. Kaydet'i seçin.

Yeni bağlantı Hizmet bağlantıları listesinde görünür ve Azure İşlem Hattınızda kullanıma hazırdır.

İşlem hattı oluşturma

Python web uygulamanızı derlemek ve Azure Uygulaması Service'e dağıtmak için bir işlem hattı oluşturun. İşlem hattı kavramlarını anlamak için aşağıdakileri izleyin:

1. Sol gezinti menüsünde İşlem hatları'nı seçin.

   

2. İşlem Hattı Oluştur'u seçin.

   

3. Kodunuz nerede iletişim kutusunda GitHub'ı seçin. GitHub'da oturum açmanız istenebilir.

   

4. Depo seçin ekranında, çatallanmış örnek depoyu seçin.

   

5. Onay olarak GitHub parolanızı yeniden girmeniz istenebilir.

6. Azure Pipelines uzantısı GitHub'da yüklü değilse GitHub, Azure Pipelines uzantısını yüklemenizi ister.

   

   Bu sayfada, aşağı kaydırarak Depo erişimi bölümüne gidin, uzantının tüm depolara mı yoksa yalnızca seçili depolara mı yükleneceğini seçin ve ardından Onayla ve yükle'yi seçin.

   

7. İşlem hattınızı yapılandırın iletişim kutusunda Azure'da Python'ı Linux Web App'e seçin.

8. Azure aboneliğinizi seçin ve Devam'ı seçin.

9. Kimlik doğrulaması için kullanıcı adınızı ve parolanızı kullanıyorsanız Microsoft hesabınızda oturum açmanız için bir tarayıcı açılır.

10. Açılan listeden web uygulamanızın adını seçin ve Doğrula ve yapılandır'ı seçin.

Azure Pipelines bir azure-pipelines.yml dosyası oluşturur ve dosyayı YAML işlem hatları düzenleyicisinde görüntüler. İşlem hattı dosyası CI/CD işlem hattınızı, her adımın farklı görevler ve betikler için ayrıntıları içerdiği aşamalar, İşler ve adımlar dizisi olarak tanımlar. İşlem hattına göz atarak ne yaptığını görün. Tüm varsayılan girişlerin kodunuz için uygun olduğundan emin olun.

YAML işlem hattı dosyası

Aşağıdaki açıklama YAML işlem hattı dosyasını açıklar. İşlem hattı YAML dosya şeması hakkında bilgi edinmek için bkz . YAML şema başvurusu.

Değişkenler

variables bölümü aşağıdaki değişkenleri içerir:

variables:
# Azure Resource Manager connection created during pipeline creation
azureServiceConnectionId: '<GUID>'

# Web app name
webAppName: '<your-web-app-name>'

# Agent VM image name
vmImageName: 'ubuntu-latest'

# Environment name
environmentName: '<your-web-app-name>'

# Project root folder.
projectRoot: $(System.DefaultWorkingDirectory)

# Python version: 3.11. Change this to match the Python runtime version running on your web app.
pythonVersion: '3.11'

Değişken	Açıklama
azureServiceConnectionId	Azure Resource Manager hizmet bağlantısının kimliği veya adı.
webAppName	Azure Uygulaması Hizmeti web uygulamasının adı.
vmImageName	Derleme aracısı için kullanılacak işletim sisteminin adı.
environmentName	Dağıtım aşamasında kullanılan ortamın adı. Aşama işi çalıştırıldığında ortam otomatik olarak oluşturulur.
projectRoot	Uygulama kodunu içeren kök klasör.
pythonVersion	Derleme ve dağıtım aracılarında kullanılacak Python sürümü.

Derleme aşaması

Derleme aşaması, vmImageName değişkeninde tanımlanan işletim sisteminde çalışan tek bir iş içerir.

  - job: BuildJob
    pool:
      vmImage: $(vmImageName)

İş birden çok adım içerir:

1. UsePythonVersion görevi kullanılacak Python sürümünü seçer. Sürüm, değişkeninde pythonVersion tanımlanır.

      - task: UsePythonVersion@0
         inputs:
           versionSpec: '$(pythonVersion)'
           displayName: 'Use Python $(pythonVersion)'
   

2. Bu adım, sanal bir Python ortamı oluşturmak ve dosyanın içerdiği requirements.txt uygulamanın bağımlılıklarını yüklemek için bir betik kullanır. --target parametresi, bağımlılıkların yükleneceği konumu belirtir. workingDirectory parametresi, uygulama kodunun konumunu belirtir.

     - script: |
          python -m venv antenv
          source antenv/bin/activate
          python -m pip install --upgrade pip
          pip install setup
          pip install --target="./.python_packages/lib/site-packages" -r ./requirements.txt
        workingDirectory: $(projectRoot)
        displayName: "Install requirements"
   

3. ArchiveFiles görevi, web uygulamasını içeren .zip arşivini oluşturur. Dosya .zip , adlı dropyapıt olarak işlem hattına yüklenir. Dosya .zip , uygulamayı web uygulamasına dağıtmak için dağıtım aşamasında kullanılır.

      - task: ArchiveFiles@2
        displayName: 'Archive files'
        inputs:
          rootFolderOrFile: '$(projectRoot)'
          includeRootFolder: false
          archiveType: zip
          archiveFile: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip
          replaceExistingArchive: true
   
      - upload: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip
        displayName: 'Upload package'
        artifact: drop
   

   Parametre	Açıklama
   rootFolderOrFile	Uygulama kodunun konumu.
   includeRootFolder	Kök klasörün .zip dosyasına eklenip eklenmeyeceğini gösterir. Bu parametreyi false aksi şekilde ayarlayın, .zip dosyasının içeriği s adlı bir klasöre yerleştirilir ve Linux üzerinde App Service kapsayıcısı uygulama kodunu bulamaz.
   archiveType	Oluşturulacak arşiv türü. zip olarak ayarlayın.
   archiveFile	Oluşturulacak .zip dosyasının konumu.
   replaceExistingArchive	Dosya zaten varsa var olan bir arşivin değiştirilip değiştirilmeyeceğini gösterir. true olarak ayarlayın.
   upload	Karşıya yüklenecek .zip dosyasının konumu.
   artifact	Oluşturulacak yapıtın adı.

Dağıtım aşaması

Derleme aşaması başarıyla tamamlanırsa dağıtım aşaması çalıştırılır. Aşağıdaki anahtar sözcükler bu davranışı tanımlar:

  dependsOn: Build
  condition: succeeded()

Dağıtım aşaması, aşağıdaki anahtar sözcüklerle yapılandırılmış tek bir dağıtım işi içerir:

  - deployment: DeploymentJob
    pool:
      vmImage: $(vmImageName)
    environment: $(environmentName)

Anahtar kelime	Açıklama
deployment	İşin bir ortamı hedefleyen bir dağıtım işi olduğunu gösterir.
pool	Dağıtım aracısı havuzunu belirtir. Ad belirtilmemişse varsayılan aracı havuzu. anahtar sözcüğü, vmImage aracının sanal makine görüntüsü için işletim sistemini tanımlar
environment	Dağıtılacak ortamı belirtir. İş çalıştırıldığında projenizde ortam otomatik olarak oluşturulur.

strategy anahtar sözcüğü, dağıtım stratejisini tanımlamak için kullanılır. runOnce anahtar sözcüğü, dağıtım işinin bir kez çalıştırıldığını belirtir. deploy anahtar sözcüğü, dağıtım işinde çalıştırılacak adımları belirtir.

  strategy:
    runOnce:
      deploy:
        steps:

steps İşlem hattındakiler şunlardır:

1. Aracıda kullanılacak Python sürümünü belirtmek için UsePythonVersion görevini kullanın. Sürüm, değişkeninde pythonVersion tanımlanır.

    - task: UsePythonVersion@0
      inputs:
        versionSpec: '$(pythonVersion)'
      displayName: 'Use Python version'
   

2. AzureWebApp@1 kullanarak web uygulamasını dağıtın. Bu görev, işlem hattı yapıtını drop web uygulamanıza dağıtır.

   - task: AzureWebApp@1
      displayName: 'Deploy Azure Web App : <your-web-app-name>'
      inputs:
         azureSubscription: $(azureServiceConnectionId)
         appName: $(webAppName)
         package: $(Pipeline.Workspace)/drop/$(Build.BuildId).zip
   

   Parametre	Açıklama
   azureSubscription	Kullanılacak Azure Resource Manager hizmet bağlantı kimliği veya adı.
   appName	Web uygulamasının adı.
   package	Dağıtılacak .zip dosyasının konumu.

   Ayrıca, python-vscode-flask-tutorial deposu startup.txt adlı bir dosyada aynı başlangıç komutunu içerdiğinden, parametresini ekleyerek bu dosyayı belirtebilirsiniz: startUpCommand: 'startup.txt'.

İşlem hattını çalıştırma

Artık denemeye hazırsınız!

1. Düzenleyicide Kaydet ve çalıştır'ı seçin.

2. Kaydet ve çalıştır iletişim kutusunda bir işleme iletisi ekleyin, ardından Kaydet ve çalıştır'ı seçin.

   İşlem hattı çalıştırma özetinde Aşamalar veya İşler'i seçerek işlem hattını çalışırken izleyebilirsiniz.

   

   Her aşamanın ve işin yanında başarıyla tamamlandığında yeşil onay işaretleri vardır. Hatalar oluşursa, bunlar özette veya iş adımlarında görüntülenir.

   

   Özet sayfasının sağ üst kısmındaki dikey noktaları seçip İşlem hattını düzenle'yi seçerek YAML düzenleyicisine hızla dönebilirsiniz:

   

3. Dağıtım işinden Azure Web App'i Dağıt görevini seçerek çıktısını görüntüleyin. Dağıtılan siteyi ziyaret etmek için Ctrl tuşunu basılı tutarak url'yi seçinApp Service Application URL.

   Örnek uygulamayı kullanıyorsanız, uygulama aşağıdaki gibi görünmelidir:

   

Önemli

Uygulamanız eksik bağımlılık nedeniyle başarısız olursa requirements.txt dosyanız dağıtım sırasında işlenmez. Bu davranış, web uygulamasını bu makalede gösterildiği gibi komutunu kullanmak az webapp up yerine doğrudan portalda oluşturduysanız oluşur.

komutu özellikle az webapp up derleme eylemini SCM_DO_BUILD_DURING_DEPLOYMENT olarak trueayarlar. Uygulama hizmetini portal aracılığıyla sağladıysanız, bu eylem otomatik olarak ayarlanmaz.

Aşağıdaki adımlar eylemi ayarlar:

1. Azure portalını açın, App Service'inizi ve ardından Yapılandırma'yı seçin.
2. Uygulama Ayarlar sekmesinin altında Yeni Uygulama Ayarı'nı seçin.
3. Açılan pencerede, Ad SCM_DO_BUILD_DURING_DEPLOYMENT olarak ayarlayın, Değertrueolarak ayarlayın ve Tamam'ı seçin.
4. Yapılandırma sayfasının üst kısmındaki Kaydet'i seçin.
5. İşlem hattını yeniden çalıştırın. Bağımlılıklarınız dağıtım sırasında yüklenmelidir.

İşlem hattı çalıştırmasını tetikleme

İşlem hattı çalıştırmasını tetikleme için depoda bir değişiklik gerçekleştirin. Örneğin, uygulamaya yeni bir özellik ekleyebilir veya uygulamanın bağımlılıklarını güncelleştirebilirsiniz.

1. GitHub deponuza gidin.
2. Kodda, örneğin uygulamanın başlığını değiştirme gibi bir değişiklik yapın.
3. Değişikliği deponuza işleyin.
4. İşlem hattınıza gidin ve yeni bir çalıştırma oluşturulduğunu doğrulayın.
5. Çalıştırma tamamlandığında yeni derlemenin web uygulamanıza dağıtıldığından emin olun.
   1. Azure portalında web uygulamanıza gidin.
   2. Dağıtım Merkezi'niseçin ve Günlükler sekmesini seçin.
   3. Yeni dağıtımın listelendiğini doğrulayın.

Django için dikkat edilmesi gerekenler

Ayrı bir veritabanı kullanıyorsanız Django uygulamalarını Linux'ta Azure Uygulaması Hizmeti'ne dağıtmak için Azure Pipelines'ı kullanabilirsiniz. App Service db.sqlite3 dosyasını kilitleyerek hem okumaları hem de yazmaları engellediği için SQLite veritabanı kullanamazsınız. Bu davranış dış veritabanını etkilemez.

App Service'te Python uygulamasını yapılandırma - Kapsayıcı başlatma işlemi bölümünde açıklandığı gibi App Service, uygulama kodunuz içinde genellikle uygulama nesnesini içeren bir wsgi.py dosyasını otomatik olarak arar. Başlangıç komutunu herhangi bir şekilde özelleştirmek istiyorsanız, önceki bölümde açıklandığı gibi YAML işlem hattı dosyanızın adımındaki parametresini AzureWebApp@1 kullanınstartUpCommand.

Django kullanırken genellikle uygulama kodunu dağıtdıktan sonra kullanarak manage.py migrate veri modellerini geçirmek istersiniz. Bu amaçla dağıtım sonrası betiğiyle ekleyebilirsiniz startUpCommand :

startUpCommand:  python manage.py migrate

Derleme aracısı üzerinde test çalıştırma

Derleme işleminizin bir parçası olarak, uygulama kodunuz üzerinde testler çalıştırmak isteyebilirsiniz. Testler derleme aracısı üzerinde çalıştırıldığından, bağımlılıklarınızı derleme aracısının sanal ortamına yüklemeniz gerekir. Testler çalıştırıldıktan sonra, dağıtım için .zip dosyasını oluşturmadan önce sanal ortamı silin. Aşağıdaki betik öğeleri bu işlemi gösterir. Bunları azure-pipelines.yml dosyasında görevin önüne ArchiveFiles@2 yerleştirin. Daha fazla bilgi için bkz . Platformlar arası betikleri çalıştırma.

# The | symbol is a continuation character, indicating a multi-line script.
# A single-line script can immediately follow "- script:".
- script: |
    python -m venv .env
    source .env/bin/activate
    pip install setuptools
    pip install -r requirements.txt

  # The displayName shows in the pipeline UI when a build runs
  displayName: 'Install dependencies on build agent'

- script: |
    # Put commands to run tests here
    displayName: 'Run tests'

- script: |
    echo Deleting .env
    deactivate
    rm -rf .env
  displayName: 'Remove .env before zip'

Test sonuçlarını işlem hattınızda yayımlamak için PublishTestResults@2 gibi bir görev de kullanabilirsiniz. Daha fazla bilgi için bkz . Python uygulamaları oluşturma - Testleri çalıştırma.

Kaynakları temizleme

Bu öğreticide oluşturulan Azure kaynaklarında ücret yansıtılmasını önlemek için:

• Oluşturduğunuz projeyi silin. Proje silindiğinde işlem hattı ve hizmet bağlantısı silinir.

• App Service'i ve App Service Planını içeren Azure kaynak grubunu silin. Azure portalında kaynak grubuna gidin, Kaynak grubunu sil'i seçin ve istemleri izleyin.

• Cloud Shell için dosya sistemini koruyan depolama hesabını silin. Cloud Shell'i kapatın ve cloud-shell-storage- ile başlayan kaynak grubuna gidin, Kaynak grubunu sil'i seçin ve istemleri izleyin.

Sonraki adımlar

• Azure Pipelines'da Python uygulamalarını özelleştirme
• App Service'te Python uygulamasını yapılandırma