Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este inicio rápido se muestra cómo integrar archivos de Bicep con Azure Pipelines para la integración continua y la implementación continua.
Se brinda una breve introducción a la tarea de canalización que necesita para implementar un archivo Bicep. Para obtener pasos más detallados sobre cómo configurar la canalización y el proyecto, consulte el módulo Implementación de recursos de Azure mediante Bicep y Azure Pipelines Microsoft Learn.
Prerrequisitos
Si no tiene una suscripción de Azure, cree una cuenta gratuita antes de comenzar.
También necesita una organización de Azure DevOps. Si no tiene ninguna, cree una gratis. Si el equipo ya tiene una organización de Azure DevOps, asegúrese de que es administrador del proyecto de Azure DevOps que desea usar.
Debe haber configurado una conexión de servicio a la suscripción de Azure. Las tareas en la canalización se ejecutan con la identidad de la entidad de servicio. Para ver los pasos para crear la conexión, consulte Creación de un proyecto de DevOps.
Necesita un archivo de Bicep que defina la infraestructura del proyecto. Este archivo está en un repositorio.
Necesita un archivo '.bicepparam' que defina los parámetros que usa el archivo de Bicep. Este archivo está en un repositorio.
Creación de una canalización
En la organización de Azure DevOps, seleccione Canalizaciones y Crear canalización.
Especifique dónde se almacena el código. En esta guía de inicio rápido se utilizan los repositorios Git de Azure Repos.
Seleccione el repositorio que tiene el código del proyecto.
Seleccione Canalización de inicio para el tipo de canalización que se va a crear.
Implementación de archivos de Bicep
Puede usar una tarea implementación del grupo de recursos de Azure o una tarea de la CLI de Azure para implementar un archivo de Bicep.
Uso de la tarea de implementación de plantillas de Azure Resource Manager
Nota:
A partir de la tarea de implementación de plantillas de Azure Resource Manager versión 3.235.0, se admite el uso de archivos ".bicepparam ".
Nota:
La tarea AzureResourceManagerTemplateDeployment@3
requiere que se proporcionen archivos Bicep y .bicepparam
al usar .bicepparam
. El archivo Bicep puede hacer referencia a todas las ubicaciones admitidas para las referencias de módulo. El archivo .bicepparam
debe hacer referencia al archivo Bicep local en la instrucción using
.
Reemplace la canalización de inicio por el siguiente código YAML. Usa la tarea de implementación de plantillas de Azure Resource Manager para crear un grupo de recursos e implementar un archivo Bicep y
.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 }}'
Actualice los valores de
azureServiceConnection
ylocation
.Compruebe que tiene un archivo válido
main.bicep
en el repositorio.Compruebe que dispone de un
main.bicepparam
archivo válido en su repositorio que contiene una declaraciónusing
.Haga clic en Guardar. La canalización de compilación se ejecuta automáticamente. Vuelva al resumen de la canalización de compilación y vea el estado.
Uso de una tarea de la CLI de Azure
Nota:
El az deployment group create
comando solo requiere un bicepparam.
archivo. La instrucción using
en el archivo .bicepparam
puede tener como destino cualquier ubicación admitida para hacer referencia al archivo de Bicep. Un archivo de Bicep solo es necesario en el repositorio cuando using
se aplica desde una ruta de acceso de disco local con la CLI de Azure.
Nota:
Cuando se usa un .bicepparam
archivo con el az deployment group create
comando , no se pueden invalidar los parámetros.
Reemplace la canalización de inicio por el siguiente código YAML. Crea un grupo de recursos e implementa un
.bicepparam
archivo mediante una tarea de la CLI de Azure: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
Para ver las descripciones de las entradas de tarea, consulte Tarea de la CLI v2 de Azure. Al usar la tarea en la nube aislada, debe establecer la propiedad
useGlobalConfig
de la tarea entrue
. El valor predeterminado esfalse
.Actualice los valores de
azureServiceConnection
ylocation
.Compruebe que tiene un archivo válido
main.bicepparam
en el repositorio que contiene unausing
declaración.Haga clic en Guardar. La canalización de compilación se ejecuta automáticamente. Vuelva al resumen de la canalización de compilación y vea el estado.
Limpieza de recursos
Cuando los recursos de Azure ya no sean necesarios, use la CLI de Azure o Azure PowerShell para eliminar el grupo de recursos de inicio rápido.
az group delete --name exampleRG