Créer et déployer une application de machine virtuelle

L’application de machine virtuelle est un type de ressource dans azure Compute Gallery qui simplifie la gestion, le partage et la distribution globale des applications pour vos machines virtuelles. En savoir plus sur l’application de machine virtuelle

Prérequis

1. Créez azure Compute Gallery pour stocker et partager des ressources d’application.
2. Chargez votre application dans un conteneur dans un compte de stockage Azure. Votre application peut être stockée dans un objet blob de blocs ou de pages. Si vous choisissez d’utiliser un objet blob de pages, vous devez aligner les octets des fichiers avant de les charger. Utilisez l’exemple suivant pour aligner votre fichier en octets.

PowerShell

$inputFile = <the file you want to pad>

$fileInfo = Get-Item -Path $inputFile

$remainder = $fileInfo.Length % 512

if ($remainder -ne 0){

    $difference = 512 - $remainder

    $bytesToPad = [System.Byte[]]::CreateInstance([System.Byte], $difference)

    Add-Content -Path $inputFile -Value $bytesToPad -Encoding Byte
    }

INTERFACE DE LIGNE DE COMMANDE

inputFile="<the file you want to pad>"

# Get the file size
fileSize=$(stat -c %s "$inputFile")

# Calculate the remainder when divided by 512
remainder=$((fileSize % 512))

if [ "$remainder" -ne 0 ]; then
    # Calculate how many bytes to pad
    difference=$((512 - remainder))
    
    # Create padding (empty bytes)
    dd if=/dev/zero bs=1 count=$difference >> "$inputFile"
fi

Vérifiez que le compte de stockage dispose d’un accès au niveau public ou utilisez un URI SAP avec des privilèges de lecture, car d’autres niveaux de restriction échouent dans les déploiements. Vous pouvez utiliser l’Explorateur Stockage pour créer rapidement un URI SAS si vous n’en avez pas encore un.

Si vous utilisez PowerShell, vous devez utiliser la version 3.11.0 du module Az.Storage.

Pour en savoir plus sur le mécanisme d’installation, consultez Interpréteur de commandes.

Créer l’application de machine virtuelle

Portail

1. Accédez au portail Azure, puis recherchez et sélectionnez Azure Compute Gallery.
2. Sélectionnez la galerie à utiliser dans la liste.
3. Dans la page de votre galerie, sélectionnez Ajouter en haut de la page, puis Définition d’application VM dans le menu déroulant. La page Créer une définition d’application de machine virtuelle s’ouvre.
4. Sous l’onglet De base, entrez un nom pour votre application et indiquez si l’application est destinée aux machines virtuelles exécutant Linux ou Windows.
5. Sélectionnez l’onglet Options de publication si vous souhaitez spécifier l’un des paramètres facultatifs suivants pour la définition de votre application de machine virtuelle :
   • Description de la définition de l’application de machine virtuelle.
   • Date de fin de vie
   • Lien vers un contrat de licence utilisateur final (CLUF)
   • URI d’une déclaration de confidentialité
   • URI pour des notes de publication
6. Quand vous avez terminé, sélectionnez Vérifier + créer.
7. Une fois la validation terminée, sélectionnez Créer pour déployer la définition.
8. Une fois le déploiement effectué, sélectionnez Accéder à la ressource.
9. Dans la page de l’application, sélectionnez Créer une version d’application VM. La page Créer une version d’application de machine virtuelle s’ouvre.
10. Entrez un numéro de version comme 1.0.0.
11. Sélectionnez la région dans laquelle vos packages d’application sont chargés.
12. Sous Package d’application source, sélectionnez Parcourir. Sélectionnez le compte de stockage, puis le conteneur où se trouve votre package. Sélectionnez le package dans la liste, puis sélectionnez Sélectionner lorsque vous avez terminé. Vous pouvez aussi coller l’URI SAS dans ce champ si vous le souhaitez.
13. Indiquez le « script d’installation ». Vous pouvez également fournir le « script de désinstallation » et le « script de mise à jour ». Pour plus d’informations sur la création de scripts, consultez la Vue d’ensemble.
14. Si vous avez un fichier de configuration par défaut chargé dans un compte de stockage, vous pouvez le sélectionner dans Configuration par défaut.
15. Sélectionnez Exclure de la plus récente si vous ne souhaitez pas que cette version apparaisse comme la dernière version quand vous créez une machine virtuelle.
16. Pour Date de fin de vie, choisissez une date ultérieure pour suivre la mise hors service de cette version. Elle n’est pas supprimée ni effacée automatiquement, c’est juste pour votre propre suivi.
17. Pour répliquer cette version dans d’autres régions, sélectionnez l’onglet Réplication , ajoutez d’autres régions et apportez des modifications au nombre de réplicas par région. La région d’origine où votre version a été créée doit figurer dans la liste et ne peut pas être supprimée.
18. Lorsque vous avez terminé vos changements, sélectionnez Vérifier + créer au bas de la page.
19. Lorsque la validation apparaît comme réussie, sélectionnez Créer pour déployer la version de votre application VM.

PowerShell

Créez la définition de l’application de machine virtuelle à l’aide de New-AzGalleryApplication. Dans cet exemple, nous créons une application Linux nommée myApp dans myGallery Azure Compute Gallery et dans le groupe de ressources myGallery . Remplacez les valeurs des variables en fonction des besoins.

$galleryName = "myGallery"
$rgName = "myResourceGroup"
$applicationName = "myApp"
$description = "Backend Linux application for finance."
New-AzGalleryApplication `
  -ResourceGroupName $rgName `
  -GalleryName $galleryName `
  -Location "East US" `
  -Name $applicationName `
  -SupportedOSType Linux `
  -Description $description

Créez une version de votre application de machine virtuelle à l’aide de New-AzGalleryApplicationVersion. Les caractères autorisés pour la version sont les chiffres et les points. Les nombres doivent être un entier 32 bits. Format : MajorVersion.MinorVersion.Patch.

Dans cet exemple, nous créons le numéro de version 1.0.0. Remplacez les valeurs des variables en fonction des besoins.

$galleryName = "myGallery"
$rgName = "myResourceGroup"
$applicationName = "myApp"
$version = "1.0.0"
New-AzGalleryApplicationVersion `
   -ResourceGroupName $rgName `
   -GalleryName $galleryName `
   -GalleryApplicationName $applicationName `
   -Name $version `
   -PackageFileLink "https://<storage account name>.blob.core.windows.net/<container name>/<filename>" `
   -DefaultConfigFileLink "https://<storage account name>.blob.core.windows.net/<container name>/<filename>" `
   -Location "East US" `
   -Install "mv myApp .\myApp\myApp" `
   -Remove "rm .\myApp\myApp" `

INTERFACE DE LIGNE DE COMMANDE

Les applications VM requièrent Azure CLI version 2.30.0 ou ultérieure.

Créez la définition de l’application de machine virtuelle à l’aide de « az sig gallery-application create ». Dans cet exemple, nous créons une définition d’application de machine virtuelle nommée myApp pour machines virtuelles basées sur Linux.

az sig gallery-application create \
    --application-name myApp \
    --gallery-name myGallery \
    --resource-group myResourceGroup \
    --os-type Linux \
    --location "East US"

Créez une version d’application de machine virtuelle à l’aide de la commande « az sig gallery-application version create ». Les caractères autorisés pour la version sont les chiffres et les points. Les nombres doivent être un entier 32 bits. Format : MajorVersion.MinorVersion.Patch.

Remplacez les valeurs des paramètres par vos propres valeurs.

az sig gallery-application version create \
   --version-name 1.0.0 \
   --application-name myApp \
   --gallery-name myGallery \
   --location "East US" \
   --resource-group myResourceGroup \
   --package-file-link "https://<storage account name>.blob.core.windows.net/<container name>/<filename>" \
   --install-command "mv myApp .\myApp\myApp" \
   --remove-command "rm .\myApp\myApp" \
   --update-command  "mv myApp .\myApp\myApp" \
   --default-configuration-file-link "https://<storage account name>.blob.core.windows.net/<container name>/<filename>"\

REST

Créez la définition de l'application VM à l'aide de l'API « créer une application de galerie »

PUT
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/applications/{applicationName}?api-version=2024-03-03

{
    "location": "West US",
    "name": "myApp",
    "properties": {
        "supportedOSType": "Windows | Linux",
        "endOfLifeDate": "2020-01-01",
	"description": "Description of the App",
	"eula": "Link to End-User License Agreement (EULA)",
	"privacyStatementUri": "Link to privacy statement for the application",
	"releaseNoteUri": "Link to release notes for the application"
    }
}

Nom du champ	Descriptif	Limites
nom	Nom unique de l’application de machine virtuelle dans la galerie.	Longueur maximale de 117 caractères. Les caractères autorisés sont les lettres majuscules ou minuscules, les chiffres, les traits d’union (-), les points (.) et les traits de soulignement (_). Les noms ne peuvent pas se terminer par un point (.).
supportedOSType	Définissez le type de système d’exploitation pris en charge.	« Windows » ou « Linux »
date de fin de vie	Date de fin de vie future de l’application. La date est uniquement pour référence et n’est pas appliquée.	Date future valide
descriptif	facultatif. Description de l’application.
Cluf	facultatif. Référence à l'accord de licence pour utilisateur final (EULA).
uriDéclarationDeConfidentialité	facultatif. Référence à la déclaration de confidentialité de l’application.
releaseNoteUri	facultatif. Référence aux notes de version de l’application.

Créez une version d’application de machine virtuelle à l’aide de l’API « Créer une version d’application de la galerie ».

PUT
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/applications/{applicationName}/versions/{versionName}?api-version=2024-03-03

{
  "location": "$location",
  "properties": {
    "publishingProfile": {
      "source": {
        "mediaLink": "$mediaLink",
        "defaultConfigurationLink": "$configLink"
      },
      "manageActions": {
        "install": "echo installed",
        "remove": "echo removed",
        "update": "echo update"
      },
      "targetRegions": [
        {
          "name": "West US",
          "regionalReplicaCount": 1
        },
	{
	  "name": "East US"
	}
      ]
      "endofLifeDate": "datetime",
      "replicaCount": 1,
      "excludeFromLatest": false,
      "storageAccountType": "PremiumV2_LRS | Premium_LRS | Standard_LRS | Standard_ZRS"
      "safetyProfile": {
	"allowDeletionOfReplicatedLocations": false
      }
      "settings": {
	"scriptBehaviorAfterReboot": "None | Rerun",
	"configFileName": "$appConfigFileName",
	"packageFileName": "$appPackageFileName"
      }
   }
}

Nom du champ	Descriptif	Limites
lieu	Emplacement source de la version de l’application de machine virtuelle.	Région Azure valide
MediaLink	URL contenant le package de version de l’application.	URL de stockage valide et existante
defaultConfigurationLink	facultatif. URL contenant la configuration par défaut, qui peut être remplacée au moment du déploiement.	URL de stockage valide et existante
Installer	Commande permettant d’installer l’application.	Commande valide pour le système d’exploitation donné
Supprimer	Commande permettant de supprimer l’application.	Commande valide pour le système d’exploitation donné
Mise à jour	facultatif. Commande permettant de mettre à jour l’application. Si elle n’est pas spécifiée et qu’une mise à jour est requise, l’ancienne version est supprimée et la nouvelle est installée.	Commande valide pour le système d’exploitation donné
targetRegions/name	Nom d’une région vers laquelle effectuer la réplication.	Valider la région Azure
targetRegions/regionalReplicaCount	facultatif. Nombre de réplicas à créer dans la région. La valeur par défaut est de 1.	Entier compris entre 1 et 3 (inclus)
replicaCount	facultatif. Définit le nombre de répliques dans chaque région. Prend effet si regionalReplicaCount n’est pas défini.	Entier compris entre 1 et 3 (inclus)
date de fin de vie	Date de fin de vie future de la version de l’application. Cette propriété n'est donnée qu'à titre indicatif et n'est pas imposée.	Date future valide
stockageCompteType	facultatif. Type de compte de stockage à utiliser dans chaque région pour stocker le package d’application. Par défaut, Standard_LRS.	Cette propriété n’est pas modifiable.
permettreLaSuppressionDesEmplacementsRépliqués	facultatif. Indique si la suppression ou non de cette version d’image de galerie des régions répliquées est autorisée.
paramètres/comportementDuScriptAprèsRedémarrage	facultatif. Action à entreprendre pour l’installation, la mise à jour ou la suppression de l’application de galerie après le redémarrage de la machine virtuelle.
settings/configFileName	facultatif. Nom à attribuer le fichier de package téléchargé sur la machine virtuelle. S’il n’est pas spécifié, le fichier de package est nommé identique au nom de l’application de la galerie.	Cela est limité à 4 096 caractères.
settings/packageFileName	facultatif. Nom à attribuer le fichier de configuration téléchargé sur la machine virtuelle. S’il n’est pas spécifié, le fichier de configuration est nommé en tant que nom d’application de la galerie ajouté à « _config ».	Cela est limité à 4 096 caractères.

Déployer les applications de machine virtuelle

Portail

Vous pouvez maintenant créer une machine virtuelle et y déployer l’application de machine virtuelle à l’aide du portail. Il vous suffit de créer la machine virtuelle comme d’habitude, puis, sous l’onglet Avancé, de choisir Sélectionner une application de machine virtuelle à installer.

Sélectionnez l’application de machine virtuelle dans la liste, puis sélectionnez Enregistrer en bas de la page.

Si vous avez plusieurs applications de machine virtuelle à installer, vous pouvez définir l’ordre d’installation de chaque application de machine virtuelle sous longlet Avancé.

Vous pouvez également déployer l’application de machine virtuelle sur des machines virtuelles en cours d’exécution. Sélectionnez l’option Extensions + applications sous Paramètres dans le menu de gauche lors de l’affichage des détails de la machine virtuelle dans le portail.

Choisissez Applications de machine virtuelle, puis sélectionnez Ajouter une application pour ajouter votre application de machine virtuelle.

Sélectionnez l’application de machine virtuelle dans la liste, puis sélectionnez Enregistrer en bas de la page.

INTERFACE DE LIGNE DE COMMANDE

Définissez une application de machine virtuelle sur une machine virtuelle existante à l’aide de « az vm application set » et remplacez les valeurs des paramètres par vos propres paramètres.

az vm application set \
	--resource-group myResourceGroup \
	--name myVM \
  	--app-version-ids /subscriptions/{subID}/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/galleries/myGallery/applications/myApp/versions/1.0.0 \
  	--treat-deployment-as-failure true

Pour définir plusieurs applications sur une machine virtuelle :

az vm application set \
	--resource-group myResourceGroup \
	--name myVM \
	--app-version-ids /subscriptions/{subId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/applications/myApp/versions/1.0.0 /subscriptions/{subId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/applications/myApp2/versions/1.0.1 \
	--treat-deployment-as-failure true true

Pour ajouter une application à un ensemble de machines virtuelles, utilisez « az vmss application set » :

az vmss application set \
	--resource-group myResourceGroup \
	--name myVmss \
	--app-version-ids /subscriptions/{subId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/applications/myApp/versions/1.0.0 \
	--treat-deployment-as-failure true

Pour ajouter plusieurs applications à un ensemble de machines virtuelles :

az vmss application set \
	--resource-group myResourceGroup \
	--name myVmss
	--app-version-ids /subscriptions/{subId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/applications/myApp/versions/1.0.0 /subscriptions/{subId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/applications/myApp2/versions/1.0.0 \
	--treat-deployment-as-failure true

PowerShell

Pour ajouter l’application à une machine virtuelle existante, récupérez la version de l’application et utilisez-la pour obtenir l’ID de version de l’application de machine virtuelle. Utilisez l’ID pour ajouter l’application à la configuration de machine virtuelle.

$galleryName = "myGallery"
$rgName = "myResourceGroup"
$applicationName = "myApp"
$version = "1.0.0"
$vmName = "myVM"
$vm = Get-AzVM -ResourceGroupName $rgname -Name $vmName
$appVersion = Get-AzGalleryApplicationVersion `
   -GalleryApplicationName $applicationName `
   -GalleryName $galleryName `
   -Name $version `
   -ResourceGroupName $rgName
$packageId = $appVersion.Id
$app = New-AzVmGalleryApplication -PackageReferenceId $packageId
Add-AzVmGalleryApplication -VM $vm -GalleryApplication $app -TreatFailureAsDeploymentFailure true
Update-AzVM -ResourceGroupName $rgName -VM $vm

Pour ajouter l'application à un ensemble de machines virtuelles :

$vmss = Get-AzVmss -ResourceGroupName $rgname -Name $vmssName
$appVersion = Get-AzGalleryApplicationVersion `
   -GalleryApplicationName $applicationName `
   -GalleryName $galleryName `
   -Name $version `
   -ResourceGroupName $rgName
$packageId = $appVersion.Id
$app = New-AzVmssGalleryApplication -PackageReferenceId $packageId
Add-AzVmssGalleryApplication -VirtualMachineScaleSetVM $vmss.VirtualMachineProfile -GalleryApplication $app
Update-AzVmss -ResourceGroupName $rgName -VirtualMachineScaleSet $vmss -VMScaleSetName $vmssName

REST

Pour ajouter une version d’application de machine virtuelle à une machine virtuelle, effectuez une requête PUT sur la machine virtuelle.

PUT
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VMName}?api-version=2024-03-03

{
  "properties": {
    "applicationProfile": {
      "galleryApplications": [
        {
          "order": 1,
          "packageReferenceId": "/subscriptions/{subscriptionId}/resourceGroups/<resource group>/providers/Microsoft.Compute/galleries/{gallery name}/applications/{application name}/versions/{version | latest}",
          "configurationReference": "{path to configuration storage blob}",
          "treatFailureAsDeploymentFailure": false
        }
      ]
    }
  },
  "name": "{vm name}",
  "id": "/subscriptions/{subscriptionId}/resourceGroups/{resource group}/providers/Microsoft.Compute/virtualMachines/{vm name}",
  "location": "{vm location}"
}

Pour appliquer l’application de machine virtuelle à un groupe identique uniforme :

PUT
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{VMSSName}?api-version=2024-03-03

{
  "properties": {
    "virtualMachineProfile": {
      "applicationProfile": {
        "galleryApplications": [
          {
            "order": 1,
            "packageReferenceId": "/subscriptions/{subscriptionId}/resourceGroups/<resource group>/providers/Microsoft.Compute/galleries/{gallery name}/applications/{application name}/versions/{version | latest}",
            "configurationReference": "{path to configuration storage blob}",
            "treatFailureAsDeploymentFailure": false
          }
        ]
      }
    }
  },
  "name": "{vm name}",
  "id": "/subscriptions/{subscriptionId}/resourceGroups/{resource group}/providers/Microsoft.Compute/virtualMachines/{vm name}",
  "location": "{vm location}"
}

Nom du champ	Descriptif	Limites
commande	facultatif. Ordre dans lequel les applications doivent être déployées.	Valider l’entier
packageReferenceId	Référence à la version de l’application de la galerie. Utilisez le mot clé « latest » pour la version pour installer automatiquement la dernière version disponible.	Référence de version d’application valide
configurationReference	facultatif. URL complète d’un blob de stockage contenant la configuration pour ce déploiement. Cela remplace toute valeur fournie pour defaultConfiguration précédemment.	Référence de blob de stockage valide
treatFailureAsDeploymentFailure	facultatif. Lorsque cette option est activée, l’échec du déploiement de l’application entraîne l’état d’approvisionnement des machines virtuelles à signaler l’état d’échec.	True ou False

Le champ d’ordre peut être utilisé pour spécifier des dépendances entre applications. Les règles de commande sont les suivantes :

Cas	Signification de l’installation	Signification de l’échec
Aucun ordre spécifié	Les applications non ordonnées sont installées après les applications ordonnées. Il n’existe aucune garantie d’ordre d’installation parmi les applications non ordonnées.	Les échecs d’installation d’autres applications, ordonnées ou non, n’affectent pas l’installation des applications non ordonnées.
Valeurs d’ordre en double	L’application est installée dans un ordre quelconque par rapport à d’autres applications ayant le même ordre. Toutes les applications du même ordre sont installées après celles avec des ordres inférieurs et avant celles avec des ordres supérieurs.	Si l’installation d’une application précédente dont l’ordre est inférieur échoue, aucune application de cet ordre ne s’installe. Si l’installation d’une application quelconque de cet ordre échoue, aucune application dont l’ordre est supérieur ne s’installe.
Ordres croissants	L’application est installée après celles avec des commandes inférieures et avant celles avec des commandes supérieures.	Si une application précédente avec un ordre inférieur n’a pas pu être installée, cette application n’est pas installée. Si l’installation de cette application échoue, aucune application d’ordre supérieur ne s’installe.

La réponse inclut le modèle de machine virtuelle complet. Voici les parties pertinentes.

{
  "name": "{vm name}",
  "id": "{vm id}",
  "type": "Microsoft.Compute/virtualMachines",
  "location": "{vm location}",
  "properties": {
    "applicationProfile": {
      "galleryApplications": ""
    },
    "provisioningState": "Updating"
  },
  "resources": [
    {
      "name": "VMAppExtension",
      "id": "{extension id}",
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "location": "centraluseuap",
      "properties": "@{autoUpgradeMinorVersion=True; forceUpdateTag=7c4223fc-f4ea-4179-ada8-c8a85a1399f5; provisioningState=Creating; publisher=Microsoft.CPlat.Core; type=VMApplicationManagerLinux; typeHandlerVersion=1.0; settings=}"
    }
  ]
}

Surveiller les applications de machine virtuelle déployées

Portail

Pour afficher l’état de l’application de machine virtuelle, accédez à l’onglet Extensions + applications/Paramètres et vérifiez l’état de VMAppExtension :

Pour afficher l’état de l’application de machine virtuelle pour l’ensemble de machines virtuelles, accédez à la page Ensembles de machines virtuelles du portail Azure, puis dans la section Instances, sélectionnez l’un des ensembles répertoriés, puis accédez à VMAppExtension :

INTERFACE DE LIGNE DE COMMANDE

Pour vérifier l’état du déploiement de l’application sur une machine virtuelle, utilisez « az vm get-instance-view » :

az vm get-instance-view -g myResourceGroup -n myVM --query "instanceView.extensions[?name == 'VMAppExtension']"

Pour vérifier l’état du déploiement de l’application sur l'ensemble de machines virtuelles à échelle, utilisez la commande « az vmss get-instance-view » :

az vmss get-instance-view --ids (az vmss list-instances -g myResourceGroup -n myVmss --query "[*].id" -o tsv) --query "[*].extensions[?name == 'VMAppExtension']"

Notes

La commande de statut de déploiement des ensembles de machines virtuelles précédente ne répertorie pas l’ID d’instance avec le résultat. Pour afficher l’ID d’instance avec l’état de l’extension dans chaque instance, un autre script est nécessaire. Reportez-vous à l’exemple CLI suivant qui contient la syntaxe PowerShell :

$ids = az vmss list-instances -g myResourceGroup -n myVmss --query "[*].{id: id, instanceId: instanceId}" | ConvertFrom-Json
$ids | Foreach-Object {
    $iid = $_.instanceId
    Write-Output "instanceId: $iid" 
    az vmss get-instance-view --ids $_.id --query "extensions[?name == 'VMAppExtension']" 
}

PowerShell

Vérifiez que l’application a réussi :

$rgName = "myResourceGroup"
$vmName = "myVM"
$result = Get-AzVM -ResourceGroupName $rgName -VMName $vmName -Status
$result.Extensions | Where-Object {$_.Name -eq "VMAppExtension"} | ConvertTo-Json

Pour vérifier l'ensemble de l'échelle de la machine virtuelle :

$rgName = "myResourceGroup"
$vmssName = "myVMss"
$result = Get-AzVmssVM -ResourceGroupName $rgName -VMScaleSetName $vmssName -InstanceView
$resultSummary  = New-Object System.Collections.ArrayList
$result | ForEach-Object {
    $res = @{ instanceId = $_.InstanceId; vmappStatus = $_.InstanceView.Extensions | Where-Object {$_.Name -eq "VMAppExtension"}}
    $resultSummary.Add($res) | Out-Null
}
$resultSummary | ConvertTo-Json -Depth 5

REST

Si l’application de machine virtuelle n’est pas installée sur la machine virtuelle, la valeur est vide.

Pour obtenir le résultat de la vue d’instance de machine virtuelle :

GET
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{VMName}/instanceView?api-version=2024-03-03

Le résultat ressemble à ceci :

{
    ...
    "extensions"  [
    ...
        {
            "name":  "VMAppExtension",
            "type":  "Microsoft.CPlat.Core.VMApplicationManagerLinux",
            "typeHandlerVersion":  "1.0.9",
            "statuses":  [
                            {
                                "code":  "ProvisioningState/succeeded",
                                "level":  "Info",
                                "displayStatus":  "Provisioning succeeded",
                                "message":  "Enable succeeded: {\n \"CurrentState\": [\n  {\n   \"applicationName\": \"doNothingLinux\",\n   \"version\": \"1.0.0\",\n   \"result\": \"Install SUCCESS\"\n  },\n  {
        \n   \"applicationName\": \"badapplinux\",\n   \"version\": \"1.0.0\",\n   \"result\": \"Install FAILED Error executing command \u0027exit 1\u0027: command terminated with exit status=1\"\n  }\n ],\n \"ActionsPerformed\": []\n}
        "
                            }
                        ]
        }
    ...
    ]
}

L’état de l’application de machine virtuelle se trouve dans le message d’état du résultat de l’extension de l’application de machine virtuelle dans la vue de l’instance.

Pour obtenir le statut de l’application sur l’ensemble de machines virtuelles :

GET
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/ virtualMachineScaleSets/{VMSSName}/virtualMachines/{instanceId}/instanceView?api-version=2019-03-01

La sortie est similaire à l’exemple de machine virtuelle précédent.

Supprimer l’application de machine virtuelle

Pour supprimer la ressource Application de machine virtuelle, vous devez d’abord supprimer toutes ses versions. La suppression de la version de l’application entraîne la suppression de la ressource de version de l’application à partir d’Azure Compute Gallery et de tous ses réplicas. Le blob d'application dans le compte de stockage, qui est utilisé pour créer la version de l'application, n'est pas affecté. Après avoir supprimé la version de l’application, si une machine virtuelle utilise cette version, l’opération de réinitialisation sur ces machines virtuelles échoue. Utilisez le mot clé « latest » comme numéro de version dans « applicationProfile » au lieu de coder en dur le numéro de version pour résoudre cet échec.
Toutefois, si l’application est supprimée, la machine virtuelle échoue pendant l’opération de réinitialisation, car aucune version n’est disponible pour Azure à installer. Le profil de machine virtuelle doit être mis à jour pour ne pas utiliser l’application de machine virtuelle.

PowerShell

Supprimez la version de l’application de machine virtuelle :

Remove-AzGalleryApplicationVersion -ResourceGroupName $rgNmae -GalleryName $galleryName -GalleryApplicationName $galleryApplicationName -Name $name

Supprimez l’application de machine virtuelle une fois toutes ses versions supprimées :

Remove-AzGalleryApplication -ResourceGroupName $rgNmae -GalleryName $galleryName -Name $name

INTERFACE DE LIGNE DE COMMANDE

Supprimez la version de l’application de machine virtuelle :

az sig gallery-application version delete --resource-group $rg-name --gallery-name $gallery-name --application-name $app-name --version-name $version-name

Supprimez l’application de machine virtuelle une fois toutes ses versions supprimées :

az sig gallery-application delete --resource-group $rg-name --gallery-name $gallery-name --application-name $app-name

REST

Supprimez la version de l’application de machine virtuelle :

DELETE
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/applications/{galleryApplicationName}/versions/{galleryApplicationVersionName}?api-version=2024-03-03

Supprimez l’application de machine virtuelle une fois toutes ses versions supprimées :

DELETE
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/applications/{galleryApplicationName}?api-version=2024-03-03

Étapes suivantes

En savoir plus sur les applications de machine virtuelle Azure.