Creación e implementación de una aplicación de máquina virtual

La aplicación de máquina virtual es un tipo de recurso en Azure Compute Gallery que simplifica la administración, el uso compartido y la distribución global de aplicaciones para las máquinas virtuales. Más información sobre la aplicación de máquina virtual

Prerrequisitos

1. Cree azure Compute Gallery para almacenar y compartir recursos de la aplicación.
2. Cargue la aplicación en un contenedor en una cuenta de Almacenamiento de Azure. La aplicación se puede almacenar en un blob en bloques o un blob en páginas. Si decide usar un blob en páginas, debe alinear los archivos por bytes antes de cargarlos. Use el ejemplo siguiente para alinear el archivo por bytes.

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
    }

CLI

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

Asegúrese de que la cuenta de almacenamiento tiene acceso de nivel público o use un URI de SAS con privilegios de lectura, ya que otros niveles de restricción producen errores en las implementaciones. Puede usar Explorador de Storage para crear rápidamente un URI de SAS si todavía no tiene uno.

Si tiene PowerShell, debe usar la versión 3.11.0 del módulo Az.Storage.

Para más información sobre el mecanismo de instalación, consulte el intérprete de comandos.

Creación de la aplicación de máquina virtual

Portal

1. Vaya a Azure Portal y busque y seleccione Azure Compute Gallery.
2. Seleccione la galería que desea usar en la lista.
3. En la parte superior de la página de la galería, seleccione Agregar y luego VM application definition (Definición de aplicación de máquina virtual) en la lista desplegable. Se abrirá la página Crear una definición de aplicación de máquina virtual.
4. En la pestaña Datos básicos, escriba un nombre para la aplicación y elija si es para máquinas virtuales que ejecutan Linux o Windows.
5. Seleccione la pestaña Opciones de publicación si desea especificar cualquiera de las siguientes opciones opcionales para la definición de la aplicación de máquina virtual:
   • Descripción de la definición de la aplicación de máquina virtual.
   • Fecha final del ciclo de vida
   • Vínculo a un Contrato de licencia de usuario final (CLUF)
   • URI de una declaración de privacidad
   • URI de las notas de la versión
6. Seleccione Revisar y crear cuando haya terminado.
7. Al finalizar la validación, seleccione Crear para implementar la definición.
8. Una vez finalizada la implementación, seleccione Ir al recurso.
9. En la página de la aplicación, seleccione Create a VM application version (Crear una versión de aplicación de máquina virtual). Se abre la página Crear una versión de aplicación de máquina virtual.
10. Escriba un número de versión, por ejemplo, 1.0.0.
11. Seleccione la región donde se cargan los paquetes de aplicación.
12. En Source application package (Paquete de aplicación de origen), seleccione Examinar. Seleccione la cuenta de almacenamiento y luego el contenedor donde se encuentra el paquete. Seleccione el paquete en la lista y luego Seleccionar cuando haya terminado. Como alternativa, puede pegar el identificador URI de SAS en este campo si lo prefiere.
13. Proporcione el "Script de instalación". También puede proporcionar el "Script de desinstalación" y el "Script de actualización". Vea la información general para obtener información sobre cómo crear los scripts.
14. Si tiene un archivo de configuración predeterminado cargado en una cuenta de almacenamiento, puede seleccionarlo en Configuración predeterminada.
15. Seleccione Excluir de las últimas si no quiere que esta versión aparezca como la versión más reciente al crear una máquina virtual.
16. En Fecha final del ciclo de vida, seleccione una fecha futura para realizar un seguimiento de cuándo se debe retirar esta versión. No se elimina ni se quita automáticamente, solo es para su propio seguimiento.
17. Para replicar esta versión en otras regiones, seleccione la pestaña Replicación , agregue más regiones y realice cambios en el número de réplicas por región. La región original donde se ha creado la versión debe estar en la lista y no se puede quitar.
18. Cuando haya terminado de realizar cambios, seleccione Revisar y crear en la parte inferior de la página.
19. Cuando la validación aparezca como correcta, seleccione Crear para implementar la versión de la aplicación de máquina virtual.

PowerShell

Cree la definición de aplicación de máquina virtual mediante New-AzGalleryApplication. En este ejemplo, vamos a crear una aplicación Linux denominada myApp en la Azure Compute Gallery llamada myGallery y en el grupo de recursos myGallery. Reemplace los valores de las variables según sea necesario.

$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

Cree una versión de la aplicación de máquina virtual mediante New-AzGalleryApplicationVersion. Los caracteres permitidos para la versión son números y puntos. Los números deben estar dentro del rango de un entero de 32 bits. Formato: VersiónPrincipal.VersiónSecundaria.Revisión.

En este ejemplo, se crea el número de versión 1.0.0. Reemplace los valores de las variables según sea necesario.

$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" `

CLI

Las aplicaciones de máquina virtual necesitan la versión 2.30.0 o posterior de la CLI de Azure.

Cree la definición de aplicación de máquina virtual mediante "az sig gallery-application create". En este ejemplo se crea una definición de aplicación de máquina virtual denominada myApp para máquinas virtuales basadas en Linux.

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

Cree una versión de aplicación de máquina virtual mediante "az sig gallery-application version create". Los caracteres permitidos para la versión son números y puntos. Los números deben estar dentro del rango de un entero de 32 bits. Formato: VersiónPrincipal.VersiónSecundaria.Revisión.

Reemplace los valores de los parámetros por los suyos propios.

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

Cree la definición de la aplicación de máquina virtual usando la API de creación de aplicaciones de la galería

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"
    }
}

Nombre del campo	Descripción	Limitaciones
nombre	Un nombre único para la aplicación de máquina virtual dentro de la galería.	La longitud máxima es de 117 caracteres. Los caracteres permitidos son letras mayúsculas o minúsculas, números, guiones (-), puntos (.) y guiones bajos (_). No se permite que los nombres finalicen con un punto (.).
supportedOSType	Defina el tipo de sistema operativo admitido.	"Windows" o "Linux"
endOfLifeDate	Fecha de finalización futura de la aplicación. La fecha es solo para referencia y no se aplica.	Fecha futura válida
descripción	Opcional. Descripción de la aplicación.
Cluf	Opcional. Referencia al Contrato de licencia (CLUF) de End-User.
privacyStatementUri	Opcional. Referencia a la declaración de privacidad de la aplicación.
releaseNoteUri	Opcional. Referencia a las notas de la versión de la aplicación.

Cree una versión de aplicación de máquina virtual utilizando la API de creación de versiones de aplicaciones de galería.

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"
      }
   }
}

Nombre del campo	Descripción	Limitaciones
ubicación	Ubicación de origen de la versión de la aplicación de máquina virtual.	Región de Azure válida
mediaLink	Dirección URL que contiene el paquete de versión de la aplicación.	Dirección URL de almacenamiento válida y existente
defaultConfigurationLink	Opcional. Dirección URL que contiene la configuración predeterminada, que se puede invalidar en el momento de la implementación.	Dirección URL de almacenamiento válida y existente
Instalar	Comando para instalar la aplicación.	Comando válido para el sistema operativo indicado
Quitar	Comando para quitar la aplicación.	Comando válido para el sistema operativo indicado
Actualizar	Opcional. Comando para actualizar la aplicación. Si no se especifica y se necesita una actualización, se quita la versión anterior y se instala la nueva.	Comando válido para el sistema operativo indicado
targetRegions/name	Nombre de una región a la que se va a replicar.	Validación de la región de Azure
targetRegions/regionalReplicaCount	Opcional. Número de réplicas de la región que se van a crear. De manera predeterminada, su valor es 1.	Un entero comprendido entre 1 y 3, ambos incluidos
replicaCount	Opcional. Define el número de réplicas en cada región. Surte efecto si regionalReplicaCount no está definido.	Un entero comprendido entre 1 y 3, ambos incluidos
endOfLifeDate	Fecha de finalización futura de la versión de la aplicación. Esta propiedad es solo para referencia de cliente y no se aplica.	Fecha futura válida
storageAccountType	Opcional. Tipo de cuenta de almacenamiento que se va a usar en cada región para almacenar el paquete de aplicación. El valor predeterminado es Standard_LRS.	Esta propiedad no se puede actualizar.
permitirEliminaciónDeUbicacionesReplicadas	Opcional. Indica si se permite quitar o no esta versión de imagen de la galería de regiones replicadas.
configuración/comportamientoDelScriptDespuésDelReinicio	Opcional. Acción que se realizará para instalar, actualizar o quitar la aplicación de la galería después de reiniciar la máquina virtual.
settings/configFileName	Opcional. Nombre para asignar el archivo de paquete descargado en la máquina virtual. Si no se especifica, el archivo de paquete se denomina igual que el nombre de la aplicación de la galería.	Se limita a 4096 caracteres.
settings/packageFileName	Opcional. Nombre para asignar el archivo de configuración descargado en la máquina virtual. Si no se especifica, el archivo de configuración se denomina nombre de la aplicación de la galería anexado con "_config".	Se limita a 4096 caracteres.

Implementación de las aplicaciones de máquina virtual

Portal

Ahora puede crear una máquina virtual e implementar la aplicación de máquina virtual en ella mediante el portal. Simplemente cree la máquina virtual como de costumbre y, en la pestaña Opciones avanzadas, elija Select a VM application to install (Seleccionar una aplicación de máquina virtual para instalar).

Seleccione la aplicación de máquina virtual en la lista y, a continuación, seleccione Guardar en la parte inferior de la página.

Si tiene más de una aplicación de máquina virtual para instalar, puede volver a establecer el orden de instalación de cada aplicación de máquina virtual en la pestaña Opciones avanzadas.

También puede implementar la aplicación de máquina virtual en máquinas virtuales que se están ejecutando actualmente. Seleccione la opción Extensions + applications (Extensiones y aplicaciones) en Configuración en el menú izquierdo al ver los detalles de la máquina virtual en el portal.

Elija Aplicaciones de máquina virtual y, luego, seleccione Agregar aplicación para agregar la aplicación de máquina virtual.

Seleccione la aplicación de máquina virtual en la lista y, a continuación, seleccione Guardar en la parte inferior de la página.

CLI

Establezca una aplicación de máquina virtual en una máquina virtual existente mediante "az vm application set" y reemplace los valores de los parámetros por los suyos propios.

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

Para establecer varias aplicaciones en una máquina virtual:

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

Para agregar una aplicación a un conjunto de escalado de máquinas virtuales, use "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

Para agregar varias aplicaciones a un conjunto de escalado de máquinas virtuales:

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

Para agregar la aplicación a una máquina virtual existente, obtenga la versión de la aplicación y úsela para obtener el identificador de versión de la aplicación de máquina virtual. Use el identificador para agregar la aplicación a la configuración de la máquina virtual.

$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

Para agregar la aplicación a un conjunto de escalado de máquinas virtuales:

$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

Para agregar una versión de la aplicación de máquina virtual a una máquina virtual, realice una operación PUT en la máquina virtual.

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}"
}

Para aplicar la aplicación de máquina virtual a un conjunto de escalado 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}"
}

Nombre del campo	Descripción	Limitaciones
orden	Opcional. Orden en el que se deben implementar las aplicaciones.	Validación de entero
packageReferenceId	Referencia a la versión de la aplicación de la galería. Use la palabra clave "latest" para la versión para instalar automáticamente la versión más reciente disponible.	Referencia válida de la versión de la aplicación
configurationReference	Opcional. Dirección URL completa de un blob de almacenamiento que contiene la configuración de esta implementación. Esto invalida cualquier valor proporcionado anteriormente para defaultConfiguration.	Referencia válida de blob de almacenamiento
treatFailureAsDeploymentFailure	Opcional. Cuando está habilitada, el error de implementación de la aplicación hace que el estado de aprovisionamiento de la máquina virtual notifique el estado de error.	Verdadero o falso

Se puede usar el campo order para especificar dependencias entre aplicaciones. Las reglas para el orden son las siguientes:

Caso	Significado de instalación	Significado del error
No se especifica ningún orden	Las aplicaciones sin ordenar se instalan después de las aplicaciones ordenadas. No hay ninguna garantía de orden de instalación entre las aplicaciones no ordenadas.	Los errores de instalación de otras aplicaciones, ya sean ordenadas o sin ordenar, no afectan a la instalación de las aplicaciones sin ordenar.
Valores de orden duplicados	La aplicación se instala en cualquier orden en comparación con otras aplicaciones con el mismo orden. Todas las aplicaciones del mismo pedido se instalan después de las que tienen pedidos inferiores y antes de las que tienen pedidos superiores.	Si no se ha podido instalar una aplicación anterior con un orden inferior, no se instala ninguna aplicación con este orden. Si no se ha podido instalar una aplicación con este orden, no se instala ninguna aplicación con un orden superior.
Órdenes crecientes	La aplicación se instalará después de las que tienen pedidos inferiores y antes de las que tienen pedidos superiores.	Si no se pudo instalar una aplicación anterior con un orden inferior, esta aplicación no se instala. Si no se puede instalar esta aplicación, no se instala ninguna aplicación con un orden superior.

La respuesta incluye el modelo de máquina virtual completo. A continuación se den los elementos 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=}"
    }
  ]
}

Supervisión de las aplicaciones de máquina virtual implementadas

Portal

Para mostrar el estado de la aplicación de máquina virtual, vaya a la pestaña Extensiones + aplicaciones o la configuración y compruebe el estado de VMAppExtension:

Para mostrar el estado de la aplicación de máquina virtual para el conjunto de escalado, vaya a la página Conjuntos de escalado de máquinas virtuales de Azure Portal y, a continuación, en la sección Instancias, seleccione uno de los conjuntos de escalado enumerados y vaya a VMAppExtension:

CLI

Para comprobar el estado de implementación de la aplicación en una máquina virtual, use "az vm get-instance-view":

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

Para comprobar el estado de implementación de la aplicación en el conjunto de escalado de máquinas virtuales, use "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']"

Nota

El comando anterior de estado de implementación de Virtual Machine Scale Sets no muestra el identificador de instancia con el resultado. Para mostrar el identificador de instancia con el estado de la extensión en cada instancia, se requiere algo más de scripting. Consulte el ejemplo de la CLI siguiente que contiene la sintaxis de 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

Compruebe si la aplicación se ha agregado correctamente:

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

Para comprobar en el conjunto de escalado de máquinas virtuales:

$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 la aplicación de máquina virtual no está instalada en la máquina virtual, el valor está vacío.

Para obtener el resultado de la vista de instancia de máquina virtual:

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

El resultado tiene el aspecto siguiente:

{
    ...
    "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}
        "
                            }
                        ]
        }
    ...
    ]
}

El estado de la aplicación de máquina virtual se encuentra en el mensaje de estado del resultado de la extensión de la aplicación de la máquina virtual en la vista de instancia.

Para obtener el estado de la aplicación en el conjunto de escalado de máquinas virtuales:

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

La salida es similar al ejemplo de máquina virtual anterior.

Eliminación de la aplicación de máquina virtual

Para eliminar el recurso aplicación de máquina virtual, primero debe eliminar todas sus versiones. Al eliminar la versión de la aplicación, se elimina el recurso de versión de la aplicación de Azure Compute Gallery y todas sus réplicas. El blob de aplicación de la cuenta de almacenamiento que se usa para crear la versión de la aplicación no se ve afectado. Después de eliminar la versión de la aplicación, si alguna máquina virtual usa esa versión, se producirá un error en la operación de nueva imagen en esas máquinas virtuales. Use la palabra clave "latest" como número de versión en "applicationProfile" en lugar de codificar de forma rígida el número de versión para solucionar este error.
Sin embargo, si se elimina la aplicación, se produce un error en la máquina virtual durante la operación de nueva imagen, ya que no hay ninguna versión disponible para que Azure se instale. El perfil de máquina virtual debe actualizarse para no usar la aplicación de máquina virtual.

PowerShell

Elimine la versión de la aplicación de máquina virtual:

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

Elimine la aplicación de máquina virtual después de eliminar todas sus versiones:

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

CLI

Elimine la versión de la aplicación de máquina virtual:

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

Elimine la aplicación de máquina virtual después de eliminar todas sus versiones:

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

REST

Elimine la versión de la aplicación de máquina virtual:

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

Elimine la aplicación de máquina virtual después de eliminar todas sus versiones:

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

Pasos siguientes

Obtenga más información sobre las aplicaciones de máquina virtual de Azure.