Compartilhar via

Atualizar ou fazer downgrade entre versões

  • Artigo

Atualize uma implantação das Operações do Azure IoT para uma versão mais recente ou reverta para uma versão anterior. As Operações do Azure IoT dão suporte à atualização e reversão da versão 1.0.x em diante. Não há suporte para atualização de qualquer versão prévia das Operações do Azure IoT para qualquer versão de disponibilidade geral (GA).

Pré-requisitos

  • CLI do Azure. Esse cenário requer a CLI do Azure versão 2.64.0 ou superior. Use az --version para verificar sua versão e az upgrade para atualizar, se necessário. Para obter mais informações, consulte Introdução à CLI do Azure.

  • A extensão das Operações do Azure IoT para a CLI do Azure. Use o seguinte comando para adicionar a extensão ou atualizá-la à versão mais recente:

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

Entender o suporte à atualização

Há suporte para atualização e reversão entre as versões secundárias N+3 ou N-3 das Operações do Azure IoT ou entre as versões de patch da mesma versão secundária. A tabela a seguir fornece exemplos:

Versão Intervalo de atualização Intervalo de downgrade
1.0.0 1.0.1 a 1.3.x Nenhum
1.1.0 1.1.1 a 1.4.x 1.0.x
1.4.4 1.4.5 a 1.7.x 1.1.x a 1.4.3

Atualizar

As Operações do Azure IoT dão suporte à atualização de instâncias para novas versões de GA conforme elas são lançadas.

Você não pode atualizar de uma instalação de visualização para uma versão de GA. Para migrar para a versão 1.0.x, desinstale as Operações do Azure IoT e reinstale a nova versão.

Se a implantação das Operações do Azure IoT estiver qualificada para uma atualização, o portal do Azure exibirá uma opção Atualizar. Se você não vir a opção de atualizar, sua implantação estará na versão mais recente.

  1. No portal do Azure, navegue até a instância das Operações do Azure IoT.

  2. Selecione Atualizar na página Visão geral da sua instância.

    Captura de tela que mostra o botão de atualização habilitado no portal do Azure.

  3. O portal apresenta o comando da CLI do Azure para atualizar sua instância, preenchida previamente com sua assinatura, grupo de recursos e detalhes da instância. Selecione o ícone de cópia ao lado do comando da CLI.

  4. Execute o comando az iot ops upgrade copiado em qualquer ambiente em que você tenha a CLI do Azure instalada.

  5. Depois que o comando de atualização for concluído com sucesso, atualize sua instância para ver as alterações.

O valor da Versão exibido na página de visão geral da sua instância reflete a versão da instância das Operações do Azure IoT. No entanto, você pode ser solicitado a atualizar se uma extensão do Arc necessária tiver uma atualização disponível. Você pode saber que uma atualização foi bem-sucedida se a opção Atualização desaparecer da página de visão geral da instância, mesmo que pareça que nada tenha sido alterado. Você pode verificar as versões das extensões do Arc para sua implantação da Operação de IoT do Azure na página Extensões do seu cluster habilitado para Arc no portal do Azure.

Downgrade

O portal do Azure não oferece uma opção de downgrade de versão. Em vez disso, use a CLI do Azure.