AzureResourceGroupDeployment@2 - Tâche de déploiement de groupe de ressources Azure v2

  • Article

Déployez un modèle Azure Resource Manager (ARM) dans un groupe de ressources et gérez les machines virtuelles.

Déployez un modèle Azure Resource Manager (ARM) dans un groupe de ressources. Vous pouvez également démarrer, arrêter, supprimer et libérer toutes les Machines Virtuelles (machine virtuelle) dans un groupe de ressources.

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.

Entrées

azureSubscription - Abonnement Azure
Alias d’entrée : ConnectedServiceName. string. Obligatoire.

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


action - Action
string. Obligatoire. Valeurs autorisées : Create Or Update Resource Group, Select Resource Group (Configurer les options de déploiement de machine virtuelle), Start (Démarrer les machines virtuelles), Stop (Arrêter les machines virtuelles), StopWithDeallocate (Arrêter et libérer les machines virtuelles), Restart (Redémarrer les machines virtuelles), Delete (Supprimer des 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.


resourceGroupName - Groupe de ressources
string. Obligatoire.

Fournit le nom du groupe de ressources.


location - Emplacement
string. Nécessaire lorsque action = Create Or Update Resource Group.

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


templateLocation - Emplacement du modèle
string. Nécessaire lorsque action = Create Or Update Resource Group. Valeurs autorisées : Linked artifact, URL of the file. Valeur par défaut : Linked artifact.

Sélectionnez Artefact lié ou URL du fichier.


csmFileLink - Lien de modèle
string. Nécessaire lorsque templateLocation = URL of the file && action = Create Or Update Resource Group.

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

Pour déployer un modèle 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 modèle (ou un modèle lié) dans 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 Paramètres de modèle de remplacement. 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, consultez Présentation des demandes CORS pour activer CORS.


csmParametersFileLink - Lien paramètres de modèle
string. facultatif. Utilisez quand templateLocation = URL of the file && action = Create Or Update Resource Group.

Spécifie l’URL du fichier de paramètres. Exemple : https://raw.githubusercontent.com/Azure/...

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 dans un compte de stockage et générer un jeton SAP, vous pouvez utiliser la tâche de copie de fichiers Azure ou suivre 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 Paramètres de modèle de remplacement. 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, consultez Présentation des demandes CORS pour activer CORS.


csmFile - Modèle
string. Nécessaire lorsque templateLocation = Linked artifact && 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 templateLocation = Linked artifact && 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 dans 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 Paramètres de modèle de remplacement. 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, consultez Présentation des demandes CORS 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 Paramètres de remplacement. 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 de 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 : Incremental, Complete, Validation (Validation uniquement). 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 effectuez le déploiement 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.


enableDeploymentPrerequisites - Activer les prérequis
string. facultatif. Utilisez quand action = Create Or Update Resource Group || action = Select Resource Group. Valeurs autorisées : None, ConfigureVMwithWinRM (Configurer avec l’agent WinRM), ConfigureVMWithDGAgent (Configurer avec l’agent de groupe de déploiement). Valeur par défaut : None.

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


teamServicesConnection - Connexion au service Azure Pipelines
Alias d’entrée : deploymentGroupEndpoint. string. Nécessaire lorsque enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Spécifie la connexion de service à connecter à un organization ou à une collection Azure DevOps pour l’inscription de l’agent.

Vous pouvez créer une connexion de service en sélectionnant +New , puis en sélectionnant Token-based authentication. Vous avez besoin d’un jeton d’accès personnel (PAT) pour configurer une connexion de service. Cliquez pour Manage mettre à jour les détails de connexion du service.


teamServicesConnection - Connexion au service Azure Pipelines/TFS
Alias d’entrée : deploymentGroupEndpoint. string. Nécessaire lorsque enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Spécifie la connexion de service à connecter à un organization ou à une collection Azure DevOps pour l’inscription de l’agent.

Vous pouvez créer une connexion de service en sélectionnant +New , puis en sélectionnant Token-based authentication. Vous avez besoin d’un jeton d’accès personnel (PAT) pour configurer une connexion de service. Cliquez pour Manage mettre à jour les détails de connexion du service.


teamProject - Projet d’équipe
Alias d’entrée : project. string. Nécessaire lorsque enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Spécifie le projet d’équipe qui définit le groupe de déploiement.


deploymentGroupName - Groupe de déploiement
string. Nécessaire lorsque enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Spécifie le groupe de déploiement sur lequel les agents seront inscrits. En savoir plus sur les groupes de déploiement.


copyAzureVMTags - Copier des étiquettes de machine virtuelle Azure vers des agents
boolean. facultatif. Utilisez quand enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Valeur par défaut : true.

Détermine si les étiquettes configurées sur la machine virtuelle Azure doivent être copiées dans l’agent de groupe de déploiement correspondant.

Par défaut, toutes les balises Azure sont copiées au format : Key: Value. Exemple : une Role : Web balise Azure est copiée telle quelle sur la machine de l’agent.

En savoir plus sur l’utilisation des balises pour les ressources Azure.


runAgentServiceAsUser - Exécuter le service de l’agent en tant qu’utilisateur
boolean. facultatif. Utilisez quand enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Valeur par défaut : false.

Exécute le service agent en tant qu’utilisateur autre que l’utilisateur par défaut si la valeur est définie sur true.

L’utilisateur par défaut se trouve NT AUTHORITY\\SYSTEM dans Windows et root dans Linux.


userName - Nom d’utilisateur
string. Nécessaire lorsque enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

Nom d’utilisateur pour exécuter le service d’agent sur les machines virtuelles.

Pour les utilisateurs du domaine, spécifiez les valeurs en tant que domain\username ou username@domain.com. Pour les utilisateurs locaux, spécifiez username.

Il est supposé que le même utilisateur de domaine ou un utilisateur local portant le même nom, respectivement, est présent sur toutes les machines virtuelles du groupe de ressources.


password - Mot de passe
string. facultatif. Utilisez quand enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

Mot de passe de l’utilisateur pour exécuter le service agent sur les machines virtuelles Windows.

Il est supposé que le mot de passe est le même pour l’utilisateur spécifié sur toutes les machines virtuelles.

Il peut accepter les variables définies dans les pipelines de build ou de mise en production en tant que $(passwordVariable). Vous pouvez marquer la variable comme secret pour la sécuriser.

Pour les machines virtuelles Linux, un mot de passe n’est pas requis et sera ignoré.


outputVariable - Détails de la machine virtuelle pour WinRM
string. facultatif. Utilisez quand enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group.

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.


deploymentName - Nom du déploiement
string. facultatif. Utilisez quand action = Create Or Update Resource Group.

Spécifie le nom du déploiement du groupe de ressources à créer.


deploymentOutputs - Sorties de déploiement
string. facultatif. Utilisez quand action = Create Or Update Resource Group.

Fournit un nom pour la variable de sortie, qui contient la section sorties de l’objet de déploiement actuel au format chaîne. Utilisez l’applet ConvertFrom-Json de commande PowerShell pour analyser l’objet JSON et accéder aux valeurs de sortie individuelles.


addSpnToEnvironment - Accéder aux détails du principal de service dans les paramètres de remplacement
boolean. facultatif. Utilisez quand action = Create Or Update Resource Group. Valeur par défaut : false.

Ajoute l’ID de principal de service et la clé du point de terminaison Azure choisi pour être l’environnement d’exécution du script. Les variables $servicePrincipalId et $servicePrincipalKey peuvent se trouver dans des paramètres de remplacement, tels que -key $servicePrincipalKey.


useWithoutJSON - Utilisez des valeurs de sortie individuelles sans JSON. Stringify appliqué
boolean. facultatif. Utilisez quand action = Create Or Update Resource Group. Valeur par défaut : false.

Les valeurs de sortie individuelles sont converties via JSON. Stringify par défaut. Si vous souhaitez utiliser les valeurs de sortie telles qu’elles sont sans les convertir via JSON. Stringify, activez cette option. Pour plus d’informations, reportez-vous à ceci.


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.

Notes

Une nouvelle version de cette tâche est disponible dans AzureResourceManagerTemplateDeployment@3 - Tâche de déploiement de modèle ARM v3.

Nouveautés de la tâche version 2

  • Fonctionne avec des agents multiplateformes (Linux, macOS ou Windows)
  • Prend en charge les JSON de modèle situés dans n’importe quelle URL http/https accessible publiquement.
  • Expérience utilisateur améliorée pour les paramètres de remplacement qui peuvent désormais être consultés/modifiés dans une grille.
  • Mappage de règles NAT pour les machines virtuelles qui sont sauvegardées par un équilibreur de charge.
  • Le champ « Groupe de ressources » est maintenant renommé « Détails de la machine virtuelle pour WinRM » et est inclus dans la section « Options de déploiement avancées pour les machines virtuelles ».
  • Limites :
    • Aucune prise en charge des abonnements Classiques. Seuls les abonnements ARM sont pris en charge.
    • Aucune prise en charge de la syntaxe PowerShell, car la tâche est désormais basée node.js. Vérifiez que le respect de la casse des noms de paramètres correspond lorsque vous remplacez les paramètres du modèle. Supprimez également les applets de commande PowerShell telles que « ConvertTo-SecureString » lorsque vous migrez de la version 1.0 vers la version 2.0.

Dépannage

Erreur : Erreur de serveur interne

Ces problèmes sont pour la plupart de nature temporaire. Cette situation peut se produire pour plusieurs raisons :

  • L’un des services Azure que vous essayez de déployer est en cours de maintenance dans la région où vous tentez de le déployer. Gardez un œil sur https://status.azure.com/ pour vérifier les temps d'arrêt des services Azure.
  • Le service Azure Pipelines est en cours de maintenance. Gardez un œil sur les temps d’arrêt indiqués sur le site https://status.dev.azure.com/.

Toutefois, dans certains cas, le problème est dû à une erreur dans le modèle ARM. Par exemple, le service Azure que vous essayez de déployer peut ne pas prendre en charge la région que vous avez choisie pour la ressource.

Erreur : Délai d’attente

Les problèmes d’expiration du délai d’attente peuvent provenir de deux endroits :

  • Agent Azure Pipelines
  • Déploiement du portail

Pour savoir si l’expiration du délai d’attente provient du portail, recherchez le lien de déploiement du portail dans les journaux des tâches. Si vous ne voyez aucun lien, le problème est probablement causé par l’agent Azure Pipelines. Si vous voyez un lien, suivez-le pour voir si une expiration du délai d’attente s’est produite dans le déploiement du portail.

Erreur : les règles CORS à activer lors de la substitution des paramètres

Si le fichier de modèle est référencé à partir d’un objet blob, vous pouvez obtenir le message d’avertissement suivant lors de la substitution de paramètres dans le pipeline :

Warning: Failed to download the file from template path.

Cette fonctionnalité nécessite l’activation des règles CORS à la source. Si les modèles se trouvent dans un objet blob de stockage Azure, consultez Prise en charge du partage des ressources cross-origin pour activer CORS.

Outre l’activation de CORS, vérifiez que le jeton SAS spécifié dans le lien du modèle est « srt-sco ». Ce jeton est nécessaire pour télécharger le fichier et continuer.

Agent Azure Pipelines

Si le problème provient de l’agent Azure Pipelines, vous pouvez augmenter le délai d’attente en définissant timeoutInMinutes comme clé dans le YAML sur 0. Pour plus d’informations, consultez Spécifier des travaux dans votre pipeline.

Déploiement du portail

Consultez ce document sur la façon d’identifier si l’erreur provient du portail Azure : Affichez l’historique du déploiement avec Azure Resource Manager.

En cas de déploiement du portail, essayez de définir « timeoutInMinutes » dans le modèle ARM sur « 0 ». Si aucune valeur n’est spécifiée, une valeur de 60 minutes est utilisée. 0 permet de s'assurer que le déploiement se poursuivra aussi longtemps que possible pour réussir.

Cela peut également se produire en raison de problèmes temporaires dans le système. Surveillez https://status.dev.azure.com/ pour vérifier s'il y a un temps d'arrêt dans le service Azure Pipelines.

Erreur : échec de la validation du modèle ARM (Azure Resource Manager)

Ce problème a principalement pour cause un paramètre non valide, comme une référence SKU ou une région non prise en charge, dans le modèle ARM. Si le déploiement échoue, consultez le message d’erreur. Il doit vous diriger vers la ressource et le paramètre non valide.

Ce problème peut également se produire en raison de chaînes multilignes. Actuellement, la tâche de déploiement de groupe de ressources Azure ne prend pas en charge les chaînes multilignes dans un modèle ARM ou un fichier JSON de paramètres.

En outre, reportez-vous à cet article concernant la structure et la syntaxe des modèles ARM : Comprendre la structure et la syntaxe des modèles ARM.

Configuration requise

Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent, DeploymentGroup
Demandes None
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes Quelconque
Variables settables Quelconque
Version de l’agent 2.119.1 ou version ultérieure
Catégorie de la tâche Déployer