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

  • Artículo

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

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

Syntax

# 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 - Tipo de conexión de Azure
string. Valores permitidos: ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (Azure clásico). Valor predeterminado: ConnectedServiceName.

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


ConnectedServiceName - Suscripción de Azure
string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceName.

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


ConnectedServiceNameClassic - Suscripción clásica de Azure
string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceNameClassic.

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


action - Acción
string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceName. Valores permitidos: Create Or Update Resource Group, , StartSelect Resource Group(Iniciar Virtual Machines), Stop (Detener Virtual Machines), Restart (Reiniciar Virtual Machines), Delete (Eliminar Virtual Machines), 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. Necesario 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.


resourceGroupName - Grupo de recursos
string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceName.

Proporciona el nombre del grupo de recursos.


cloudService - Servicio en la nube
string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Proporciona el nombre del servicio en la nube.


location - Ubicación
string. Necesario cuando action = Create Or Update Resource Group. Valores permitidos: , , Canada Central. Canada EastWest US 2West Central USJapan WestJapan EastNorth Central USEast US 2 East USNorth EuropeUK SouthSoutheast AsiaUK WestSouth IndiaWest EuropeWest IndiaAustralia SoutheastCentral IndiaWest USBrazil SouthCentral USEast AsiaSouth Central USAustralia East Valor predeterminado: East US.

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.


csmFile - Plantilla
string. Necesario 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 las 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 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 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 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: Validation (solo validación), Incremental, Complete. 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.


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

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


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

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


outputVariable - Grupo de recursos
string.

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.


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.

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: azureps
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 1.103.0 o superior
Categoría de la tarea: Implementación