Partager via

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

  • Article

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

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

Syntaxe

# 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 (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). 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 (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). 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 (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Azure Pipelines/TFS service connection. 
    #teamProject: # string. Alias: project. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Team project. 
    #deploymentGroupName: # string. Required when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true. Password. 
    #outputVariable: # string. Optional. Use when (action = Create Or Update Resource Group || action = Select Resource Group) && (enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None). 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 machines virtuelles), Start (Démarrer des machines virtuelles), Stop (Arrêter les machines virtuelles), StopWithDeallocate (Arrêter et libérer des machines virtuelles), Restart (Redémarrer des 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. Obligatoire 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. Obligatoire 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 l’URL du fichier.


csmFileLink - lien modèle
string. Obligatoire 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é) vers un compte de stockage et générer un jeton SAS, utilisez la tâche de copie de fichier Azure ou suivez les étapes à l’aide de PowerShell ou Azure CLI.

Pour afficher les paramètres du modèle dans une grille, cliquez sur ... en regard de la zone de texte des paramètres de modèle de remplacement. Cette fonctionnalité nécessite que les règles CORS soient activées sur la source. Si les modèles se trouvent dans un objet blob de stockage Azure, consultez Présentation des requêtes CORS pour activer CORS.


lien des paramètres de modèle csmParametersFileLink -
string. Optionnel. 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 tâche de copie de fichiers Azure ou suivre les étapes à l’aide de PowerShell ou azure CLI.

Pour afficher les paramètres du modèle dans une grille, cliquez sur ... en regard de la zone de texte des paramètres de modèle de remplacement. Cette fonctionnalité nécessite que les règles CORS soient activées sur la source. Si les modèles se trouvent dans un objet blob de stockage Azure, consultez Présentation des requêtes CORS pour activer CORS.


de modèle csmFile -
string. Obligatoire 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 modèles Azure Resource Manager. Pour commencer immédiatement, utilisez cet exemple de modèle.


paramètres de modèle csmParametersFile -
string. Optionnel. 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 copie de fichiers Azure ou suivez les étapes d'PowerShell ou azure CLI.

Pour afficher les paramètres du modèle dans une grille, cliquez sur ... en regard de la zone de texte des paramètres de modèle de remplacement. Cette fonctionnalité nécessite que les règles CORS soient activées sur la source. Si les modèles se trouvent dans un objet blob de stockage Azure, consultez Présentation des requêtes CORS pour activer CORS.


overrideParameters - remplacer les paramètres de modèle
string. Optionnel. 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 des paramètres de remplacement. Cette fonctionnalité nécessite que les règles CORS soient activées sur 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 a 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 déploiement
string. Obligatoire lorsque action = Create Or Update Resource Group. Valeurs autorisées : Incremental, Complete, Validation (Validation uniquement). Valeur par défaut : Incremental.

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

Complete mode supprime les ressources qui ne se trouvent 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’attente ou de passer au mode Incremental.

Avertissement

Le mode complet supprime toutes les ressources existantes dans le 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 aucune ressource nécessaire qui ne sont pas spécifiées dans le modèle.

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

Note

Le mode Validate 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. Optionnel. 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 Deployment Group). 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 sauvegardées 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 de service Azure Pipelines
Alias d’entrée : deploymentGroupEndpoint. string. Obligatoire lorsque (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent.

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

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


teamServicesConnection - connexion de service Azure Pipelines/TFS
Alias d’entrée : deploymentGroupEndpoint. string. Obligatoire lorsque (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent.

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

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


teamProject - projet d’équipe
Alias d’entrée : project. string. Obligatoire lorsque (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent.

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


deploymentGroupName - groupe de déploiement
string. Obligatoire lorsque (action = Create Or Update Resource Group || action = Select Resource Group) && enableDeploymentPrerequisites = ConfigureVMWithDGAgent.

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


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

Choisit si les balises 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 suivant : Key: Value. Exemple : une balise Azure Role : Web serait copiée as-is sur la machine de l’agent.

En savoir plus sur à l’aide de balises pour les ressources Azure.


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

Exécute le service d’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 est NT AUTHORITY\\SYSTEM dans Windows et root dans Linux.


userName - nom d’utilisateur
string. Obligatoire lorsque enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true.

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

Pour les utilisateurs de domaine, spécifiez des 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. Optionnel. Utilisez quand enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true.

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 comme $(passwordVariable). Vous pouvez marquer la variable comme secret pour la sécuriser.

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


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

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, pour le déploiement d’applications.

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


deploymentName - nom de déploiement
string. Optionnel. Utilisez quand action = Create Or Update Resource Group.

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


sorties de déploiement deploymentOutputs -
string. Optionnel. 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 de commande PowerShell ConvertFrom-Json pour analyser l’objet JSON et accéder aux valeurs de sortie individuelles.


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

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


useWithoutJSON - Utiliser des valeurs de sortie individuelles sans JSON. Stringify appliqué
boolean. Optionnel. 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 comme c’est le cas sans les convertir via JSON. Stringify, activez cette option. Pour plus d’informations, consultez cette.


Options de contrôle de tâche

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

Variables de sortie

Aucun.

Remarques

Il existe une nouvelle version de cette tâche disponible à AzureResourceManagerTemplateDeployment@3 - Tâche de déploiement de modèle ARM v3.

Nouveautés de la tâche 2

  • Fonctionne avec des agents multiplateformes (Linux, macOS ou Windows)
  • Prend en charge les JSON de modèle situés sur 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 désormais 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 ».
  • Limitations:
    • 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 node.js basée. Vérifiez que la sensibilité 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 comme « ConvertTo-SecureString » lorsque vous migrez de la version 1.0 vers la version 2.0.

Dépannage

Erreur : Erreur interne du serveur

Ces problèmes sont principalement temporaires par nature. Il existe plusieurs raisons pour lesquelles cela pourrait se produire :

  • L’un des services Azure que vous essayez de déployer est en cours de maintenance dans la région vers laquelle vous essayez de 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 lui-même passe par la maintenance. Gardez un œil sur les https://status.dev.azure.com/ pour les temps d’arrêt.

Toutefois, nous avons vu certaines instances où cela est dû à une erreur dans le modèle ARM, comme le service Azure que vous essayez de déployer ne prend pas en charge la région que vous avez choisie pour la ressource.

Erreur : délai d’expiration

Les problèmes de délai d’expiration peuvent provenir de deux emplacements :

  • Azure Pipelines Agent
  • Déploiement du portail

Vous pouvez identifier si le délai d’attente provient du portail, en recherchant le lien de déploiement du portail qui se trouve dans les journaux des tâches. S’il n’existe aucun lien, cela est probablement dû à l’agent Azure Pipelines. S’il existe un lien, suivez le lien pour voir s’il existe un délai d’expiration qui s’est produit 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, tout en remplaçant les paramètres dans le pipeline, le message d’avertissement suivant peut s’afficher :

Warning: Failed to download the file from template path.

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

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

Azure Pipelines Agent

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

Déploiement du portail

Consultez ce document sur la façon d’identifier si l’erreur provient du portail Azure : Afficher 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 elle n’est pas spécifiée, la valeur supposée est de 60 minutes. 0 garantit que le déploiement s’exécutera tant qu’il peut réussir.

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

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

Ce problème se produit principalement en raison d’un paramètre non valide dans le modèle ARM, tel qu’une référence SKU ou une région non prise en charge. Si la validation échoue, vérifiez le message d’erreur. Il doit vous pointer vers la ressource et le paramètre qui n’est pas 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ètre.

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.

Exigences

Exigence Description
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, DeploymentGroup
demandes Aucun
fonctionnalités de Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande Quelconque
variables settables Quelconque
Version de l’agent 2.119.1 ou version ultérieure
Catégorie de tâche Déployer