快速入门：将 Bicep 与 Azure Pipelines 集成

本快速入门介绍如何将 Bicep 文件与 Azure Pipelines 集成，以便持续集成和持续部署。

它简要介绍了部署 Bicep 文件所需执行的管道任务。 有关设置管道和项目的更详细步骤，请参阅 使用 Bicep 和 Azure Pipelines Microsoft Learn 模块部署 Azure 资源 。

先决条件

如果没有 Azure 订阅，请在开始之前创建一个免费帐户。

还需要一个 Azure DevOps 组织。 如果没有，请免费创建一个。 如果您的团队已有 Azure DevOps 组织，请确保您是您要使用的 Azure DevOps 项目的管理员。

需要为你的 Azure 订阅配置一个服务连接。 管道中的任务将以服务主体的身份执行。 有关创建连接的步骤，请参阅 “创建 DevOps 项目”。

需要一个 Bicep 文件 ，用于定义项目的基础结构。 此文件位于存储库中。

需要一个 “.bicepparam” 文件 ，该文件定义 Bicep 文件使用的参数。 此文件位于存储库中。

创建管道

1. 在 Azure DevOps 组织中，选择 “管道 ”和 “创建管道”。

   

2. 指定代码的存储位置。 本快速入门使用 Azure Repos Git 存储库。

   

3. 选择包含项目代码的存储库。

   

4. 选择 Starter 管道 作为要创建的管道类型。

   

部署 Bicep 文件

可以使用 Azure 资源组部署任务或 Azure CLI 任务来部署 Bicep 文件。

使用 Azure 资源管理器模板部署任务

1. 将您的初始管道替换为以下 YAML。 它使用 Azure 资源管理器模板部署任务创建资源组并部署 Bicep 和 .bicepparam 文件。

   trigger:
   - main
   
   name: Deploy Bicep files
   
   parameters:
   - name: azureServiceConnection
     type: string
     default: '<your-connection-name>'
   
   variables:
     vmImageName: 'ubuntu-latest'
     resourceGroupName: 'exampleRG'
     location: '<your-resource-group-location>'
     templateFile: './main.bicep'
     csmParametersFile: './main.bicepparam'
   
   pool:
     vmImage: $(vmImageName)
   
   steps:
   - task: AzureResourceManagerTemplateDeployment@3
     inputs:
       deploymentScope: 'Resource Group'
       action: 'Create Or Update Resource Group'
       resourceGroupName: '$(resourceGroupName)'
       location: '$(location)'
       templateLocation: 'Linked artifact'
       csmFile: '$(templateFile)'
       csmParametersFile: '$(csmParametersFile)'
       overrideParameters: '-storageAccountType Standard_LRS'
       deploymentMode: 'Incremental'
       deploymentName: 'DeployPipelineTemplate'
       connectedServiceName: '${{ parameters.azureServiceConnection }}'
   

2. 更新 azureServiceConnection 和 location 的值。

3. 验证存储库中是否具有有效的 main.bicep 文件。

4. 验证你的存储库中是否有一个包含main.bicepparam语句的有效using文件。

5. 选择“保存”。 生成管道会自动运行。 返回构建管道的摘要，并查看状态。

使用 Azure CLI 任务

1. 将您的初始管道替换为以下 YAML。 它使用 .bicepparam创建资源组并部署文件：

   trigger:
   - main
   
   name: Deploy Bicep files
   
   parameters:
     azureServiceConnection: '<your-connection-name>'
   
   variables:
     vmImageName: 'ubuntu-latest'
     resourceGroupName: 'exampleRG'
     location: '<your-resource-group-location>'
     bicepParamFile: './main.bicepparam'
   
   pool:
     vmImage: $(vmImageName)
   
   steps:
   - task: AzureCLI@2
     inputs:
       azureSubscription: '${{ parameters.azureServiceConnection }}'
       scriptType: bash
       scriptLocation: inlineScript
       useGlobalConfig: false
       inlineScript: |
         az --version
         az group create --name $(resourceGroupName) --location $(location)
         az deployment group create `
           --resource-group $(resourceGroupName) `
           --parameters $(bicepParamFile) `
           --name DeployPipelineTemplate
   

   有关任务输入的说明，请参阅 Azure CLI v2 任务。 在气隙云上使用此任务时，必须将任务的 useGlobalConfig 属性设置为 true。 默认值为 false。

2. 更新 azureServiceConnection 和 location 的值。

3. 验证你的存储库中是否有一个包含main.bicepparam语句的有效using文件。

4. 选择“保存”。 生成管道会自动运行。 返回构建管道的摘要，并查看状态。

清理资源

不再需要 Azure 资源时，请使用 Azure CLI 或 Azure PowerShell 删除快速入门资源组。

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

后续步骤