Partage via

AzureResourceGroupDeployment@1 - Tâche De déploiement de groupe de ressources Azure v1

  • Article

Utilisez cette tâche pour déployer, démarrer, arrêter et supprimer des groupes de ressources Azure.

Cette tâche est déconseillée ; utilisez 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.

Entrées

ConnectedServiceNameSelector - Type de connexion Azure
string. Valeurs autorisées : ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (Azure Classic). Valeur par défaut : ConnectedServiceName.

Obligatoire. Sélectionne la connexion de service qui contient un abonnement Azure pour le déploiement.


ConnectedServiceName - Abonnement Azure
string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceName.

Obligatoire. Sélectionne la connexion de service qui contient un abonnement Azure pour le déploiement.


ConnectedServiceNameClassic - Abonnement Azure Classic
string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Sélectionne un abonnement Azure Classic pour le déploiement.


action - Action
string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceName. Valeurs autorisées : Create Or Update Resource Group, StartSelect Resource Group(Start Machines Virtuelles), Stop (Arrêter Machines Virtuelles), Restart (Redémarrer Machines Virtuelles), Delete (Supprimer Machines Virtuelles), DeleteRG (Supprimer le groupe de ressources). Valeur par défaut : Create Or Update Resource Group.

Action à effectuer sur les ressources ou le groupe de ressources Azure.


actionClassic - Action
string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceNameClassic. Valeurs autorisées : Select Resource Group (Sélectionnez Service cloud). Valeur par défaut : Select Resource Group.

Action à effectuer sur les ressources Azure ou le service cloud.


resourceGroupName - Groupe de ressources
string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceName.

Fournit le nom du groupe de ressources.


cloudService - Cloud Service
string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Fournit le nom du service cloud.


location - Emplacement
string. Nécessaire lorsque action = Create Or Update Resource Group. Valeurs autorisées : Australia East, Australia Southeast, Brazil South, Canada EastJapan WestEast USEast AsiaEast US 2 Central USJapan EastNorth Central USCentral IndiaSoutheast AsiaCanada CentralSouth IndiaSouth Central USNorth Europe, . UK SouthUK WestWest Central USWest EuropeWest IndiaWest USWest US 2 Valeur par défaut : East US.

Emplacement où déployer le groupe de ressources. Si le groupe de ressources existe déjà dans l’abonnement, cette valeur est ignorée.


csmFile - Modèle
string. Nécessaire lorsque action = Create Or Update Resource Group.

Spécifie le chemin d’accès ou un modèle pointant vers le modèle Azure Resource Manager. En savoir plus sur les modèles Azure Resource Manager. Pour commencer immédiatement, utilisez cet exemple de modèle.


csmParametersFile - Paramètres de modèle
string. facultatif. Utilisez quand action = Create Or Update Resource Group.

Spécifie l’URL du fichier de paramètres. Exemple d’URL : https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Pour utiliser un fichier stocké dans un compte de stockage privé, récupérez et incluez le jeton de signature d’accès partagé (SAP) dans l’URL du modèle. Exemple : <blob_storage_url>/template.json?<SAStoken> Pour charger un fichier de paramètres sur un compte de stockage et générer un jeton SAP, utilisez la tâche de copie de fichiers Azure ou suivez les étapes à l’aide de PowerShell ou d’Azure CLI.

Pour afficher les paramètres du modèle dans une grille, cliquez sur en … regard de la zone de texte Remplacer les paramètres du modèle. Cette fonctionnalité impose que les règles CORS soient activées au niveau de la source. Si les modèles se trouvent dans un objet blob de stockage Azure, reportez-vous à Partage de ressources inter-origines pour activer CORS.


overrideParameters - Remplacer les paramètres de modèle
string. facultatif. Utilisez quand action = Create Or Update Resource Group.

Spécifie les paramètres de modèle à remplacer.

Pour afficher les paramètres du modèle dans une grille, cliquez sur en ... regard de la zone de texte Remplacer les paramètres. Cette fonctionnalité impose que les règles CORS soient activées au niveau de la source. Si les modèles se trouvent dans l’objet blob stockage Azure, référencez cette chaîne pour activer CORS ou tapez les paramètres de modèle à remplacer dans la zone de texte.

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

Si la valeur du paramètre comporte plusieurs mots, placez les mots entre guillemets, même si vous transmettez la valeur à l’aide de variables. Par exemple : -name "parameter value" -name2 "$(var)". Pour remplacer les paramètres de type d’objet, utilisez des objets JSON stringifiés. Par exemple : -options ["option1"] -map {"key1": "value1" }.


deploymentMode - Mode de déploiement
string. Nécessaire lorsque action = Create Or Update Resource Group. Valeurs autorisées : Validation (Validation uniquement), Incremental, Complete. Valeur par défaut : Incremental.

Le Incremental mode gère les déploiements en tant que mises à jour incrémentielles du groupe de ressources. Il conserve telles quelles les ressources qui existent dans le groupe de ressources, mais qui ne sont pas spécifiées dans le modèle.

Le mode Complete supprime les ressources qui ne sont pas dans votre modèle. Le mode Complet prend relativement plus de temps que le mode incrémentiel. Si la tâche expire, envisagez d’augmenter le délai d’expiration ou de passer au Incremental mode.

Avertissement

Le mode Complet supprime toutes les ressources existantes du groupe de ressources qui ne sont pas spécifiées dans le modèle. Vérifiez si le groupe de ressources sur lequel vous déployez ne contient pas de ressources nécessaires qui ne sont pas spécifiées dans le modèle.

Le mode Validate vous permet de trouver des problèmes avec le modèle avant de créer des ressources réelles.

Notes

Le Validate mode crée toujours un groupe de ressources, même si aucune ressource n’est déployée.

En savoir plus sur les modes de déploiement.


enableDeploymentPrerequisitesForCreate - Activer les prérequis de déploiement
boolean. facultatif. Utilisez quand action = Create Or Update Resource Group. Valeur par défaut : false.

Applicable uniquement lorsque le groupe de ressources contient des machines virtuelles.

Le choix de l’option Groupe de déploiement configure l’agent de groupe de déploiement sur chacune des machines virtuelles.

La sélection de l’option WinRM configure l’écouteur Windows Remote Management (WinRM) sur le protocole HTTPS sur le port 5986 à l’aide d’un certificat auto-signé. Cette configuration est nécessaire pour effectuer une opération de déploiement sur des machines Azure. Si les machines virtuelles cibles sont sauvegardées par un équilibreur de charge, vérifiez que les règles NAT entrantes sont configurées pour le port cible (5986).


enableDeploymentPrerequisitesForSelect - Activer les prérequis de déploiement
boolean. facultatif. Utilisez quand action = Select Resource Group. Valeur par défaut : false.

Applicable uniquement lorsque le groupe de ressources contient des machines virtuelles.

Le choix de l’option Groupe de déploiement configure l’agent de groupe de déploiement sur chacune des machines virtuelles.

La sélection de l’option WinRM configure l’écouteur Windows Remote Management (WinRM) sur le protocole HTTPS sur le port 5986 à l’aide d’un certificat auto-signé. Cette configuration est nécessaire pour effectuer une opération de déploiement sur des machines Azure. Si les machines virtuelles cibles sont soutenues par un équilibreur de charge, vérifiez que les règles NAT de trafic entrant sont configurées pour le port cible (5986).


outputVariable - Groupe de ressources
string.

Obligatoire lorsqu’un groupe de ressources existant est sélectionné. Fournit un nom pour la variable de groupe de ressources. La variable peut être utilisée comme $(variableName) pour faire référence au groupe de ressources dans les tâches suivantes, telles que dans PowerShell sur les machines cibles, tâche de déploiement d’applications.

Valide uniquement lorsque l’action sélectionnée est Create, Updateou Select.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Configuration requise

Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent, DeploymentGroup
Demandes Les agents auto-hébergés doivent avoir des fonctionnalités qui correspondent aux exigences suivantes pour exécuter des travaux qui utilisent cette tâche : azureps
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande Quelconque
Variables paramétrables Quelconque
Version de l’agent 1.103.0 ou version ultérieure
Catégorie de la tâche Déployer