Azure Pipelines를 사용하여 Azure App Service에 배포

코드 리포지토리에서 azure-pipelines.yml YAML 파일을 만들어 파이프라인을 정의합니다.

1. Azure DevOps 프로젝트의 왼쪽 탐색 메뉴에서 파이프라인을 선택합니다.
2. 파이프라인 페이지에서 새 파이프라인을 선택하거나 이 파이프라인이 프로젝트의 첫 번째 파이프라인인 경우 파이프라인을 만듭니다.
3. 코드 위치 화면에서 소스 코드의 위치(Azure Repos Git 또는 GitHub)를 선택합니다. 필요한 경우 GitHub에 로그인합니다.
4. 리포지토리 선택 화면에서 코드 리포지토리를 선택합니다.
5. 파이프라인 구성 화면에서 시작 파이프라인을 선택합니다.

파이프라인에 .NET Core(DotNetCoreCLI@2) 작업을 추가하고 앱을 빌드하고 게시합니다.

1. 파이프라인 YAML 검토 화면에서 줄 뒤의 모든 코드를 삭제합니다steps:.
2. 파일의 끝을 선택한 다음 오른쪽에 도우미 표시 를 선택합니다.
3. 작업에서 .NET Core를 선택합니다.
4. .NET Core 구성 화면의 Azure Resource Manager 연결에서 Azure 구독을 선택한 다음 권한 부여를 선택하여 필요한 서비스 연결을 만듭니다.
5. 명령에서 게시를 선택합니다.
6. 웹 프로젝트 게시 및 게시된 프로젝트 Zip 확인란이 선택되어 있는지 확인한 다음 추가를 선택합니다.
7. 작업이 YAML 파이프라인에 나타납니다. YAML 코드를 검토하여 수행하는 작업을 확인합니다. 준비가 되면 저장 및 실행을 선택한 다음 저장을 선택하고 다시 실행합니다.
8. 빌드 요약 화면의 작업에서 필요한 사용 권한 링크를 선택합니다. 검사 화면에서 [허용]을 선택한 다음 [허용]을 다시 선택합니다. 여기에 권한을 부여하면 이 파이프라인의 모든 실행에 대해 권한을 부여한 서비스 연결을 사용할 수 있습니다.

1. Azure DevOps 프로젝트의 왼쪽 탐색 메뉴에서 파이프라인을 선택합니다.
2. 파이프라인 페이지에서 새 파이프라인을 선택하거나 이 파이프라인이 프로젝트의 첫 번째 파이프라인인 경우 파이프라인을 만듭니다.
3. 코드 위치 화면에서 클래식 편집기 사용을 선택하여 YAML 없이 파이프라인을 만듭니다.
4. 리포지토리 선택 화면에서 소스 코드의 위치(Azure Repos Git 또는 GitHub)를 선택한 다음, 코드 리포지토리 및 기본 분기를 선택합니다. 를 선택합니다 계속.
5. 템플릿 선택 화면에서 ASP.NET Core를 선택한 다음 적용을 선택합니다.
6. 새 파이프라인 화면의 오른쪽 에이전트 사양 아래에서 앱 플랫폼 및 버전에 따라 ubuntu-latest 또는 windows-latest 와 같은 에이전트 사양을 선택합니다.
7. 파이프라인에서 수행하는 작업을 확인합니다. 준비가 되면 저장 및 큐를 선택합니다.
8. 큐 저장을 다시 선택하고 파이프라인 실행 화면에서 저장 및 실행을 선택합니다.

1. 파이프라인 실행 요약 화면에서 오른쪽 위에 있는 기타 작업 아이콘을 선택한 다음 파이프라인 편집을 선택합니다.
2. YAML 파일의 끝을 선택하고 작업 목록이 표시되지 않으면 도우미 표시를 선택합니다.
3. 작업 목록에서 Azure Web App 작업을 검색하여 선택합니다. 또는 Azure App Service 배포 작업을 사용할 수 있습니다.
4. Azure Web App 구성 화면의 Azure 구독에서 이전 단계에 대해 설정한 것과 동일한 서비스 연결을 선택합니다. 이 연결을 다시 인증할 필요가 없습니다.
5. 앱 유형의 경우 코드에 따라 Linux의 Azure Web App 또는 Windows의 Azure Web App을 선택합니다.
6. 앱 이름에 대해 App Service 앱 이름을 선택하거나 입력합니다.
7. 추가를 선택합니다.
8. 유효성 검사 및 저장을 선택한 다음 저장을 선택합니다.
9. 실행을선택한 다음 실행을 다시 선택합니다.

전체 YAML 파이프라인은 다음 코드와 같습니다.

trigger:
- <branch-specification>

pool:
  vmImage: <agent-specification>

steps:
- task: DotNetCoreCLI@2
  inputs:
    azureSubscription: '<your-authorized-service-connection>'
    command: 'publish'
    publishWebProjects: true

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<your-authorized-service-connection>'
    appType: 'webApp'
    appName: '<your-app-name>'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'
    deploymentMethod: 'auto'  

• azureSubscription: Azure 구독에 대한 권한 있는 서비스 연결의 이름입니다.
• appName: 기존 앱의 이름입니다.
• package: App Service 콘텐츠를 포함하는 패키지 또는 폴더의 파일 경로입니다. 와일드카드가 지원됩니다.

클래식 파이프라인의 경우 별도의 파이프라인에서 빌드 및 릴리스 단계를 정의하는 것이 가장 쉽습니다.

1. 프로젝트의 왼쪽 탐색 메뉴에서 파이프라인>릴리스를 선택한 다음 새 파이프라인 을 선택하여 릴리스 파이프라인을 만듭니다.

2. 템플릿 선택에서 Azure App Service 배포 템플릿을 선택하고 적용을 선택합니다. 이 템플릿은 필요한 작업을 자동으로 추가합니다.

   참고 항목

   Windows의 App Service에 Node.js 앱을 배포하는 경우 Azure App Service 템플릿에 Node.js 앱 배포를 선택합니다. 이 템플릿은 서비스를 시작하는 매개 변수를 포함하는 web.config 파일을 생성하도록 태스크를 iisnode 구성합니다.

3. 새 릴리스 파이프라인 페이지에서 작업 탭을 선택하고, 1단계를 선택하고, 매개 변수 아래에서 다음 필드를 완료합니다.

   • Azure 구독: Azure 서비스 연결이 아직 없는 경우 Azure 구독을 선택한 다음 권한 부여 를 선택하여 필요한 서비스 연결을 만듭니다.
   • 앱 유형: 코드 및 에이전트 사양과 일치하도록 Linux 의 Azure Web App 또는 Windows의 Azure Web App을 선택합니다.
   • 앱 서비스 이름: App Service 앱을 선택합니다.

4. 새 릴리스 파이프라인 화면의 파이프라인 탭에서 아티팩트 옆에 있는추가를 선택합니다.

5. 아티팩트 추가 화면에서 빌드가 선택되어 있는지 확인하고 원본(빌드 파이프라인)에서 이전 섹션에서 만든 파이프라인을 선택합니다.

6. 추가를 선택합니다.

7. 파이프라인 페이지에서 오른쪽 위에서 저장을 선택한 다음 확인을 선택합니다.

8. 파이프라인을 실행하려면 파이프라인 페이지에서 릴리스 만들기를 선택한 다음 만들기를 선택합니다.

Azure Web App 작업은 Azure 웹앱의 루트 애플리케이션에 배포됩니다. VirtualApplication 배포 작업의 속성을 사용하여 특정 가상 애플리케이션에 배포할 수 있습니다.

- task: AzureRmWebAppDeployment@5
  inputs:
    VirtualApplication: '<name of virtual application>'

VirtualApplication 는 Azure Portal에서 구성된 가상 애플리케이션의 이름입니다. 자세한 내용은 Azure Portal에서 App Service 앱 구성을 참조하세요.

Azure Web App 작업은 Azure 웹앱의 루트 애플리케이션에 배포됩니다. 특정 가상 애플리케이션에 배포하려면 Azure App Service 배포 작업의 Virtual Application 속성에 해당 이름을 입력합니다.

다음 예제에서는 스테이징 슬롯에 배포한 다음, 프로덕션 슬롯으로 교환하는 방법을 보여 줍니다.

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<service-connection-name>'
    appType: webAppLinux
    appName: '<app-name>'
    deployToSlotOrASE: true
    resourceGroupName: '<name of resource group>'
    slotName: staging
    package: '$(Build.ArtifactStagingDirectory)/**/*.zip'

- task: AzureAppServiceManage@0
  inputs:
    azureSubscription: '<service-connection-name>'
    WebAppName: '<app-name>'
    ResourceGroupName: '<name of resource group>'
    SourceSlot: staging
    SwapWithProduction: true

• azureSubscription: Azure 서비스 연결입니다.
• appType: Linux에서 웹앱에 배포하는 것과 같은 webAppLinux 선택적 앱 유형입니다.
• appName: 기존 앱의 이름입니다.
• deployToSlotOrASE: 불리언. 기존 배포 슬롯 또는 App Service 환경에 배포할지 여부입니다.
• resourceGroupName: 배포할 리소스 그룹의 이름이며, true인 경우 deployToSlotOrASE 필요합니다.
• slotName: 배포할 슬롯의 이름이며, true인 경우 deployToSlotOrASE 필요합니다. 기본값은 production입니다.
• package: 앱 콘텐츠가 포함된 패키지 또는 폴더의 파일 경로입니다. 와일드카드가 지원됩니다.
• SourceSlot: true인 경우 SwapWithProduction 프로덕션으로 전송되는 슬롯입니다.
• SwapWithProduction: 불리언. 원본 슬롯의 트래픽을 프로덕션으로 교환할지 여부입니다.

Azure Web App 작업에서 슬롯 또는 App Service Environment에 배포 옵션을 사용하여 배포할 슬롯을 지정합니다. 슬롯을 교환하려면 Azure App Service 관리 작업을 사용합니다.

YAML 파일의 jobs를 사용하여 배포 파이프라인을 설정할 수 있습니다. 작업을 사용하면 여러 웹앱에 대한 배포 순서를 제어할 수 있습니다.

jobs:
- job: buildandtest
  pool:
    vmImage: ubuntu-latest
 
  steps:
  # publish an artifact called drop
  - task: PublishPipelineArtifact@1
    inputs:
      targetPath: '$(Build.ArtifactStagingDirectory)' 
      artifactName: drop
  
  # deploy to Azure Web App staging
  - task: AzureWebApp@1
    inputs:
      azureSubscription: '<service-connection-name>'
      appType: <app type>
      appName: '<staging-app-name>'
      deployToSlotOrASE: true
      resourceGroupName: <group-name>
      slotName: 'staging'
      package: '$(Build.ArtifactStagingDirectory)/**/*.zip'

- job: deploy
  dependsOn: buildandtest
  condition: succeeded()

  pool: 
    vmImage: ubuntu-latest
  
  steps:
    # download the artifact drop from the previous job
  - task: DownloadPipelineArtifact@2
    inputs:
      source: 'current'
      artifact: 'drop'
      path: '$(Pipeline.Workspace)'

  - task: AzureWebApp@1
    inputs:
      azureSubscription: '<service-connection-name>'
      appType: <app type>
      appName: '<production-app-name>'
      resourceGroupName: <group-name>
      package: '$(Pipeline.Workspace)/**/*.zip'

여러 웹앱에 배포하려면 릴리스 파이프라인에 단계를 추가합니다. 배포 순서를 제어할 수 있습니다. 자세한 내용은 스테이지를 참조 하세요.

YAML에서 조건부로 배포하려면 다음 기술 중 하나를 사용합니다.

• 조건을 단계에 추가합니다.
• 배포 단계를 별도의 작업으로 격리하고, 조건을 해당 작업에 추가합니다.

다음 예제에서는 단계 조건을 사용하여 주 분기에서 시작된 성공적인 빌드만 배포하는 방법을 보여 줍니다.

- task: AzureWebApp@1
  condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
  inputs:
    azureSubscription: '<service-connection-name>'
    appName: '<app-name>'

조건에 대한 자세한 내용은 조건 지정을 참조하세요.

릴리스 파이프라인에서 배포를 제어하기 위한 다양한 검사 및 조건을 구현할 수 있습니다.

• 분기 필터를 설정하여 릴리스 파이프라인의 아티팩트에서 연속 배포 트리거를 구성합니다.
• 배포 전 승인을 설정하거나 스테이지에 배포하기 위한 전제 조건으로 게이트를 구성합니다.
• 실행할 작업에 대한 조건을 지정합니다.

자세한 내용은 다음 문서를 참조하세요.

• 클래식 릴리스 트리거
• 승인을 사용한 배포 제어
• 배포 게이트 개념

trigger:
- main

pool:
  vmImage: windows-latest

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
    arguments: '--configuration $(buildConfiguration)'
    zipAfterPublish: true

- task: AzureRmWebAppDeployment@5
  inputs:
    ConnectionType: 'AzureRM'
    azureSubscription: '<service-connection-name>'
    appType: 'webApp'
    WebAppName: '<app-name>'
    packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'
    enableCustomDeployment: true
    DeploymentType: 'webDeploy'

릴리스 파이프라인에서 Azure App Service 배포 템플릿을 사용하는 경우 다음 단계에 따라 웹 배포에 배포합니다.

1. 작업 탭을 선택한 다음, Azure App Service 배포 태스크인 Azure App Service 배포를 선택합니다.
2. 구성 화면에서 연결 유형 이 Azure Resource Manager로 설정되어 있는지 확인합니다.
3. 추가 배포 옵션을 확장하고 배포 방법 선택을 선택합니다. 웹 배포가 배포 방법으로 선택되어 있는지 확인합니다.
4. 릴리스 파이프라인을 저장합니다.