Aggiornare automaticamente l'agente Azure Connected Machine

L'agente Azure Connected Machine viene aggiornato regolarmente con correzioni di bug, miglioramenti della stabilità e nuove funzionalità. L'aggiornamento automatico dell'agente consente di mantenere aggiornati i server abilitati per Azure Arc senza che sia necessario distribuire manualmente ogni nuova versione dell'agente.

Quando si abilita l'aggiornamento automatico dell'agente, Microsoft gestisce automaticamente gli aggiornamenti dell'agente Azure Connected Machine. I computer sono programmati per l'aggiornamento alla versione più recente dell'agente. Gli aggiornamenti vengono implementati in batch nelle varie regioni e iniziano durante le ore di minore attività per mantenere la stabilità e ridurre al minimo le interruzioni. Se un aggiornamento non viene completato correttamente, l'agente ritenta periodicamente l'aggiornamento finché non va a buon fine.

L'installazione o l'aggiornamento dell'agente Azure Connected Machine non richiede un riavvio del server. Questa funzionalità è attualmente disponibile solo in Azure cloud pubblico.

Prerequisites

Prima di abilitare l'aggiornamento automatico dell'agente, verificare che i computer soddisfino i requisiti seguenti:

• Tutti i server abilitati per Arc: è necessario l'agente Azure Connected Machine versione 1.67 o successiva.
• Windows: impostare i criteri di esecuzione di PowerShell su RemoteSigned. L'aggiornamento automatico dell'agente non è supportato quando i criteri di esecuzione sono impostati su Restricted.
• Linux: Verificare che il servizio cron sia installato e in esecuzione. Questo servizio è necessario per pianificare ed eseguire aggiornamenti automatici dell'agente.

Abilitare l'aggiornamento automatico dell'agente

È possibile abilitare l'aggiornamento automatico dell'agente quando si connette un nuovo computer a Azure Arc o abilitarlo in un secondo momento per un server abilitato per Arc esistente.

Per abilitare l'aggiornamento automatico dell'agente quando si connette il computer, includere il parametro --enable-automatic-upgrade con azcmagent connect.

azcmagent connect \
--subscription-id "<SUBSCRIPTION_ID>" \
--resource-group "<RESOURCE_GROUP>" \
--location "<LOCATION>" \
--enable-automatic-upgrade

In alternativa, abilitare l'aggiornamento automatico dell'agente durante il processo di onboarding del computer nel portale di Azure seguendo questa procedura:

1. Nel portale di Azure cercare e selezionare Azure Arc.
2. Nel menu del servizio espandere Infrastruttura e quindi selezionare Macchine.
3. Selezionare Onboard/Create e quindi selezionare Eseguire l’onboarding di computer esistenti.
4. Nella scheda Nozioni di base, immettere i dettagli necessari per il server.
5. In Aggiornamento automatico dell'agente selezionare Mantieni aggiornato automaticamente l'agente Azure Connected Machine.
6. Completare i passaggi rimanenti di onboarding, quindi scaricare ed eseguire lo script generato nel server.

Abilitare l'aggiornamento automatico su un server esistente

Per un server abilitato per Arc esistente, abilitare l'aggiornamento automatico dell'agente impostando la enableAutomaticUpgrade proprietà su true. È possibile configurare questa proprietà in diversi modi.

az account set --subscription "<SUBSCRIPTION_ID>"

az rest \
--method PATCH \
--url "https://management.azure.com/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.HybridCompute/machines/<MACHINE_NAME>?api-version=2024-05-20-preview" \
--headers "Content-Type=application/json" \
--body '{"properties":{"agentUpgrade":{"enableAutomaticUpgrade":true}}}'

Set-AzContext -Subscription "<SUBSCRIPTION_ID>"

$params = @{
    ResourceGroupName     = "<RESOURCE_GROUP>"
    ResourceProviderName  = "Microsoft.HybridCompute"
    ResourceType          = "Machines"
    ApiVersion            = "2024-05-20-preview"
    Name                  = "<MACHINE_NAME>"
    Method                = "PATCH"
    Payload               = '{"properties":{"agentUpgrade":{"enableAutomaticUpgrade":true}}}'
}
Invoke-AzRestMethod @params

Verificare lo stato di aggiornamento automatico dell'agente

Dopo aver abilitato l'aggiornamento automatico dell'agente, verificare l'impostazione corrente nella risorsa server abilitata per Arc.

resources
| where type =~ 'microsoft.hybridcompute/machines'
| where properties.agentUpgrade.enableAutomaticUpgrade == true
| project name, resourceGroup, subscriptionId, location, id
| order by name asc

Disabilitare l'aggiornamento automatico dell'agente

Per rifiutare esplicitamente l'aggiornamento automatico dell'agente per un server abilitato per Azure Arc esistente, impostare la proprietà enableAutomaticUpgrade su false.

Bloccare gli aggiornamenti automatici dell'agente in locale

In alternativa alla disabilitazione della proprietà enableAutomaticUpgrade nella risorsa Azure, è possibile bloccare gli aggiornamenti automatici dell'agente in locale in un singolo computer. Questa opzione è utile quando si vuole che l'impostazione della risorsa Azure rimanga abilitata, ma non si vuole che gli aggiornamenti automatici vengano eseguiti in un computer specifico. L'impostazione automaticupgrade.blocklocally ha la precedenza sulla proprietà enableAutomaticUpgrade . Quando l'impostazione locale è true, gli aggiornamenti automatici vengono bloccati anche se enableAutomaticUpgrade è impostato su true.

azcmagent config set automaticupgrade.blocklocally true

Per verificare l'impostazione del blocco locale, eseguire:

azcmagent config get automaticupgrade.blocklocally

Per usare di nuovo gli aggiornamenti automatici dell'agente nel computer, verificare che la proprietà locale sia impostata su false:

azcmagent config set automaticupgrade.blocklocally false

Per modificare queste impostazioni su larga scala, è consigliabile usare Run Command.