Eseguire l'aggiornamento a una nuova versione

Informazioni su come aggiornare una distribuzione di Operazioni di Azure IoT a una versione più recente.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Se non si ha un account, è possibile creare un account gratuito.
• Interfaccia della riga di comando di Azure versione 2.53.0 o successiva. Usare az --version per controllare la versione e az upgrade per aggiornarla, se necessario. Per altre informazioni, vedere Attività iniziali con l’interfaccia della riga di comando di Azure.

Informazioni sul supporto per l'aggiornamento

Le versioni di rilascio di Operazioni di Azure IoT possono essere disponibili in anteprima o a livello generale. La versione più recente è disponibile nel documento Versioni di Operazioni di Azure IoT . La versione dell'estensione dell'interfaccia della riga di comando di Operazioni di Azure IoT è associata alla versione di Operazioni di Azure IoT, quindi è necessario assicurarsi di avere installato la versione corretta dell'estensione dell'interfaccia della riga di comando per eseguire un aggiornamento.

Le Operazioni di Azure IoT supportano gli scenari di aggiornamento seguenti:

• È possibile aggiornare un'istanza esistente di Azure IoT Operations a qualsiasi patch della stessa versione secondaria o alla versione secondaria successiva.
• Non è possibile effettuare il downgrade tra le versioni. Per passare a una versione precedente, disinstallare Operazioni di Azure IoT e reinstallare la versione desiderata.
• Non è possibile eseguire l'aggiornamento da una versione di anteprima a una versione disponibile a livello generale. È necessario disinstallare Operazioni di Azure IoT e reinstallare la nuova versione.
• Non è possibile eseguire l'aggiornamento da una versione disponibile a livello generale a una versione di anteprima. Per altre informazioni su come installare una versione di anteprima, vedere Eseguire l'aggiornamento alla versione di anteprima.

Annotazioni

Le operazioni IoT di Azure non supportano gli aggiornamenti in tempo reale. Attendere tempi di inattività durante il processo di aggiornamento.

Aggiornamento

Azure IoT Operations supporta l'aggiornamento delle istanze alle nuove versioni GA non appena vengono rilasciate. Se l'istanza di Operazioni di Azure IoT è idonea per un aggiornamento, è possibile usare il portale di Azure o l'interfaccia della riga di comando di Azure per eseguire l'aggiornamento.

Se la versione più recente di Operazioni di Azure IoT è in anteprima, vedere Eseguire l'aggiornamento alla versione di anteprima.

Portale di Azure

Se la distribuzione di Azure IoT Operations è idonea per un aggiornamento, il portale di Azure visualizza un'opzione Di aggiornamento. Se non viene visualizzata l'opzione di aggiornamento, la distribuzione è nella versione più recente.

1. Nel portale di Azure, passare alla tua istanza di Azure IoT Operations.

2. Selezionare Aggiorna nella pagina Panoramica dell'istanza.

   

3. È necessario usare la versione più recente dell'estensione dell'interfaccia della riga di comando di Azure IoT Operations per ottenere la versione più recente delle operazioni di Azure IoT. Se l'estensione non è stata aggiornata come parte dei prerequisiti, eseguire ora l’aggiornamento.

   az extension add --upgrade --name azure-iot-ops
   

   In alternativa, se si vuole aggiornare la distribuzione a una versione più recente ma non alla versione più recente, impostare la versione dell'estensione dell'interfaccia della riga di comando su quella associata alle versioni di Operazioni di Azure IoT desiderate in versioni di Operazioni di IoT.

   az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>
   

4. Nel portale è disponibile il comando dell'interfaccia della riga di comando di Azure per aggiornare l'istanza, prepopolata con la sottoscrizione, il gruppo di risorse e i dettagli dell'istanza corretti. Selezionare l'icona di copia accanto al comando dell'interfaccia della riga di comando.

5. Eseguire il comando copiato az iot ops upgrade .

6. Al termine del comando di aggiornamento, aggiornare l'istanza per visualizzare le modifiche.

Il valore Version visualizzato nella pagina di panoramica dell'istanza riflette la versione dell'istanza di Operazioni IoT di Azure. Tuttavia, potrebbe essere richiesto di eseguire l'aggiornamento se un'estensione Arc necessaria dispone di un aggiornamento disponibile. Si può dire che un aggiornamento ha avuto esito positivo se l'opzione Aggiorna scompare dalla pagina di riepilogo dell'istanza, anche se non sembra che sia cambiato nulla. È possibile controllare le versioni delle estensioni Arc per la distribuzione dell'operazione IoT di Azure nella pagina Estensioni del cluster abilitato per Arc nella portale di Azure.

Interfaccia della riga di comando di Azure

Usare il comando az iot ops upgrade per aggiornare una distribuzione di Azure IoT Operations esistente a una versione più recente.

Il comando di aggiornamento valuta l'intera distribuzione di Operazioni IoT di Azure per gli aggiornamenti disponibili, incluse le estensioni arc installate nel az iot ops init comando e l'istanza di Operazioni IoT di Azure.

Seguire questa procedura per aggiornare la distribuzione alla versione più recente:

1. Aggiungere la versione più recente dell'estensione dell'interfaccia della riga di comando di Operazioni di Azure IoT.

   az extension add --upgrade --name azure-iot-ops
   

2. Eseguire az iot ops upgrade

   az iot ops upgrade --resource-group <RESOURCE_GROUP_NAME> --name <INSTANCE_NAME>
   

3. L'interfaccia della riga di comando restituisce una tabella dei componenti con aggiornamenti disponibili. Immettere Y per continuare con l'aggiornamento.

Se si vuole eseguire l'aggiornamento a una versione specifica di Operazioni di Azure IoT che non sono le più recenti, è possibile eseguire az iot ops get-versions o fare riferimento alle versioni delle operazioni IoT per trovare la versione dell'estensione dell'interfaccia della riga di comando associata alla versione di Operazioni di Azure IoT desiderata. Ottenere il numero di versione ed eseguire il comando seguente per eseguire l'aggiornamento a tale versione:

az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>

Eseguire l'aggiornamento alla versione di anteprima

A volte la versione più recente di Operazioni di Azure IoT è in anteprima. Controllare le versioni di Operazioni di Azure IoT per visualizzare la versione più recente. Durante le versioni di anteprima, l'aggiornamento della versione è bloccato ed è necessario disinstallare Operazioni di Azure IoT e reinstallare la versione di anteprima.

È possibile installare solo una versione di anteprima usando l'interfaccia della riga di comando di Azure.

1. Se si dispone di un'istanza esistente di Operazioni IoT di Azure, è necessario disinstallare Operazioni di Azure IoT per eseguire una nuova distribuzione.

2. Aggiungere la versione più recente dell'estensione dell'interfaccia della riga di comando di Operazioni di Azure IoT con il flag --allow-preview.

   az extension add --upgrade --name azure-iot-ops --allow-preview
   

Se si vuole eseguire l'aggiornamento a una versione specifica di Operazioni di Azure IoT che non sono le più recenti, è possibile eseguire az iot ops get-versions o fare riferimento alle versioni delle operazioni IoT per trovare la versione dell'estensione dell'interfaccia della riga di comando associata alla versione di Operazioni di Azure IoT desiderata. Ottenere il numero di versione ed eseguire il comando seguente per eseguire l'aggiornamento a tale versione:

az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>

Considerazioni sull'aggiornamento del broker MQTT

Per garantire zero perdite di dati e disponibilità elevata durante gli aggiornamenti della distribuzione, il broker MQTT implementa gli aggiornamenti in sequenza nei pod broker MQTT. Il pod di Health Manager coordina un processo di aggiornamento incrementale per i pod broker MQTT per garantire che:

• Le connessioni client attive rimangono ininterrotte.
• Qualsiasi messaggio in volo viene preservato.
• I dati archiviati sul disco vengono migrati correttamente tra le versioni.

Se si verifica un errore durante il processo di aggiornamento, il pod di Health Manager riavvia automaticamente il processo di aggiornamento, garantendo al tempo stesso l'assenza di perdita di dati o connettività.

Gli aggiornamenti in sequenza possono verificarsi solo se il broker MQTT viene distribuito con due o più repliche back-end. Gli aggiornamenti del broker MQTT non sono supportati per le distribuzioni a replica singola. Quando distribuisci le operazioni IoT di Azure, specifica il numero delle repliche back-end da creare nel comando az iot ops create con il parametro --broker-backend-rf.

Versioni supportate

In qualsiasi momento Microsoft supporta tre versioni con disponibilità generale (GA) di Operazioni di Azure IoT: la versione più recente e le due versioni secondarie precedenti. Inoltre, le versioni di anteprima sono disponibili per testare nuove funzionalità.

Attualmente, il supporto di Azure è disponibile per le versioni seguenti:

Versione	TIPO	Patch attuale rilascio (YYMM)	Corrente Versione dell'interfaccia della riga di comando	Note di rilascio
1.2.x	GA	1.2.112 (2510)	2.0.1	Note di rilascio
1.1.x	GA	1.1.59 (2506)	1.7.0	Note di rilascio
1.0.x	GA	1.0.34 (2503)	1.3.0	Note di rilascio

Per informazioni sugli aggiornamenti tra versioni, vedere Aggiornare a una nuova versione.

Importante

Le versioni secondarie precedenti non ricevono patch di sicurezza. Aggiornare alla versione più recente per ottenere gli aggiornamenti e le funzionalità di sicurezza più recenti.

Avvertimento

Non usare le versioni di anteprima negli ambienti di produzione.

Per verificare la versione corrente, passare alla pagina di panoramica per l'istanza di Operazioni IoT di Azure nel portale di Azure oppure usare il comando az iot ops instance show dell'interfaccia della riga di comando di Operazioni di Azure IoT.