Azure Pipelines를 사용하여 Python 웹앱을 빌드 및 배포하여 Azure 앱 Service

• Azure 구독 아직 없는 경우 무료 계정을 만들 수 있습니다.
• GitHub 계정. 계정이 없는 경우 체험 계정을 만듭니다.
• Azure DevOps Services 조직. 체험 계정 만들기

• Azure 구독 아직 없는 경우 무료 계정을 만들 수 있습니다.
• GitHub 계정. 계정이 없는 경우 체험 계정을 만듭니다.
• An Azure DevOps Server.
• 자체 호스팅 에이전트입니다. 자체 호스팅 에이전트를 만들어야 하는 경우 자체 호스팅 에이전트를 참조 하세요.

1. 브라우저에서 dev.azure.com 이동하여 로그인합니다.
2. 조직을 선택합니다.
3. 조직에서 첫 번째 프로젝트를 만드는 경우 새 프로젝트를 선택하거나 프로젝트 만들기를 선택하여 새 프로젝트를 만듭니다.
4. 프로젝트 이름을 입력합니다.
5. 프로젝트의 표시 유형을 선택합니다.
6. 만들기를 실행합니다.

1. 브라우저에서 Azure DevOps Server로 이동합니다.
2. 컬렉션을 선택합니다.
3. 컬렉션에서 첫 번째 프로젝트를 만드는 경우 새 프로젝트를 선택하거나 프로젝트 만들기를 선택하여 새 프로젝트를 만듭니다.
4. 프로젝트 이름을 입력합니다.
5. 프로젝트의 표시 유형을 선택합니다.
6. 만들기를 실행합니다.

서비스 주체 만들기

서비스 주체는 Azure 리소스에 액세스하기 위해 애플리케이션, 호스팅된 서비스 및 자동화된 도구와 함께 사용하도록 만든 ID입니다. 이 액세스는 서비스 주체에 할당된 역할로 제한되므로 액세스할 수 있는 리소스와 어느 수준에서 액세스할 수 있는지 제어할 수 있습니다.

서비스 주체를 만들려면 cloud shell(bash)으로 이동하여 다음 명령을 실행합니다. 서비스 주체의 이름, <your-subscription-id> 구독 ID 및 <your-resource-group> 웹앱의 리소스 그룹으로 바꿉 <service-principal-name> 니다.

az ad sp create-for-rbac --display-name <service-principal-name> --role contributor --scopes /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group>

이 명령은 다음 예제와 유사한 JSON 개체를 반환합니다.

{
  "clientId": "<client GUID>",
  "clientSecret": "<string-value>",
  "subscriptionId": "<subscription GUID>",
  "tenantId": "<tenant GUID>",
  ...
}

, clientSecret, subscriptionId및 tenantId 값을 기록해 둡다clientId. 다음 섹션에서 서비스 연결을 만들려면 이러한 값이 필요합니다.

1. 프로젝트 페이지에서 프로젝트 설정을 선택합니다.

   

2. 메뉴의 파이프라인 섹션에서 서비스 연결을 선택합니다.

3. 서비스 연결 만들기를 선택합니다.

4. Azure Resource Manager를 선택하고 다음을 선택합니다.

   

5. 인증 방법을 선택하고 다음을 선택합니다.

6. 새 Azure 서비스 연결 대화 상자에서 선택한 인증 방법과 관련된 정보를 입력합니다. 인증 방법에 대한 자세한 내용은 Azure Resource Manager 서비스 연결을 사용하여 Azure에 연결을 참조하세요.

   예를 들어 워크로드 ID 페더레이션(자동) 또는 서비스 주체(자동) 인증 방법을 사용하는 경우 필요한 정보를 입력합니다.

   

   필드	설명
   범위 수준	구독을 선택합니다.
   구독	Azure 구독 이름.
   리소스 그룹	웹앱을 포함하는 리소스 그룹의 이름입니다.
   서비스 연결 이름	연결에 대한 설명이 포함된 이름입니다.
   모든 파이프라인에 액세스 권한 부여	모든 파이프라인에 대한 액세스 권한을 부여하려면 이 옵션을 선택합니다.

7. 저장을 선택합니다.

새 연결이 서비스 연결 목록에 표시되고 Azure Pipeline에서 사용할 준비가 된 것입니다.

1. 프로젝트 페이지에서 프로젝트 설정을 선택합니다.

   

2. 메뉴의 파이프라인 섹션에서 서비스 연결을 선택합니다.

3. 서비스 연결 만들기를 선택합니다.

4. Azure Resource Manager를 선택하고 다음을 선택합니다.

   

5. 새 Azure 서비스 연결에서 서비스 주체(수동)를 선택하고 다음을 선택합니다.

6. 다음 대화 상자에서 필요한 정보를 입력합니다.

   

   필드	설명
   환경	Azure Cloud를 선택합니다.
   범위 수준	구독을 선택합니다.
   구독 ID	구독 ID.
   구독 이름	Azure 구독 이름.
   서비스 주체 ID	appId 명령에서 반환된 JSON 개체의 값입니다az ad sp create-for-rbac.
   서비스 주체 키	password 명령에서 반환된 JSON 개체의 값입니다az ad sp create-for-rbac.
   테넌트 ID	tenant 명령에서 반환된 JSON 개체의 값입니다az ad sp create-for-rbac.

7. 확인을 선택하여 연결을 확인합니다.

8. 서비스 연결 이름을 입력합니다.

9. 모든 파이프라인에 대한 액세스 권한 부여가 선택되어 있는지 확인 합니다 .

10. 확인 및 저장을 선택합니다.

새 연결이 서비스 연결 목록에 표시되며 프로젝트에서 Azure Pipelines를 사용할 준비가 된 것입니다.

자체 호스팅 에이전트 구성

자체 호스팅 에이전트를 사용하는 경우 Python을 실행하도록 에이전트를 구성해야 합니다. Python 버전 다운로드는 자체 호스팅 에이전트에서 지원되지 않습니다. Python 버전을 미리 설치해야 합니다. 전체 설치 관리자를 사용하여 Python의 pip 호환 버전을 가져옵니다.

호환되지 않는 문제를 방지하려면 Python 버전을 Azure 앱 Services 웹앱의 런타임 버전과 일치시켜야 합니다. 런타임 버전은 명령의 JSON 출력에 az webapp up 표시됩니다.

작업에서 사용할 수 있도록 원하는 Python 버전을 자체 호스팅 에이전트의 도구 캐시에 추가해야 합니다. 일반적으로 도구 캐시는 에이전트의 _work/_tool 디렉터리 아래에 있습니다. 또는 환경 변수 AGENT_TOOLSDIRECTORY 경로를 재정의할 수 있습니다. 도구 디렉터리 아래에서 Python 버전을 기반으로 다음 디렉터리 구조를 만듭니다.

$AGENT_TOOLSDIRECTORY/
    Python/
        {version number}/
            {platform}/
                {tool files}
            {platform}.complete

버전 번호는 1.2.3 형식을 따라야 합니다. 플랫폼은 x86 또는 x64여야 합니다. 도구 파일은 압축을 푼 Python 버전 파일이어야 합니다. 이 파일은 {platform}.complete 캐시에 도구가 x86.complete x64.complete 제대로 설치되었음을 나타내는 0바이트 파일이어야 합니다.

예를 들어 64비트 Windows 컴퓨터에서 Python 3.11을 사용하는 경우 디렉터리 구조는 다음과 같습니다.

$AGENT_TOOLSDIRECTORY/
    Python/
        3.11.4/
            x64/
                {python files}
            x64.complete

에이전트를 호스팅하는 컴퓨터에서 사용하려는 Python 버전이 이미 있는 경우 파일을 도구 캐시에 복사할 수 있습니다. Python 버전이 없는 경우 Python 웹 사이트에서 다운로드할 수 있습니다.

1. 왼쪽 탐색 메뉴에서 파이프라인을 선택합니다.

   

2. 파이프라인 생성를 선택합니다.

   

3. 코드 위치 대화 상자에서 GitHub를 선택합니다. GitHub에 로그인하라는 메시지가 표시될 수 있습니다.

   

4. 리포지토리 선택 화면에서 포크된 샘플 리포지토리를 선택합니다.

   

5. 확인으로 GitHub 암호를 다시 입력하라는 메시지가 표시될 수 있습니다.

6. Azure Pipelines 확장이 GitHub에 설치되지 않은 경우 GitHub는 Azure Pipelines 확장을 설치하라는 메시지를 표시합니다 .

   

   이 페이지에서 리포지토리 액세스 섹션까지 아래로 스크롤하여 모든 리포지토리에 확장을 설치할지 또는 선택한 리포지토리에만 설치할지 선택한 다음, 승인 및 설치를 선택합니다.

   

7. 파이프라인 구성 대화 상자에서 Azure에서 Python에서 Linux 웹앱으로 선택합니다.

8. Azure 구독을 선택하고 계속을 선택합니다.

9. 사용자 이름과 암호를 사용하여 인증하는 경우 Microsoft 계정에 로그인할 수 있는 브라우저가 열립니다.

10. 드롭다운 목록에서 웹앱 이름을 선택하고 유효성 검사 및 구성을 선택합니다.

Azure Pipelines는 azure-pipelines.yml 파일을 만들고 YAML 파이프라인 편집기에서 표시합니다. 파이프라인 파일은 CI/CD 파이프라인을 일련의 단계, 작업 및 단계로 정의하며, 각 단계에는 다양한 작업 및 스크립트에 대한 세부 정보가 포함됩니다. 파이프라인을 살펴보고 수행하는 작업을 확인합니다. 모든 기본 입력이 코드에 적합한지 확인합니다.

1. 탐색 메뉴에서 파이프라인을 선택합니다.

   

2. 파이프라인 생성를 선택합니다.

   

3. 코드 위치 대화 상자에서 GitHub Enterprise Server를 선택합니다. GitHub에 로그인하라는 메시지가 표시될 수 있습니다.

   

4. 리포지토리 선택 탭에서 포크된 샘플 리포지토리를 선택합니다.

   

5. 확인으로 GitHub 암호를 다시 입력하라는 메시지가 표시될 수 있습니다.

6. Azure Pipelines 확장이 GitHub에 설치되지 않은 경우 GitHub는 Azure Pipelines 확장을 설치하라는 메시지를 표시합니다 .

   

   이 페이지에서 리포지토리 액세스 섹션까지 아래로 스크롤하여 모든 리포지토리에 확장을 설치할지 또는 선택한 리포지토리에만 설치할지 선택한 다음, 승인 및 설치를 선택합니다.

   

7. 파이프라인 구성 대화 상자에서 시작 파이프라인을 선택합니다.

8. azure-pipelines.yml 파일의 내용을 다음 코드로 바꿉니다.

   trigger:
   - main
   
   variables:
     # Azure Resource Manager connection created during pipeline creation
     azureServiceConnectionId: '<your-service-connection-name>'
   
     # Web app name
     webAppName: '<your-web-app-name>'
   
     # Environment name
     environmentName: '<your-web-app-name>'
   
     # Project root folder. 
     projectRoot: $(System.DefaultWorkingDirectory)
   
     # Python version: 
     pythonVersion: '<your-python-version>'
   
   stages:
   - stage: Build
     displayName: Build stage
     jobs:
     - job: BuildJob
       pool:
         name: '<your-pool-name>'
         demands: python
       steps:
       - task: UsePythonVersion@0
         inputs:
           versionSpec: '$(pythonVersion)'
         displayName: 'Use Python $(pythonVersion)'
   
       - script: |
           python -m venv antenv
           source antenv/bin/activate
           python -m pip install --upgrade pip
           pip install -r requirements.txt
         workingDirectory: $(projectRoot)
         displayName: "Install requirements"
   
       - task: ArchiveFiles@2
         displayName: 'Archive files'
         inputs:
           rootFolderOrFile: '$(projectRoot)'
           includeRootFolder: false
           archiveType: zip
           archiveFile: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip
           replaceExistingArchive: true
   
       - task: PublishBuildArtifacts@1
         inputs:
           PathtoPublish: '$(Build.ArtifactStagingDirectory)'
           ArtifactName: 'drop'
           publishLocation: 'Container'
   
   - stage: Deploy
     displayName: 'Deploy Web App'
     dependsOn: Build
     condition: succeeded()
     jobs:
     - deployment: DeploymentJob
       pool:
         name: '<your-pool-name'
       environment: $(environmentName)
       strategy:
         runOnce:
           deploy:
             steps:
   
             - task: UsePythonVersion@0
               inputs:
                 versionSpec: '$(pythonVersion)'
               displayName: 'Use Python version'
   
             - task: AzureWebApp@1
               displayName: 'Deploy Azure Web App : <your-web-app-name>'
               inputs:
                 azureSubscription: $(azureServiceConnectionId)
                 appName: $(webAppName)
                 package: $(Pipeline.Workspace)/drop/$(Build.BuildId).zip
                 startUpCommand: 'startup.txt'
   
   

9. 다음 자리 표시자를 사용자 고유의 값으로 바꿉다.

   자리표시자	설명
   <your-service-connection-name>	만든 서비스 연결의 이름입니다.
   <your-web-app-name>	Azure 앱 Service 웹앱의 이름입니다.
   <your-pool-name>	사용하려는 에이전트 풀의 이름입니다.
   <your-python-version>	에이전트에서 실행되는 Python 버전입니다. 이 버전을 웹앱에서 실행되는 Python 버전과 일치시킬 것을 권장합니다. 웹앱 버전은 명령의 JSON 출력에 az webapp up 표시됩니다.

전체 예제 파이프라인 YAML 파일은 다음과 같습니다.

trigger:
- main

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

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

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

  # Environment name
  environmentName: '<your-webapp-name>'

  # Project root folder. Point to the folder containing manage.py file.
  projectRoot: $(System.DefaultWorkingDirectory)

  pythonVersion: '3.11'

stages:
- stage: Build
  displayName: Build stage
  jobs:
  - job: BuildJob
    pool:
      vmImage: $(vmImageName)
    steps:
    - task: UsePythonVersion@0
      inputs:
        versionSpec: '$(pythonVersion)'
      displayName: 'Use Python $(pythonVersion)'

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

    - 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

- stage: Deploy
  displayName: 'Deploy Web App'
  dependsOn: Build
  condition: succeeded()
  jobs:
  - deployment: DeploymentJob
    pool:
      vmImage: $(vmImageName)
    environment: $(environmentName)
    strategy:
      runOnce:
        deploy:
          steps:

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

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

섹션에는 variables 다음 변수가 포함되어 있습니다.

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

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

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

# Environment name
environmentName: '<your-webapp-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'

섹션에는 variables 다음 변수가 포함되어 있습니다.

variables:
# Azure Resource Manager connection created during pipeline creation
azureServiceConnectionId: '<your-service-connection-name>'

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

# Environment name
environmentName: '<your-webapp-name>'

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

# Python version: 3.11. Change this to the version that is running on your agent and web app.
pythonVersion: '3.11'

빌드 단계에는 vmImageName 변수에 정의된 운영 체제에서 실행되는 단일 작업이 포함됩니다.

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

빌드 단계에는 이름 매개 변수로 식별되는 풀의 에이전트에서 실행되는 단일 작업이 포함됩니다. 키워드를 사용하여 에이전트 기능을 demands 지정할 수 있습니다. 예를 들어 demands: python 에이전트에 Python이 설치되어 있어야 한다고 지정합니다. 이름으로 자체 호스팅 에이전트를 지정하려면 키워드를 demands: Agent.Name -equals <agent-name> 사용할 수 있습니다.

  - job: BuildJob
    pool:
      name: <your-pool-name>
      demands: python

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

  - deployment: DeploymentJob
    pool:
      name: <your-pool-name>
    environment: $(environmentName)

steps 파이프라인의 내용은 다음과 같습니다.

1. UsePythonVersion 작업을 사용하여 에이전트에서 사용할 Python 버전을 지정합니다. 버전은 변수에 pythonVersion 정의됩니다.

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

2. AzureWebApp@1 사용하여 웹앱을 배포합니다. 이 작업은 파이프라인 아티팩 drop 트 웹앱에 배포합니다.

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

   매개 변수	설명
   azureSubscription	사용할 Azure Resource Manager 서비스 연결 ID 또는 이름입니다.
   appName	웹앱의 이름입니다.
   package	배포할 .zip 파일의 위치입니다.

   또한 python-vscode-flask-tutorial 리포지토리는 startup.txt 파일에 동일한 시작 명령을 포함하므로 매개 변수startUpCommand: 'startup.txt'를 추가하여 해당 파일을 지정할 수 있습니다.

steps 파이프라인의 내용은 다음과 같습니다.

1. UsePythonVersion 작업을 사용하여 에이전트에서 사용할 Python 버전을 지정합니다. 버전은 변수에 pythonVersion 정의됩니다.

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

2. AzureWebApp@1 사용하여 웹앱을 배포합니다. 이 작업은 파이프라인 아티팩 drop 트 웹앱에 배포합니다.

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

   매개 변수	설명
   azureSubscription	사용할 Azure Resource Manager 서비스 연결 ID 또는 이름입니다.
   appName	웹앱의 이름입니다.
   package	배포할 .zip 파일의 위치입니다.

   또한 python-vscode-flask-tutorial 리포지토리는 startup.txt 파일에 동일한 시작 명령을 포함하므로 매개 변수startUpCommand: 'startup.txt'를 추가하여 해당 파일을 지정할 수 있습니다.

     - task: AzureWebApp@1
        displayName: 'Deploy Azure Web App : $(webAppName)'
        inputs:
          azureSubscription: $(azureServiceConnectionId)
          appName: $(webAppName)
          package: $(Pipeline.Workspace)/drop/$(Build.BuildId).zip
          startUpCommand: 'startup.txt'
   

   매개 변수	설명
   azureSubscription	사용할 Azure Resource Manager 서비스 연결 ID 또는 이름입니다.
   appName	웹앱의 이름입니다.
   package	배포할 .zip 파일의 위치입니다.
   startUpCommand	앱이 배포된 후 실행할 명령입니다. 샘플 앱은 .를 사용합니다 startup.txt.