Un bouton de déploiement permet de déployer des modèles distants
Cet article explique l’utilisation du bouton Déployer sur Azure pour déployer des modèles ARM JSON distants à partir d’un référentiel GitHub ou d’un compte de stockage Azure. Vous pouvez ajouter le bouton directement au fichier README.md dans votre référentiel GitHub. Vous pouvez également ajouter le bouton à une page web faisant référence au dépôt. Cette méthode ne prend pas en charge le déploiement de fichiers Bicep distants.
L’étendue du déploiement est déterminée par le schéma du modèle. Pour plus d'informations, consultez les pages suivantes :
Autorisations requises
Pour déployer un fichier Bicep ou un modèle ARM, vous devez disposer d’un accès en écriture aux ressources que vous déployez et un accès à toutes les opérations sur le type de ressource Microsoft.Resources/deployments. Par exemple, pour déployer une machine virtuelle, vous avez besoin des autorisations Microsoft.Compute/virtualMachines/write et Microsoft.Resources/deployments/*. L’opération de simulation présente les mêmes exigences d’autorisation.
Pour obtenir la liste des rôles et autorisations, consultez Rôles intégrés Azure.
Utiliser une image courante
Pour ajouter le bouton à votre page web ou à votre référentiel, utilisez l’image suivante :
<img src="https://aka.ms/deploytoazurebutton"/>
L’image apparaît comme suit :
Créer une URL pour le déploiement du modèle
Cette section montre la procédure d’obtention des URL pour les modèles stockés dans GitHub et dans le compte de stockage Azure, et comment mettre en forme les URL.
Modèle stocké dans GitHub
Pour créer l’URL de votre modèle, commencez par l’URL brute du modèle dans votre référentiel GitHub. Pour afficher l’URL brute, sélectionnez Brute.
Le format de l’URL est le suivant :
https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json
Notes
Pour déployer un modèle ou référencer un modèle lié qui est stocké dans un référentiel GitHub privé, consultez une solution personnalisée documentée dans Création d’une offre personnalisée et sécurisée de portail Azure. Il est possible de créer une fonction Azure qui extrait le jeton GitHub d’Azure Key Vault.
Si vous utilisez Git avec Azure Repos au lieu d’un référentiel GitHub, vous pouvez toujours utiliser le bouton Déployer dans Azure. Assurez-vous que votre référentiel est public. Utilisez l’opération Items pour récupérer le modèle. Votre requête doit respecter le format suivant :
https://dev.azure.com/{organization-name}/{project-name}/_apis/git/repositories/{repository-name}/items?scopePath={url-encoded-path}&api-version=6.0
Modèle stocké dans le compte de stockage Azure
Le format des URL pour les modèles stockés dans un conteneur public est le suivant :
https://{storage-account-name}.blob.core.windows.net/{container-name}/{template-file-name}
Par exemple :
https://demostorage0215.blob.core.windows.net/democontainer/azuredeploy.json
Vous pouvez sécuriser le modèle avec un jeton SAP. Pour plus d’informations, consultez Déployer un modèle privé ARM avec un jeton SAP. L’URL suivante est un exemple de jeton SAP :
https://demostorage0215.blob.core.windows.net/privatecontainer/azuredeploy.json?sv=2019-07-07&sr=b&sig=rnI8%2FvKoCHmvmP7XvfspfyzdHjtN4GPsSqB8qMI9FAo%3D&se=2022-02-16T17%3A47%3A46Z&sp=r
Mettre en forme l’URL
Une fois que vous disposez de l’URL, vous devez convertir l’URL en une valeur encodée URL. Vous pouvez utiliser un encodeur en ligne ou exécuter une commande. L’exemple PowerShell suivant montre comment encoder une valeur par URL.
$url = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json"
[uri]::EscapeDataString($url)
L’exemple d’URL a la valeur suivante lorsque l’URL est encodée.
https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json
Chaque lien commence par la même URL de base :
https://portal.azure.com/#create/Microsoft.Template/uri/
Ajoutez votre lien de modèle encodé par URL à la fin de l’URL de base.
https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json
Vous avez votre URL complète pour le lien.
Créer le bouton Déployer dans Azure
Enfin, mettez le lien et l’image ensemble.
Pour ajouter le bouton dans le fichier README.md de votre référentiel GitHub ou d’une page web en utilisant Markdown, utilisez :
[](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json)
Pour le langage HTML, utilisez :
<a href="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json" target="_blank">
<img src="https://aka.ms/deploytoazurebutton"/>
</a>
Pour Git avec Azure Repos, le bouton se présente au format suivant :
[](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fdev.azure.com%2Forgname%2Fprojectname%2F_apis%2Fgit%2Frepositories%2Freponame%2Fitems%3FscopePath%3D%2freponame%2fazuredeploy.json%26api-version%3D6.0)
Déployer le modèle
Pour tester la solution complète, sélectionnez le bouton suivant :
Le portail affiche un volet qui vous permet de fournir facilement des valeurs de paramètre. Les paramètres sont préremplis avec les valeurs par défaut du modèle. Le nom de paramètre en casse mixte storageAccountType défini dans le modèle est converti en une chaîne séparée par des espaces lorsqu’il est affiché sur le portail.
Étapes suivantes
- Pour en savoir plus sur les modèles, voir Comprendre la structure et la syntaxe des modèles ARM.