Criar e implantar aplicativo de VM

O aplicativo VM é um tipo de recurso na Galeria de Computação do Azure que simplifica o gerenciamento, o compartilhamento e a distribuição global de aplicativos para suas máquinas virtuais. Saiba mais sobre o aplicativo de VM

Pré-requisitos

1. Crie a Galeria de Computação do Azure para armazenar e compartilhar recursos de aplicativos.
2. Carregue seu aplicativo em um contêiner em uma conta de armazenamento do Azure. Seu aplicativo pode ser armazenado em um blob de páginas ou bloco. Se você optar por usar um blob de páginas, precisará alinhar os arquivos antes de carregá-los. Use o exemplo a seguir para alinhar por byte seu arquivo.

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

Verifique se a conta de armazenamento tem acesso em nível público ou use um URI SAS com privilégio de leitura, pois outros níveis de restrição falham nas implantações. Você pode usar Gerenciador de Armazenamento para criar rapidamente um URI de SAS se ainda não tiver um.

Se estiver usando o PowerShell, precisará usar a versão 3.11.0 do módulo Az.Storage.

Para saber mais sobre o mecanismo de instalação, consulte o interpretador de comando.

Criar o aplicativo de VM

Portal

1. Vá até o portal do Azure, pesquise por Galeria de Computação do Azure e selecione essa opção.
2. Selecione a galeria que você deseja usar a partir da lista.
3. Na página da galeria, selecione Adicionar na parte superior da página e, em seguida, selecione definição de aplicativo da VM na lista suspensa. A página Criar uma definição de aplicativo de VM é aberta.
4. Na guia Noções Básicas, insira um nome para seu aplicativo e escolha se o aplicativo é para VMs que executam o Linux ou o Windows.
5. Selecione a guia Opções de publicação se quiser especificar qualquer uma das seguintes configurações opcionais para a definição do aplicativo VM:
   • Uma descrição da definição do aplicativo de VM.
   • Data de fim da vida útil
   • Link para um EULA (Contrato de Licença de Usuário Final)
   • URI de uma declaração de privacidade
   • URI para notas de versão
6. Quando terminar, selecione Review + create.
7. Depois que a validação for concluída, selecione Criar para que a definição seja implantada.
8. Após a conclusão da implantação, selecione Ir para o recurso.
9. Na página do aplicativo, selecione Criar uma versão de aplicativo da VM. A página Criar uma Versão do Aplicativo de VM é aberta.
10. Insira um número de versão, como 1.0.0.
11. Selecione a região em que os pacotes de aplicativos são carregados.
12. Em Pacote de Aplicativo de origem,selecione Procurar. Selecione a conta de armazenamento e, em seguida, o contêiner em que seu pacote está localizado. Selecione o pacote na lista e selecione Selecionar quando terminar. Como alternativa, você pode colar o URI SAS neste campo, se preferir.
13. Forneça o 'Script de instalação'. Você também pode fornecer o 'Script de desinstalação' e o 'Script de atualização'. Consulte a Visão geral para obter informações sobre como criar os scripts.
14. Se você tiver um arquivo de configuração padrão carregado em uma conta de armazenamento, poderá selecioná-lo em Configuração padrão.
15. Selecione Excluir a partir do mais recente se não quiser que essa versão apareça como a versão mais recente ao criar uma VM.
16. Para Data de fim da vida útil, escolha uma data no futuro para acompanhar quando essa versão deverá ser desativada. Ela não é excluída nem removida automaticamente, é apenas para seu próprio acompanhamento.
17. Para replicar essa versão para outras regiões, selecione a guia Replicação , adicione mais regiões e faça alterações no número de réplicas por região. A região original em que sua versão foi criada deve estar na lista e não pode ser removida.
18. Quando terminar de fazer as alterações, clique em Revisar + Criar na parte inferior da página.
19. Quando a validação aparecer como aprovada, selecione Criar para implantar a versão de aplicativo da VM.

PowerShell

Crie a definição de aplicativo de VM usando New-AzGalleryApplication. Neste exemplo, estamos criando um aplicativo Linux chamado myApp na MyGallery Azure Compute Gallery e no grupo de recursos myGallery . Substitua os valores de variáveis conforme necessário.

$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

Crie uma versão do aplicativo de VM usando New-AzGalleryApplicationVersion. Caracteres permitidos para a versão da imagem são números e pontos. Os números devem estar dentro do intervalo de um inteiro de 32 bits. Formato: MajorVersion.MinorVersion.Patch.

Nesse exemplo, estamos criando o número de versão 1.0.0. Substitua os valores das variáveis conforme necessário.

$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

O aplicativo de VM exige a CLI do Azure versão 2.30.0 ou posterior.

Crie a definição de aplicativo de VM usando 'az sig gallery-application create'. Neste exemplo, estamos criando uma definição de aplicativo de VM chamada myApp para VMs baseadas em Linux.

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

Crie uma versão do aplicativo VM usando 'az sig gallery-application version create'. Caracteres permitidos para a versão da imagem são números e pontos. Os números devem estar dentro do intervalo de um inteiro de 32 bits. Formato: MajorVersion.MinorVersion.Patch.

Substitua os valores dos parâmetros pelos seus próprios.

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

Criar a definição de aplicativo de VM usando a "API criar aplicativo da galeria"

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

Nome do campo	Descrição	Limitações
nome	Um nome exclusivo para o aplicativo de máquina virtual na galeria.	Comprimento máximo de 117 caracteres. Os caracteres permitidos são letras maiúsculas ou minúsculas, dígitos, hífen (-), ponto final (.), sublinhado (_). Nomes sem permissão para terminar com o ponto final(.).
tipo de SO suportado	Defina o tipo de sistema operacional com suporte.	"Windows" ou "Linux"
endOfLifeDate	Uma próxima data de vida para o aplicativo. A data é somente para referência e não é imposta.	Data futura válida
descrição	Opcional. Descrição do aplicativo.
Eula	Opcional. Referência ao EULA (Contrato de Licença End-User).
privacyStatementUri	Opcional. Referência à política de privacidade do aplicativo.
releaseNoteUri	Opcional. Referência às notas de versão do aplicativo.

Crie uma versão de aplicativo de VM usando a "API criar versão do aplicativo da galeria".

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

Nome do campo	Descrição	Limitações
local	Local de origem para a versão do aplicativo de VM.	Região do Azure válida
mediaLink	A URL que contém o pacote de versão do aplicativo.	URL de armazenamento válida e existente
defaultConfigurationLink	Opcional. A URL que contém a configuração padrão, que pode ser substituída no momento da implantação.	URL de armazenamento válida e existente
Instalar	O comando para instalar o aplicativo.	Comando válido para o sistema operacional fornecido
Remover	O comando para remover o aplicativo.	Comando válido para o sistema operacional fornecido
Atualizar	Opcional. O comando para atualizar o aplicativo. Se não for especificado e uma atualização for necessária, a versão antiga será removida e a nova será instalada.	Comando válido para o sistema operacional fornecido
targetRegions/name	O nome de uma região para a qual replicar.	Validar a região do Azure
targetRegions/regionalReplicaCount	Opcional. O número de réplicas na região a ser criado. O valor padrão é 1.	Um inteiro entre 1 e 3, inclusive
contagem de réplicas	Opcional. Define o número de réplicas em cada região. Entrará em vigor se regionalReplicaCount não estiver definido.	Um inteiro entre 1 e 3, inclusive
endOfLifeDate	Uma data de fim de vida futura para a versão do aplicativo. Essa propriedade é somente para referência do cliente e não é imposta.	Data futura válida
tipo de conta de armazenamento	Opcional. Tipo de conta de armazenamento a ser usada em cada região para armazenar o pacote de aplicativos. O padrão é Standard_LRS.	Essa propriedade não é atualizável.
allowDeletionOfReplicatedLocations	Opcional. Indica se a remoção ou não dessa Versão da Imagem da Galeria de regiões replicadas é permitida.
settings/scriptBehaviorAfterReboot	Opcional. A ação a ser tomada para instalar, atualizar ou remover o aplicativo da galeria após a reinicialização da VM.
settings/configFileName	Opcional. O nome para atribuir o arquivo de pacote baixado na VM. Se não for especificado, o arquivo de pacote será nomeado da mesma forma que o nome do Aplicativo da Galeria.	Isso é limitado a 4.096 caracteres.
settings/packageFileName	Opcional. O nome para atribuir o arquivo de configuração baixado na VM. Se não for especificado, o arquivo de configuração será nomeado como o nome do Aplicativo da Galeria acrescentado com '_config'.	Isso é limitado a 4.096 caracteres.

Implantar os Aplicativos de VM

Portal

Agora você pode criar uma VM e implantar o aplicativo de VM nela usando o portal. Basta criar a VM como de costume, e na guia Avançado, escolha Selecionar um aplicativo de VM para instalar.

Selecione o aplicativo de VM na lista e, em seguida, selecione Salvar na parte inferior da página.

Se você tiver mais de um aplicativo de VM para instalar, poderá definir a ordem de instalação para cada aplicativo de VM novamente na guia Avançado.

Você também pode implantar o aplicativo de VM em VMs atualmente em execução. Ao exibir os detalhes da VM no portal, selecione a opção Extensões + aplicativos em Configurações no menu esquerdo.

Escolha Aplicativos de VM e, em seguida, selecione Adicionar aplicativo para adicionar seu aplicativo de VM.

Selecione o aplicativo de VM na lista e, em seguida, selecione Salvar na parte inferior da página.

CLI

Defina um aplicativo de VM para uma VM existente usando 'az vm application set' e substitua os valores dos parâmetros por seus próprios.

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 configurar vários aplicativos em uma VM:

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 adicionar um aplicativo a um Conjunto de Dimensionamento de Máquinas Virtuais, 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 adicionar vários aplicativos a um Conjunto de Dimensionamento de Máquinas Virtuais:

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 adicionar o aplicativo a uma VM existente, obtenha a versão do aplicativo e use-a para obter a ID da versão do aplicativo da VM. Use a ID para adicionar o aplicativo à configuração da VM.

$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 adicionar o aplicativo a um Conjunto de Dimensionamento de Máquinas Virtuais:

$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 adicionar uma versão de aplicativo de VM a uma VM, execute um PUT na VM.

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 o aplicativo de VM a um conjunto de dimensionamento 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}"
}

Nome do campo	Descrição	Limitações
ordem	Opcional. A ordem na qual os aplicativos devem ser implantados.	Validar inteiro
ID de referência do pacote	Uma referência à versão do aplicativo da galeria. Use a palavra-chave "mais recente" para a versão para instalar automaticamente a versão mais recente disponível.	Referência de versão do aplicativo válida
configurationReference	Opcional. A URL completa de um blob de armazenamento que contém a configuração para essa implantação. Isso substitui qualquer valor fornecido para defaultConfiguration anteriormente.	Referência de blob de armazenamento válida
treatFailureAsDeploymentFailure	Opcional. Quando habilitada, a falha na implantação do aplicativo faz com que o status de provisionamento de VM relate o status de falha.	Verdadeiro ou Falso

O campo order pode ser usado para especificar dependências entre aplicativos. As regras de ordem são as seguintes:

Caixa	Instalar Significado	Significado da falha
Nenhuma ordem especificada	Aplicativos não ordenados são instalados após aplicativos ordenados. Não há garantia de ordem de instalação entre os aplicativos não ordenados.	Falhas de instalação de outros aplicativos, seja ordenadas ou não ordenadas, não afetam a instalação de aplicativos não ordenados.
Valores de ordem duplicada	O aplicativo é instalado em qualquer ordem em comparação com outros aplicativos com a mesma ordem. Todos os aplicativos da mesma ordem são instalados após aqueles com ordens mais baixas e antes daqueles com ordens mais altas.	Se um aplicativo anterior com uma ordem inferior não tiver sido instalado, nenhum aplicativo com essa ordem será instalado. Se algum aplicativo com essa ordem não for instalado, nenhum aplicativo com uma ordem superior será instalado.
Aumento de pedidos	O aplicativo será instalado após os pedidos mais baixos e antes dos pedidos mais altos.	Se um aplicativo anterior com uma ordem inferior não tiver sido instalado, esse aplicativo não será instalado. Se esse aplicativo não for instalado, nenhum aplicativo com uma ordem superior será instalado.

A resposta inclui o modelo de VM completo. A seguir estão as partes relevantes.

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

Monitorar os aplicativos de VM implantados

Portal

Para mostrar o status do aplicativo de VM, acesse a guia Extensões + aplicativos/configurações e verifique o status da VMAppExtension:

Para mostrar o status do aplicativo VM em um conjunto de dimensionamento de máquinas virtuais, vá para a página "Conjuntos de Dimensionamento de Máquinas Virtuais" no portal do Azure. Em seguida, acesse a seção Instâncias, selecione um dos conjuntos de dimensionamento listados e vá para VMAppExtension:

CLI

Para verificar o status da implantação do aplicativo em uma VM, use 'az vm get-instance-view':

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

Para verificar o status da implantação do aplicativo no Conjunto de Dimensionamento de Máquinas Virtuais, 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']"

Observação

O comando de status de implantação anterior dos Conjuntos de Dimensionamento de Máquinas Virtuais não lista a ID da instância com o resultado. Para mostrar a ID da instância com o status da extensão em cada instância, mais scripts são necessários. Consulte o exemplo da CLI a seguir que contém a sintaxe do 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

Verifique se o aplicativo foi bem-sucedido:

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

Para verificar em seu Conjunto de Dimensionamento de Máquinas Virtuais:

$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

Se o aplicativo de VM não estiver instalado na VM, o valor estará vazio.

Para obter o resultado da exibição de instância de VM:

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

O resultado será semelhante a este:

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

O status do aplicativo de VM está na mensagem de status do resultado da extensão de aplicativo de VM no modo de exibição da instância.

Para obter o status do aplicativo no Conjunto de Dimensionamento de Máquinas Virtuais:

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

A saída é semelhante ao exemplo de VM anterior.

Excluir o aplicativo de VM

Para excluir o recurso aplicativo de VM, primeiro você precisa excluir todas as suas versões. A exclusão da versão do aplicativo causa a exclusão do recurso de versão do aplicativo da Galeria de Computação do Azure e de todas as suas réplicas. O blob do aplicativo na Conta de Armazenamento usado para criar a versão do aplicativo não é afetado. Depois de excluir a versão do aplicativo, se qualquer VM estiver usando essa versão, a operação de nova imagem nessas VMs falhará. Use a palavra-chave 'latest' como o número de versão no 'applicationProfile', em vez de fixar o número de versão no código, para corrigir essa falha.
No entanto, se o aplicativo for excluído, a VM falhará durante a operação de nova imagem, pois não há versões disponíveis para instalação do Azure. O perfil da VM precisa ser atualizado para não usar o aplicativo de VM.

PowerShell

Exclua a versão do aplicativo VM:

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

Exclua o aplicativo de VM depois que todas as suas versões forem excluídas:

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

CLI

Exclua a versão do aplicativo VM:

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

Exclua o aplicativo de VM depois que todas as suas versões forem excluídas:

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

REST

Exclua a versão do aplicativo VM:

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

Exclua o aplicativo de VM depois que todas as suas versões forem excluídas:

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

Próximas etapas

Saiba mais sobre aplicativos de VM do Azure.