Eseguire l'aggiornamento a una nuova versione

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

Prerequisiti

Informazioni sul supporto per l'aggiornamento

Operazioni di Azure IoT le versioni di rilascio possono essere disponibili in anteprima o a livello generale. È possibile trovare la versione più recente in le 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 Operazioni di Azure IoT 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.

Annotazioni

A partire dalla versione 1.3, i dispositivi, gli asset, gli endpoint in ingresso, i broker MQTT, i flussi di dati e i connettori Akri segnalano uno stato di integrità di runtime visibile nel portale di Azure e nell'interfaccia utente Web dell'esperienza operativa. Dopo l'aggiornamento da una versione precedente, questo stato di integrità viene visualizzato nelle risorse per la prima volta. Si tratta di un comportamento previsto, non di una regressione. Per altre informazioni, vedere Segnalazione dello stato di salute unificato e osservabilità.

Aggiornamento

Operazioni di Azure IoT 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.

Se la distribuzione di Operazioni di Azure IoT è 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 Operazioni di Azure IoT.

  2. Selezionare Aggiorna nella pagina Panoramica dell'istanza.

    Screenshot che mostra il pulsante di aggiornamento abilitato nel Azure portal.

  3. È necessario usare la versione più recente dell'estensione dell'interfaccia della riga di comando di Operazioni di Azure IoT per ottenere la versione più recente di 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.

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 di Operazioni di Azure IoT esistente, Uninstallare Operazioni di Azure IoT per eseguire una nuova distribuzione.

  2. Aggiungere l'ultima versione dell'estensione CLI 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. Il valore minimo per questo parametro è 2. L'impostazione del fattore di ridondanza back-end su 1 genera un errore di distribuzione.

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, supporto tecnico di Azure è disponibile per le versioni seguenti. Per le note di rilascio per patch di qualsiasi versione di Operazioni di Azure IoT, vedere le versioni di Operazioni di Azure IoT su GitHub.

Versione TIPO Patch attuale
rilascio (YYMM)		 Note di rilascio Corrente
Versione dell'interfaccia della riga di comando
1.3.x GA 1.3.70 (2604) Note di rilascio 2.5.0
1.2.x GA 1.2.189 (2602) Note di rilascio 2.3.0
1.1.x GA 1.1.59 (2506) Note di rilascio 1.7.0

Annotazioni

Con la versione 1.3.x, le versioni supportate diventano 1.3.x, 1.2.x e 1.1.x. La serie 1.0.x (versioni da 2411 a 2503) non è più inclusa nella finestra della versione supportata.

Per altre informazioni sugli aggiornamenti tra versioni, vedere Eseguire l'aggiornamento 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.

  • Last updated on