AzureResourceGroupDeployment@1: tarea Implementación de grupo de recursos de Azure v1

Artículo
2025-03-24

Use esta tarea para implementar, iniciar, detener y eliminar grupos de recursos de Azure.

Esta tarea está en desuso; use AzureResourceGroupDeployment@2.

Sintaxis

# Azure Resource Group Deployment v1
# Deploy, start, stop, delete Azure Resource Groups.
- task: AzureResourceGroupDeployment@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameClassic'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Subscription. 
    #ConnectedServiceNameClassic: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Azure Classic Subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'Restart' | 'Delete' | 'DeleteRG'. Required when ConnectedServiceNameSelector = ConnectedServiceName. Action. Default: Create Or Update Resource Group.
    #actionClassic: 'Select Resource Group' # 'Select Resource Group'. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Action. Default: Select Resource Group.
    resourceGroupName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Resource Group. 
    #cloudService: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Cloud Service. 
    #location: 'East US' # 'Australia East' | 'Australia Southeast' | 'Brazil South' | 'Canada Central' | 'Canada East' | 'Central India' | 'Central US' | 'East Asia' | 'East US' | 'East US 2 ' | 'Japan East' | 'Japan West' | 'North Central US' | 'North Europe' | 'South Central US' | 'South India' | 'Southeast Asia' | 'UK South' | 'UK West' | 'West Central US' | 'West Europe' | 'West India' | 'West US' | 'West US 2'. Required when action = Create Or Update Resource Group. Location. Default: East US.
    #csmFile: # string. Required when action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when action = Create Or Update Resource Group. Template Parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override Template Parameters. 
    #deploymentMode: 'Incremental' # 'Validation' | 'Incremental' | 'Complete'. Required when action = Create Or Update Resource Group. Deployment Mode. Default: Incremental.
    #enableDeploymentPrerequisitesForCreate: false # boolean. Optional. Use when action = Create Or Update Resource Group. Enable Deployment Prerequisites. Default: false.
    #enableDeploymentPrerequisitesForSelect: false # boolean. Optional. Use when action = Select Resource Group. Enable Deployment Prerequisites. Default: false.
  # Output
    #outputVariable: # string. Resource Group.

Entradas

ConnectedServiceNameSelector - de tipo de conexión de Azure
string. Valores permitidos: ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (Azure clásico). Valor predeterminado: ConnectedServiceName.

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

ConnectedServiceName - de suscripción de Azure
string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceName.

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

ConnectedServiceNameClassic - de suscripción clásica de Azure
string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Selecciona una suscripción clásica de Azure para la implementación.

action - acción
string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceName. Valores permitidos: Create Or Update Resource Group, Select Resource Group, Start (Iniciar máquinas virtuales), Stop (Detener 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.

actionClassic - acción
string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceNameClassic. Valores permitidos: Select Resource Group (Seleccione Servicio en la nube). Valor predeterminado: Select Resource Group.

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

de grupo de recursos de resourceGroupName -
string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceName.

Proporciona el nombre del grupo de recursos.

de servicio en la nube de cloudService -
string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Proporciona el nombre del servicio en la nube.

ubicación de location -
string. Obligatorio cuando action = Create Or Update Resource Group. Valores permitidos: Australia East, Australia Southeast, Brazil South, Canada Central, Canada East, Central India, Central US, East Asia, East US, East US 2 , Japan East, Japan West, North Central US, North Europe, South Central US, South India, Southeast Asia, UK South, UK West, West Central US, West Europe, West India, West US, West US 2. Valor predeterminado: East US.

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

de plantilla de csmFile -
string. Obligatorio cuando 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 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 el blob de Azure Storage, consulte uso compartido de recursos entre orígenes 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: Validation (solo validación), Incremental, Complete. 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 .

enableDeploymentPrerequisitesForCreate - Habilitar requisitos previos de implementación
boolean. Opcional. Use cuando action = Create Or Update Resource Group. Valor predeterminado: false.

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

enableDeploymentPrerequisitesForSelect - Habilitar requisitos previos de implementación
boolean. Opcional. Use cuando action = Select Resource Group. Valor predeterminado: false.

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.

de grupo de recursos de outputVariable -
string.

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.

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.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
demandas	Los agentes autohospedados deben tener funcionalidades que coincidan con los siguientes exigen ejecutar trabajos que usen esta tarea: azureps
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	1.103.0 o superior
Categoría de tarea	Desplegar

Compartir a través de