Compartir vía

AzureResourceGroupDeployment@2: tarea de implementación del 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 Virtual Machines (VM) de un grupo de recursos.

Syntax

# 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 enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. 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 enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. 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 enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines/TFS service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Outputs
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs.

Entradas

azureSubscription - 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.


resourceGroupName - Grupo de recursos
string. Obligatorio.

Proporciona el nombre del grupo de recursos.


location - Ubicación
string. Necesario cuando action = Create Or Update Resource Group.

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


templateLocation - Ubicación de la plantilla
string. Necesario 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.


csmFileLink - Vínculo de plantilla
string. Necesario 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 de copia de archivos de Azure o siga los pasos que se indican mediante PowerShell o la 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 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.


csmParametersFileLink - Vínculo de parámetros de plantilla
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 la tarea de copia de archivos de Azure o seguir los pasos que se indican con PowerShell o la 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 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.


csmFile - Plantilla
string. Necesario 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 las 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 de copia de archivos de Azure o siga los pasos que se indican mediante PowerShell o la 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 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 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 van a invalidar 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 parámetros de tipo de objeto, use objetos JSON con cadena. Por ejemplo, -options ["option1"] -map {"key1": "value1" }.


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

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

El modo Complete 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 Incremental modo.

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.

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

Nota

El Validate modo 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.


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 el agente de grupo de implementación). Valor predeterminado: None.

Solo es aplicable cuando el grupo de recursos contiene máquinas virtuales.

Al elegir la opción Grupo de implementación, se configura el agente del 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 la operación de implementación en las 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 - Conexión del servicio Azure Pipelines
Alias de entrada: deploymentGroupEndpoint. string. Necesario cuando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

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 y, a +New continuación, seleccionar Token-based authentication. Necesita un token de acceso personal (PAT) para configurar una conexión de servicio. Haga clic Manage para actualizar los detalles de la conexión de servicio.


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

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 y, a +New continuación, seleccionar Token-based authentication. Necesita un token de acceso personal (PAT) para configurar una conexión de servicio. Haga clic Manage para actualizar los detalles de la conexión de servicio.


teamProject - Proyecto de equipo
Alias de entrada: project. string. Necesario cuando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

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


deploymentGroupName - Grupo de implementación
string. Necesario cuando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

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.


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

Elige si las etiquetas configuradas en la máquina virtual de Azure deben copiarse 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: una Role : Web etiqueta de Azure se copiaría tal cual en la máquina del agente.

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


runAgentServiceAsUser - Ejecución del servicio de agente como usuario
boolean. Opcional. Use cuando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. 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 está NT AUTHORITY\\SYSTEM en Windows y root en Linux.


userName - Nombre de usuario
string. Necesario cuando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

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.


password - Contraseña
string. Opcional. Use cuando enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

Contraseña para que el usuario ejecute el servicio del agente en las VM 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á.


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

Necesario 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.


deploymentName - Nombre de implementación
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.


deploymentOutputs - Salidas de implementación
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 ConvertFrom-Json cmdlet de PowerShell para analizar el objeto JSON y acceder a los valores de salida individuales.


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

Agrega el identificador de la entidad de servicio y la clave 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 - Use 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 quiere usar los valores de salida tal y como está sin convertirlos a través de JSON. Stringify, habilite esta opción. Para obtener más información, consulte esto.


Opciones de control de tareas

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

Variables de salida

Ninguno.

Comentarios

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 las direcciones URL http/https accesibles 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 la 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 del servidor interno

Estos problemas suelen ser temporales. Hay varios motivos por los que esto puede ocurrir:

  • Uno de los servicios de Azure que intenta implementar se encuentra en proceso de mantenimiento en la región en la que intenta 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 pasa por el mantenimiento. Controle los tiempos de inactividad en el https://status.dev.azure.com/.

Sin embargo, hemos visto algunas instancias en las que esto se debe a un error en la plantilla de ARM, por ejemplo, cuando el servicio de Azure que está intentando implementar no admite la región que ha elegido para el recurso.

Error: tiempo de espera

Las incidencias de tiempo de espera pueden tener dos orígenes:

  • El agente de Azure Pipelines
  • La implementación en el portal

Para saber si el tiempo de espera se origina en el portal, compruebe si existe un vínculo de implementación del portal que se encuentra en los registros de tareas. Si no hay ningún vínculo, es probable que el problema se origine en el agente Azure Pipelines. Si hay un vínculo, sígalo para ver si hay un tiempo de espera que se ha producido en la implementación del portal.

Error: reglas de CORS que se deben habilitar durante la invalidación de parámetros

Si se hace referencia al archivo de plantilla desde un BLOB, mientras se reemplazan parámetros en 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 CORS estén habilitadas en el origen. Si las plantillas están en un 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 sea "srt-sco". Este token es necesario para descargar el archivo y continuar.

El 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 Especificación de trabajos en la canalización.

La implementación en el portal

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

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

Esto también podría ocurrir debido a incidencias transitorias 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 parámetro o plantilla de ARM.

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

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones None
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente 2.119.1 o superior
Categoría de la tarea: Implementación