使用 Azure Pipelines 部署至 App Service

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019

使用 Azure Pipelines，在每次成功建置時自動將 Web 應用程式部署至 Azure App Service。 Azure Pipelines 可讓您使用 Azure DevOps 建置、測試及部署持續整合 (CI) 與持續傳遞 (CD)。

YAML 管線是使用存放庫中的 YAML 檔案來定義。 步驟是管線最小的組建區塊，可以是指令碼或工作 (預先封裝的指令碼)。 了解構成管線的重要概念和元件。

您將使用 Azure Web 應用程式工作 (AzureWebApp)，來部署至管線中的 Azure App Service。 若是更複雜的情節，例如需要在部署中使用 XML 參數，您可以使用 Azure App Service 部署工作 (AzureRmWebAppDeployment)。

必要條件

• 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
• Azure DevOps 組織。 免費建立一個。
• 能夠在 Microsoft 裝載的代理程式上執行管線。 您可以購買平行作業，也可以要求免費層。
• 運作中 Azure App Service 應用程式搭配裝載在 GitHub 或 Azure Repos 上的程式碼。
  • .NET：在 Azure 中建立 ASP.NET Core Web 應用程式
  • ASP.NET：在 Azure 中建立 ASP.NET Framework Web 應用程式
  • JavaScript：在 Azure App Service 中建立 Node.js Web 應用程式
  • JAVA：在 Azure App Service 上建立 JAVA 應用程式
  • Python：在 Azure App Service 中建立 Python 應用程式

1.建立堆疊的管線

本節中的程式碼範例假設您要部署 ASP.NET Web 應用程式。 您可以調整指示以進行其他架構。

深入了解 Azure Pipelines 生態系統支援。

YAML

1. 登入您的 Azure DevOps 組織，然後瀏覽至您的專案。

2. 前往 [管線]，然後選取 [新增管線]。

3. 出現提示時，請選擇原始程式碼的位置：Azure Repos Git 或 GitHub。

   系統可能會將您重新導向至 GitHub 以進行登入。 若是如此，請輸入 GitHub 認證。

4. 在存放庫清單出現時，選取您的存放庫。

5. 系統可能會將您重新導向至 GitHub，以安裝 Azure Pipelines 應用程式。 如果發生此情況，請選取 [核准和安裝]。

6. 在 [設定] 索引標籤出現時，選取 [ASP.NET Core]。

7. 在新的管線出現時，請查看 YAML 以了解其用途。 當您準備好時，請選取 [儲存並執行]。

傳統

開始進行之前：

1. 建立管線，然後選取 ASP.NET Core 範本。 此選取項目會自動新增在範例存放庫中建置程式碼所需的工作。

2. 儲存管線並將組建排入佇列，以查看其實際操作。

   ASP.NET Core 管線範本稍後會將部署 ZIP 檔案發佈為部署工作的 Azure 成品。

2.新增部署工作

YAML

1. 按一下 YAML 檔案的結尾，然後選取 [顯示助理]。'

2. 使用工作助理來新增 Azure Web 應用程式工作。

   

   或者，您可以新增 Azure App Service 部署 (AzureRmWebAppDeployment) 工作。

3. 選擇 Azure 訂用帳戶。 請務必 [授權] 您的連線。 授權會建立必要的服務連線。

4. 根據 App Service 應用程式選取 [應用程式類型]、[應用程式名稱]，以及 [執行階段堆疊]。 完成的 YAML 應類似下列程式碼。

   variables:
     buildConfiguration: 'Release'
   
   steps:
   - script: dotnet build --configuration $(buildConfiguration)
     displayName: 'dotnet build $(buildConfiguration)'
   - task: DotNetCoreCLI@2
     inputs:
       command: 'publish'
       publishWebProjects: true
   - task: AzureWebApp@1
     inputs:
       azureSubscription: '<service-connection-name>'
       appType: 'webAppLinux'
       appName: '<app-name>'
       package: '$(System.DefaultWorkingDirectory)/**/*.zip'
   

   • azureSubscription：Azure 訂用帳戶的授權服務連線名稱。
   • appName：現有應用程式的名稱。
   • 套件：套件的檔案路徑或包含應用程式服務內容的資料夾。 支援萬用字元。

傳統

開始進行之前：

1. 從左側功能表中選取 [發行]，然後選取 [新增管線]，以建立 [發行管線]。

2. 選取適合您階段的 [Azure App Service 部署] 範本。 這會自動新增必要的工作。

   注意

   如果您要在 Windows 將 Node.js 應用程式部署至 App Service，請選取 [將 Node.js 應用程式部署至 Azure App Service] 範本。 這些範本的唯一差異，在於 Node.js 範本會設定工作來產生 web.config 檔案，當中包含啟動 iisnode 服務的參數。

3. 若要從上一個步驟將此發行管線連結至 Azure 成品，請選取 [新增成品]> [組建]。

4. 在 [來源 (組建管線)] 中，選取您在上一節中建立的組建管線，然後選取 [新增]。

5. 儲存發行管線並建立發行，以查看其實際操作。

範例：部署 .NET 應用程式

YAML

若要將 .zip 網頁套件 (例如，從 ASP.NET Web 應用程式) 部署至 Azure Web 應用程式，請使用下列程式碼片段，將該組建部署至應用程式。

variables:
  buildConfiguration: 'Release'

steps:
- script: dotnet build --configuration $(buildConfiguration)
  displayName: 'dotnet build $(buildConfiguration)'
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
- task: AzureWebApp@1
  inputs:
    azureSubscription: '<service-connection-name>'
    appType: 'webAppLinux'
    appName: '<app-name>'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'

• azureSubscription：您的 Azure 訂閱。
• appType：您的 Web 應用程式類型。
• appName：現有的應用程式服務的名稱。
• package：封裝的檔案路徑，或包含您應用程式服務內容的資料夾。 支援萬用字元。

傳統

對於傳統管線，在個別頁面 ([管線] 和 [發行]) 中定義組建和發行階段是最簡單的方式。 一般而言，您會：

• 在 [管線] 頁面中，使用您選擇的範本 (例如 ASP.NET Core、Node.js 搭配 Grunt、Maven 等) 來建置及測試應用程式，以及發佈成品。
• 在 [發行] 頁面中，使用一般 Azure App Service 部署範本來部署成品。

可能有特定程式設計語言的範本可供選擇。

範例：部署至虛擬應用程式

YAML

根據預設，會在 Azure Web 應用程式中的根應用程式進行您的部署。 您可以使用 Azure App Service 部署 (AzureRmWebAppDeployment) 工作的 VirtualApplication 屬性，來部署至特定的虛擬應用程式：

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

• VirtualApplication：已在 Azure 入口網站中設定的虛擬應用程式名稱。 如需詳細資料，請參閱在 Azure 入口網站中設定 App Service 應用程式。

傳統

根據預設，會在 Azure Web 應用程式中的根應用程式進行您的部署。 如果您想要部署至特定虛擬應用程式，請在 Azure App Service 部署工作的 [虛擬應用程式] 屬性中輸入其名稱。

範例：部署到插槽

YAML

下列範例示範如何部署至預備位置，然後交換成生產位置：

- 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>'
    appType: webAppLinux
    WebAppName: '<app-name>'
    ResourceGroupName: '<name of resource group>'
    SourceSlot: staging
    SwapWithProduction: true

• azureSubscription：您的 Azure 訂閱。
• appType：(選擇性) 使用 webAppLinux 部署至 Linux 上的 Web 應用程式。
• appName：現有的應用程式服務的名稱。
• deployToSlotOrASE：布林值。 部署至現有的部署位置或 Azure App Service 環境。
• resourceGroupName：資源群組的名稱。 如果 deployToSlotOrASE 為 true，則為必要項。
• slotName：插槽名稱，預設為 production。 如果 deployToSlotOrASE 為 true，則為必要項。
• package：封裝的檔案路徑，或包含您應用程式服務內容的資料夾。 支援萬用字元。
• SourceSlot：當 SwapWithProduction 為 true 時，傳送至生產環境的位置。
• SwapWithProduction：布林值。 將來源位置的流量與生產環境交換。

傳統

在 Azure Web 應用程式工作中使用選項 [部署到位置或 App Service 環境]，以指定部署的目的地位置。 若要交換插槽，請使用 Azure App Service 管理工作。

範例：部署至多個 Web 應用程式

YAML

您可以使用 YAML 檔案中的作業來設定部署管線。 您可以使用作業來控制部署至多個 Web 應用程式的順序。

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'

傳統

如果您想要部署至多個 Web 應用程式，請將階段新增至發行管線。 您可以控制部署的順序。 若要深入了解，請參閱階段。

範例：進行變數替代

對於大部分的語言堆疊，應用程式設定和連接字串可以在執行階段設定為環境變數。

但您想要對 Web.config 進行變數替代的原因不僅於此。在此範例中，Web.config 檔案包含名為 connectionString 的連接字串。 部署至每個 Web 應用程式之前，您都可以變更其值。 您可以套用 Web.config 轉換或在 Web.config 檔案中替代變數來執行此動作。

YAML

下列程式碼片段示範使用 Azure App Service 部署 (AzureRmWebAppDeployment) 工作來替代變數的範例：

jobs:
- job: test
  variables:
    connectionString: <test-stage connection string>
  steps:
  - task: AzureRmWebAppDeployment@4
    inputs:
      azureSubscription: '<Test stage Azure service connection>'
      WebAppName: '<name of test stage web app>'
      enableXmlVariableSubstitution: true

- job: prod
  dependsOn: test
  variables:
    connectionString: <prod-stage connection string>
  steps:
  - task: AzureRmWebAppDeployment@4
    inputs:
      azureSubscription: '<Prod stage Azure service connection>'
      WebAppName: '<name of prod stage web app>'
      enableXmlVariableSubstitution: true

傳統

若要使用變數替代來變更 connectionString：

1. 建立具有兩個階段的發行管線。
2. 將發行的成品連結至產生網頁套件的組建。
3. 在每個階段中將 connectionString 定義為變數。 設定適當的值。
4. 針對 Azure App Service 部署 工作，選取 [檔案轉換和變數替代選項] 底下的 [XML 變數替代] 選項。

範例：有條件地部署

YAML

若要在 YAML 中執行此動作，您可以使用下列其中一種方法：

• 將部署步驟隔離至個別的作業，並將條件新增至該作業。
• 將條件新增至步驟。

下列範例示範如何使用步驟條件，只部署源自主分支的組建：

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

如需深入了解其他條件，請參閱指定條件。

傳統

在您的發行管線中，您可以實作各種檢查和條件來控制部署：

• 設定分支篩選，以在發行管線的成品上設定持續部署觸發程序。
• 將預先部署核准設為部署至階段的先決條件。
• 將閘道設定為部署至階段的先決條件。
• 指定所要執行工作的條件。

若要深入了解，請參閱發行、分支和階段觸發程序、使用核准發行部署控制、使用閘道發行部署控制，以及指定執行工作的條件。

範例：使用 Web Deploy 部署

Azure App Service 部署 (AzureRmWebAppDeployment) 工作可以使用 Web Deploy 部署至 App Service。

YAML

trigger:
- main

pool:
  vmImage: windows-latest

variables:
  buildConfiguration: 'Release'

steps:
- script: dotnet build --configuration $(buildConfiguration)
  displayName: 'dotnet build $(buildConfiguration)'
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
    arguments: '--configuration $(buildConfiguration)'
    zipAfterPublish: true
- task: AzureRmWebAppDeployment@4
  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]。 這是 AzureRmWebAppDeployment 工作。

2. 在對話方塊中，確保將 [連線類型] 設定為 [Azure Resource Manager]。

3. 在對話方塊中，展開 [其他部署選項]，然後選取 [選取部署方法]。 請確定已選取 [Web Deploy] 作為部署方法。

4. 儲存發行管線。

注意

使用 AzureRmWebAppDeployment@3 和 AzureRmWebAppDeployment@4 工作時，您應該使用 Azure Resource Manager 連線類型，或在使用 Web Deploy 進行部署時使用 AzureRM。 當啟用應用程式的基本驗證時，其會使用發行設定檔進行部署，但在基本驗證停用時，其會使用更安全的 Entra ID 驗證。

常見問題集

AzureWebApp 與 AzureRmWebAppDeployment 工作的差異為何？

Azure Web 應用程式工作 (AzureWebApp) 是部署至 Azure Web 應用程式最簡單的方式。 根據預設，會在 Azure Web 應用程式中的根應用程式進行您的部署。

Azure App Service Deploy 工作 (AzureRmWebAppDeployment) 可以處理更多自訂情節，例如：

• 修改 Web 套件和 XML 參數檔案內的組態設定。
• 使用 Web Deploy 進行部署 (如果您使用 IIS 部署程序)。
• 部署至虛擬應用程式。
• 部署到其他應用程式類型，例如容器應用程式、函數應用程式、WebJobs 或 API 和行動裝置應用程式。

注意

個別的檔案轉換工作也支援檔案轉換和變數替代，以在 Azure Pipelines 中使用。 您可以使用檔案轉換工作，在任何組態和參數檔案上套用檔案轉換和變數替代。

我收到以下訊息「提供的 App Service 套件或資料夾路徑無效」。

視管線而定，在 YAML 管線中組建 Web 套件的儲存位置與部署工作所尋找的位置之間可能不相符。 例如，AzureWebApp 工作會挑選要進行部署的網頁套件。 例如，AzureWebApp 工作會在 $(System.DefaultWorkingDirectory)/**/*.zip 中尋找。 如果網頁套件存放在別處，請修改 package 的值。

我收到以下訊息「僅限使用 Windows 代理程式時，才可使用 webdeploy 選項進行發佈」。

當您將工作設定為使用 Web Deploy 進行部署，但代理程式未執行 Windows 時，AzureRmWebAppDeployment 工作中就會發生此錯誤。 確認 YAML 具有類似下列程式碼的內容：

pool:
  vmImage: windows-latest

當我停用基本驗證時，Web Deploy 無法運作

如需取得 Microsoft Entra ID 驗證以使用 AzureRmWebAppDeployment 工作的疑難排解資訊，請參閱我無法使用 Windows 代理程式中的 Microsoft Entra ID 驗證，透過 Web Deploy 部署至 Azure App Service

下一步

• 自訂您的 Azure DevOps 管線。