Eseguire l'aggiornamento o il downgrade tra versioni

Aggiornare una distribuzione di Azure IoT Operations a una versione più recente o eseguire il rollback a una versione precedente. Le operazioni IoT di Azure supportano l'aggiornamento e il rollback dalla versione 1.0.x successiva. Non è disponibile alcun supporto per l'aggiornamento da qualsiasi versione di anteprima delle operazioni IoT di Azure a qualsiasi versione disponibile a livello generale.

Prerequisiti

• Interfaccia della riga di comando di Azure. Questo scenario richiede l'interfaccia della riga di comando di Azure versione 2.64.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.

• Estensione Operazioni di Azure IoT per l'interfaccia della riga di comando di Azure. Usare il comando seguente per aggiungere l'estensione o aggiornarla alla versione più recente:

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

Informazioni sul supporto per l'aggiornamento

L'aggiornamento e il rollback sono supportati tra versioni secondarie N+3 o N-3 di Operazioni IoT di Azure o tra le versioni patch della stessa versione secondaria. La tabella seguente fornisce esempi:

Versione	Intervallo di aggiornamento	Intervallo di downgrade
1.0.0	Da 1.0.1 a 1.3.x	None
1.1.0	Da 1.1.1 a 1.4.x	1.0.x
1.4.4	Da 1.4.5 a 1.7.x	Da 1.1.x a 1.4.3

Aggiornamento

Le operazioni di Azure IoT supportano l'aggiornamento delle istanze alle nuove versioni ga man mano che vengono rilasciate.

Non è possibile eseguire l'aggiornamento da un'installazione di anteprima a una versione disponibile a livello generale. Per passare alla versione 1.0.x, disinstallare Le operazioni di Azure IoT e reinstallare la nuova versione.

Azure portal

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. Nella portale di Azure passare all'istanza di Operazioni IoT di Azure.

2. Selezionare Aggiorna nella pagina Panoramica dell'istanza.

   

3. Il portale presenta 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. Selezionare l'icona di copia accanto al comando dell'interfaccia della riga di comando.

4. Eseguire il comando copiato az iot ops upgrade in qualsiasi ambiente in cui è installata l'interfaccia della riga di comando di Azure.

5. 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 ha un aggiornamento disponibile. È possibile indicare che un aggiornamento ha avuto esito positivo se l'opzione Aggiorna scompare dalla pagina di panoramica dell'istanza, anche se non ha un aspetto simile a nulla modificato. È 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.

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

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

Per eseguire l'aggiornamento a una versione specifica di un componente, specificare il numero di versione nei parametri. Ad esempio:

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

È possibile trovare le versioni dei componenti supportate e le informazioni sul training delle versioni nel file azure-iot-operations-enablement.json incluso in qualsiasi versione di Azure IoT Operations.

Downgrade

Azure portal

Il portale di Azure non offre un'opzione di downgrade della versione. Usare invece l'interfaccia della riga di comando di Azure.

Interfaccia della riga di comando di Azure

Usare il comando az iot ops upgrade per eseguire il rollback di un'istanza esistente di Azure IoT Operations a una versione precedente.

Nel comando di aggiornamento è possibile specificare una versione del componente fino a tre versioni secondarie meno recenti.

È possibile trovare le versioni dei componenti supportate e le informazioni sul training delle versioni nel file azure-iot-operations-enablement.json incluso in qualsiasi versione di Azure IoT Operations.