Compartir a través de

AzureResourceGroupDeployment@2: tarea implementación de grupo de recursos de Azure v2

  • Artículo

Implemente una plantilla de Azure Resource Manager (ARM) en un grupo de recursos y administre máquinas virtuales.

Implemente una plantilla de Azure Resource Manager (ARM) en un grupo de recursos. También puede iniciar, detener, eliminar y desasignar todas las máquinas virtuales (VM) de un grupo de recursos.

Sintaxis

# Azure resource group deployment v2
# Deploy an Azure Resource Manager (ARM) template to a resource group and manage virtual machines.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). VM details for WinRM. 
  # Advanced
    #deploymentName: # string. Optional. Use when action = Create Or Update Resource Group. Deployment name. 
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs. 
    #addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group. Access service principal details in override parameters. Default: false.
    #useWithoutJSON: false # boolean. Optional. Use when action = Create Or Update Resource Group. Use individual output values without JSON.Stringify applied. Default: false.

# Azure resource group deployment v2
# Deploy an Azure Resource Manager (ARM) template to a resource group and manage virtual machines.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). VM details for WinRM. 
  # Advanced
    #deploymentName: # string. Optional. Use when action = Create Or Update Resource Group. Deployment name. 
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs. 
    #addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group. Access service principal details in override parameters. Default: false.

# Azure Resource Group Deployment v2
# Deploy an Azure resource manager (ARM) template to a resource group. You can also start, stop, delete, deallocate all Virtual Machines (VM) in a resource group.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines/TFS service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). VM details for WinRM. 
  # Outputs
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs.

Entradas

azureSubscription - de suscripción de Azure
Alias de entrada: ConnectedServiceName. string. Obligatorio.

Selecciona la conexión de servicio que contiene una suscripción de Azure para la implementación.


action - acción
string. Obligatorio. Valores permitidos: Create Or Update Resource Group, Select Resource Group (Configurar opciones de implementación de máquinas virtuales), Start (Iniciar máquinas virtuales), Stop (Detener máquinas virtuales), StopWithDeallocate (Detener y desasignar máquinas virtuales), Restart (Reiniciar máquinas virtuales), Delete (Eliminar máquinas virtuales), DeleteRG (Eliminar grupo de recursos). Valor predeterminado: Create Or Update Resource Group.

Acción que se va a realizar en los recursos de Azure o en el grupo de recursos.


del grupo de recursos de resourceGroupName -
string. Obligatorio.

Proporciona el nombre del grupo de recursos.


ubicación de location -
string. Obligatorio cuando action = Create Or Update Resource Group.

Ubicación para implementar el grupo de recursos. Si el grupo de recursos ya existe en la suscripción, se omitirá este valor.


templateLocation - ubicación de plantilla
string. Obligatorio cuando action = Create Or Update Resource Group. Valores permitidos: Linked artifact, URL of the file. Valor predeterminado: Linked artifact.

Seleccione artefacto vinculado o dirección URL del archivo.


vínculo plantilla de csmFileLink -
string. Obligatorio cuando templateLocation = URL of the file && action = Create Or Update Resource Group.

Especifica la dirección URL del archivo de plantilla. Una dirección URL de ejemplo: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.json

Para implementar una plantilla almacenada en una cuenta de almacenamiento privada, recupere e incluya el token de firma de acceso compartido (SAS) en la dirección URL de la plantilla. Ejemplo: <blob_storage_url>/template.json?<SAStoken>

Para cargar un archivo de plantilla (o una plantilla vinculada) en una cuenta de almacenamiento y generar un token de SAS, use la tarea copia de archivos de Azure o siga los pasos que se indican mediante powerShell o cli de Azure.

Para ver los parámetros de plantilla en una cuadrícula, haga clic en ... junto al cuadro de texto Invalidar parámetros de plantilla. Esta característica requiere que las reglas de CORS estén habilitadas en el origen. Si las plantillas están en un blob de Azure Storage, consulte Descripción de las solicitudes cors para habilitar CORS.


vínculoparámetros de plantilla de csmParametersFileLink -
string. Opcional. Use cuando templateLocation = URL of the file && action = Create Or Update Resource Group.

Especifica la dirección URL del archivo de parámetros. Ejemplo: https://raw.githubusercontent.com/Azure/...

Para usar un archivo almacenado en una cuenta de almacenamiento privada, recupere e incluya el token de firma de acceso compartido (SAS) en la dirección URL de la plantilla. Ejemplo: <blob_storage_url>/template.json?<SAStoken> Para cargar un archivo de parámetros en una cuenta de almacenamiento y generar un token de SAS, puede usar tarea de copia de archivos de Azure o seguir los pasos que se indican con powerShell o cli de Azure.

Para ver los parámetros de plantilla en una cuadrícula, haga clic en ... junto al cuadro de texto Invalidar parámetros de plantilla. Esta característica requiere que las reglas de CORS estén habilitadas en el origen. Si las plantillas están en un blob de Azure Storage, consulte Descripción de las solicitudes cors para habilitar CORS.


de plantilla de csmFile -
string. Obligatorio cuando templateLocation = Linked artifact && action = Create Or Update Resource Group.

Especifica la ruta de acceso o un patrón que apunta a la plantilla de Azure Resource Manager. Obtenga más información sobre plantillas de Azure Resource Manager. Para empezar inmediatamente, use esta plantilla de ejemplo.


csmParametersFile - parámetros de plantilla
string. Opcional. Use cuando templateLocation = Linked artifact && action = Create Or Update Resource Group.

Especifica la dirección URL del archivo de parámetros. Una dirección URL de ejemplo: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Para usar un archivo almacenado en una cuenta de almacenamiento privada, recupere e incluya el token de firma de acceso compartido (SAS) en la dirección URL de la plantilla. Ejemplo: <blob_storage_url>/template.json?<SAStoken> Para cargar un archivo de parámetros en una cuenta de almacenamiento y generar un token de SAS, use la tarea copia de archivos de Azure de o siga los pasos que se describen con powerShell o cli de Azure.

Para ver los parámetros de plantilla en una cuadrícula, haga clic en ... junto al cuadro de texto Invalidar parámetros de plantilla. Esta característica requiere que las reglas de CORS estén habilitadas en el origen. Si las plantillas están en un blob de Azure Storage, consulte Descripción de las solicitudes cors para habilitar CORS.


overrideParameters - Invalidar parámetros de plantilla
string. Opcional. Use cuando action = Create Or Update Resource Group.

Especifica los parámetros de plantilla que se van a invalidar.

Para ver los parámetros de plantilla en una cuadrícula, haga clic en ... junto al cuadro de texto Invalidar parámetros. Esta característica requiere que las reglas de CORS estén habilitadas en el origen. Si las plantillas están en el blob de Azure Storage, haga referencia a esta cadena para habilitar CORS o escriba los parámetros de plantilla que se invalidan en el cuadro de texto.

Ejemplo: -storageName fabrikam -adminUsername $(vmusername) -adminPassword (ConvertTo-SecureString -String '$(password)' -AsPlainText -Force) -azureKeyVaultName $(fabrikamFibre).

Si el valor del parámetro tiene varias palabras, incluya las palabras entre comillas, aunque pase el valor mediante variables. Por ejemplo, -name "parameter value" -name2 "$(var)". Para invalidar los parámetros de tipo de objeto, use objetos JSON con cadena. Por ejemplo, -options ["option1"] -map {"key1": "value1" }.


modo de implementación de deploymentMode -
string. Obligatorio cuando action = Create Or Update Resource Group. Valores permitidos: Incremental, Complete, Validation (solo validación). Valor predeterminado: Incremental.

El modo Incremental controla las implementaciones como actualizaciones incrementales del grupo de recursos. Deja los recursos sin cambios que existen en el grupo de recursos, pero no se especifican en la plantilla.

Complete modo elimina los recursos que no están en la plantilla. El modo completo tarda relativamente más tiempo que el modo incremental. Si la tarea agota el tiempo de espera, considere la posibilidad de aumentar el tiempo de espera o cambiar al modo Incremental.

Advertencia

El modo completo eliminará todos los recursos existentes del grupo de recursos que no se especifican en la plantilla. Revise si el grupo de recursos en el que va a implementar no contiene los recursos necesarios que no se especifican en la plantilla.

Validate modo permite encontrar problemas con la plantilla antes de crear recursos reales.

Nota

El modo Validate siempre crea un grupo de recursos, incluso si no se implementa ningún recurso.

Obtenga más información sobre los modos de implementación de .


enableDeploymentPrerequisites - Habilitación de los requisitos previos
string. Opcional. Use cuando action = Create Or Update Resource Group || action = Select Resource Group. Valores permitidos: None, ConfigureVMwithWinRM (Configurar con el agente winRM), ConfigureVMWithDGAgent (Configurar con agente de grupo de implementación). Valor predeterminado: None.

Solo se aplica cuando el grupo de recursos contiene máquinas virtuales.

Al elegir la opción Grupo de implementación, se configura el agente de grupo de implementación en cada una de las máquinas virtuales.

Al seleccionar la opción WinRM, se configura el agente de escucha de Administración remota de Windows (WinRM) a través del protocolo HTTPS en el puerto 5986 mediante un certificado autofirmado. Esta configuración es necesaria para realizar operaciones de implementación en máquinas de Azure. Si un equilibrador de carga respalda las máquinas virtuales de destino, asegúrese de que las reglas NAT de entrada están configuradas para el puerto de destino (5986).


teamServicesConnection - de conexión del servicio Azure Pipelines
Alias de entrada: deploymentGroupEndpoint. string. Obligatorio cuando (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent.

Especifica la conexión de servicio para conectarse a una organización o colección de Azure DevOps para el registro del agente.

Puede crear una conexión de servicio mediante +New y, a continuación, seleccionar Token-based authentication. Necesita un token de acceso personal (PAT) para configurar una conexión de servicio. Haga clic en Manage para actualizar los detalles de la conexión del servicio.


teamServicesConnection - conexión de servicio de Azure Pipelines/TFS
Alias de entrada: deploymentGroupEndpoint. string. Obligatorio cuando (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent.

Especifica la conexión de servicio para conectarse a una organización o colección de Azure DevOps para el registro del agente.

Puede crear una conexión de servicio mediante +New y, a continuación, seleccionar Token-based authentication. Necesita un token de acceso personal (PAT) para configurar una conexión de servicio. Haga clic en Manage para actualizar los detalles de la conexión del servicio.


de proyecto de teamProject - Team
Alias de entrada: project. string. Obligatorio cuando (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent.

Especifica el proyecto de equipo que define el grupo de implementación.


de grupo de implementación de deploymentGroupName -
string. Obligatorio cuando (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent.

Especifica el grupo de implementación en el que se registrarán los agentes. Obtenga más información sobre los grupos de implementación de .


copyAzureVMTags - Copia de etiquetas de máquina virtual de Azure en agentes
boolean. Opcional. Use cuando (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Valor predeterminado: true.

Elige si es necesario copiar las etiquetas configuradas en la máquina virtual de Azure en el agente de grupo de implementación correspondiente.

De forma predeterminada, todas las etiquetas de Azure se copian siguiendo el formato: Key: Value. Ejemplo: se copiaría una etiqueta de Azure Role : Web as-is en la máquina del agente.

Obtenga más información sobre mediante etiquetas para recursos de Azure.


runAgentServiceAsUser - Ejecutar servicio de agente como usuario
boolean. Opcional. Use cuando (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Valor predeterminado: false.

Ejecuta el servicio del agente como un usuario distinto del usuario predeterminado si el valor está establecido en true.

El usuario predeterminado es NT AUTHORITY\\SYSTEM en Windows y root en Linux.


nombre de usuario de userName -
string. Obligatorio cuando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true.

Nombre de usuario para ejecutar el servicio del agente en las máquinas virtuales.

Para los usuarios del dominio, especifique valores como domain\username o username@domain.com. Para los usuarios locales, especifique username.

Se supone que el mismo usuario de dominio o un usuario local con el mismo nombre, respectivamente, está presente en todas las máquinas virtuales del grupo de recursos.


de contraseña de password -
string. Opcional. Use cuando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true.

Contraseña para que el usuario ejecute el servicio del agente en las máquinas virtuales Windows.

Se supone que la contraseña es la misma para el usuario especificado en todas las máquinas virtuales.

Puede aceptar variables definidas en canalizaciones de compilación o versión como $(passwordVariable). Puede marcar la variable como secret para protegerla.

En el caso de las máquinas virtuales Linux, no se requiere una contraseña y se omitirá.


detalles de la máquina virtual de outputVariable - de WinRM
string. Opcional. Use cuando (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None).

Obligatorio cuando se selecciona un grupo de recursos existente. Proporciona un nombre para la variable de grupo de recursos. La variable se puede usar como $(variableName) para hacer referencia al grupo de recursos en tareas posteriores, como en powerShell en la tarea Máquinas de destino para implementar aplicaciones.

Válido solo cuando la acción seleccionada es Create, Updateo Select.


de nombre de implementación de deploymentName -
string. Opcional. Use cuando action = Create Or Update Resource Group.

Especifica el nombre de la implementación del grupo de recursos que se va a crear.


salidas de implementación de deploymentOutputs -
string. Opcional. Use cuando action = Create Or Update Resource Group.

Proporciona un nombre para la variable de salida, que contiene la sección de salidas del objeto de implementación actual en formato de cadena. Use el cmdlet de PowerShell ConvertFrom-Json para analizar el objeto JSON y acceder a los valores de salida individuales.


addSpnToEnvironment - detalles de la entidad de servicio de Access en los parámetros de invalidación
boolean. Opcional. Use cuando action = Create Or Update Resource Group. Valor predeterminado: false.

Agrega el identificador y la clave de la entidad de servicio del punto de conexión de Azure elegido para ser el entorno de ejecución del script. Las variables $servicePrincipalId y $servicePrincipalKey pueden estar en parámetros de invalidación, como -key $servicePrincipalKey.


useWithoutJSON - Usar valores de salida individuales sin JSON. Stringify aplicado
boolean. Opcional. Use cuando action = Create Or Update Resource Group. Valor predeterminado: false.

Los valores de salida individuales se convierten a través de JSON. Stringify de forma predeterminada. Si desea usar los valores de salida tal como está sin convertirlos a través de JSON. Stringify, habilite esta opción. Para obtener más información, consulte este.


Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Hay una nueva versión de esta tarea disponible en AzureResourceManagerTemplateDeployment@3: tarea de implementación de plantillas de ARM v3.

Novedades de la versión 2 de la tarea

  • Funciona con agentes multiplataforma (Linux, macOS o Windows)
  • Admite JSON de plantilla ubicados en cualquier dirección URL http/https accesible públicamente.
  • Experiencia de usuario mejorada para los parámetros Override que ahora se pueden ver o editar en una cuadrícula.
  • Asignación de reglas NAT para máquinas virtuales respaldadas por un equilibrador de carga.
  • El campo "Grupo de recursos" ahora se cambia de nombre como "Detalles de máquina virtual para WinRM" y se incluye en la sección "Opciones de implementación avanzadas para máquinas virtuales".
  • Limitaciones:
    • No se admiten suscripciones clásicas. Solo se admiten las suscripciones de ARM.
    • No se admite la sintaxis de PowerShell, ya que la tarea ahora está basada en node.js. Asegúrese de que la distinción entre mayúsculas y minúsculas de los nombres de parámetro coincide, al invalidar los parámetros de plantilla. Además, quite los cmdlets de PowerShell como "ConvertTo-SecureString" al migrar de la versión 1.0 a la versión 2.0.

Solución de problemas

Error: Error interno del servidor

Estos problemas son principalmente transitorios por naturaleza. Hay varias razones por las que podría estar ocurriendo:

  • Uno de los servicios de Azure en los que está intentando realizar la implementación está realizando un mantenimiento en la región en la que está intentando realizar la implementación. Tenga en cuenta https://status.azure.com/ para comprobar los tiempos de inactividad de los servicios de Azure.
  • El propio servicio Azure Pipelines está pasando por el mantenimiento. Tenga en cuenta https://status.dev.azure.com/ para tiempos de inactividad.

Sin embargo, hemos visto algunos casos en los que esto se debe a un error en la plantilla de ARM, como el servicio de Azure que intenta implementar no admite la región que ha elegido para el recurso.

Error: Tiempo de espera

Los problemas de tiempo de espera podrían provenr de dos lugares:

  • Agente de Azure Pipelines
  • Implementación del portal

Puede identificar si el tiempo de espera es del portal; para ello, compruebe el vínculo de implementación del portal que estará en los registros de tareas. Si no hay ningún vínculo, es probable que esto se deba al agente de Azure Pipelines. Si hay un vínculo, siga el vínculo para ver si hay un tiempo de espera que se ha producido en la implementación del portal.

Error: reglas de CORS que se van a habilitar al invalidar parámetros

Si se hace referencia al archivo de plantilla desde un BLOB, mientras se reemplazan los parámetros de la canalización, es posible que vea el siguiente mensaje de advertencia:

Warning: Failed to download the file from template path.

Esta característica requiere que las reglas de CORS estén habilitadas en el origen. Si las plantillas están en el blob de Azure Storage, consulte compatibilidad con el uso compartido de recursos entre orígenes para habilitar CORS.

Además de habilitar CORS, asegúrese de que el token de SAS especificado en el vínculo de la plantilla es "srt-sco". Este token es necesario para que descargue el archivo y continúe.

Agente de Azure Pipelines

Si el problema procede del agente de Azure Pipelines, puede aumentar el tiempo de espera estableciendo timeoutInMinutes como clave en YAML en 0. Para obtener más información, consulte Especificar trabajos en la canalización.

Implementación del portal

Consulte este documento sobre cómo identificar si el error procede de Azure Portal: Ver el historial de implementación con Azure Resource Manager.

En el caso de la implementación del portal, pruebe a establecer "timeoutInMinutes" en la plantilla de ARM en "0". Si no se especifica, el valor asumido es de 60 minutos. 0 se asegura de que la implementación se ejecutará siempre que pueda realizarse correctamente.

Esto también puede ocurrir debido a problemas transitorios en el sistema. Tenga en cuenta https://status.dev.azure.com/ para comprobar si hay un tiempo de inactividad en el servicio Azure Pipelines.

Error: Error en la validación de la plantilla de Azure Resource Manager (ARM)

Este problema se produce principalmente debido a un parámetro no válido en la plantilla de ARM, como una SKU o región no admitidas. Si se produce un error en la validación, compruebe el mensaje de error. Debe apuntar al recurso y al parámetro que no es válido.

Este problema también puede producirse debido a cadenas de varias líneas. Actualmente, la tarea Implementación del grupo de recursos de Azure no admite cadenas de varias líneas en un archivo JSON de plantilla o parámetro de ARM.

Además, consulte este artículo sobre la estructura y la sintaxis de las plantillas de ARM: Comprender la estructura y la sintaxis de las plantillas de ARM.

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
demandas Ninguno
funcionalidades de Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos Cualquier
variables settable Cualquier
Versión del agente 2.119.1 o superior
Categoría de tarea Desplegar