Compartilhar via

Versões de atualização

  • Artigo

Atualize uma implantação do Azure IoT Operations para uma versão mais recente. O Azure IoT Operations oferece suporte à atualizaçã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.53.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

Você pode atualizar uma instância existente do Azure IoT Operations para qualquer patch da mesma versão secundária ou para a próxima versão secundária.

O Azure IoT Operations não oferece suporte ao downgrade entre versões. Para migrar para uma versão mais antiga, desinstale o Azure IoT Operations e reinstale a versão desejada.

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. Você precisa usar a versão mais recente da extensão CLI do Azure IoT Operations para obter a versão mais recente do Azure IoT Operations. Se você não atualizou a extensão como parte dos pré-requisitos, faça isso agora.

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

    Ou, se você quiser atualizar sua implantação para uma versão mais recente, mas não a mais recente, defina a versão da extensão CLI para aquela associada às suas versões desejadas do Azure IoT Operations em Versões do IoT Operations.

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

  4. 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.

  5. Execute o comando az iot ops upgrade copiado.

  6. 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.