Compartilhar via

Atualizar para uma nova versão

Saiba como atualizar uma implantação das Operações do Azure IoT para uma versão mais recente.

Pré-requisitos

  • Uma conta do Azure com uma assinatura ativa. Se você não tiver uma conta, poderá criar uma conta gratuita.
  • Versão 2.53.0 ou superior da CLI do Azure. 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.

Entender o suporte à atualização

As versões das Operações do Azure IoT podem ser de visualização ou em disponibilidade geral (GA). Você pode encontrar a versão mais recente no documento Versões das Operações do Azure IoT. A versão da extensão da CLI das Operações do Azure IoT está vinculada à versão das Operações do Azure IoT. Portanto, você precisa garantir que a versão correta da extensão da CLI esteja instalada para realizar uma atualização.

As Operações do Azure IoT dão suporte aos seguintes cenários de 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.
  • Não é possível fazer downgrade entre versões. Para mover para uma versão mais antiga, desinstale as Operações do Azure IoT e reinstale a versão desejada.
  • Não é possível atualizar de qualquer versão de visualização para uma versão em GA. Você precisa desinstalar as Operações do Azure IoT e reinstalar a nova versão.
  • Não é possível atualizar de qualquer versão em GA para uma versão de visualização. Para obter mais informações sobre como instalar uma versão de visualização, confira Atualizar para a versão de visualização.

Observação

As Operações de IoT do Azure não dão suporte a atualizações dinâmicas. Espere algum tempo de inatividade durante o processo de atualização.

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. Se a instância das Operações do Azure IoT estiver qualificada para uma atualização, você poderá usar o portal do Azure ou a CLI do Azure para realizar a atualização.

Se a versão mais recente das Operações do Azure IoT estiver em visualização, confira Atualizar para a versão de visualizaçã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ê poderá 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.

Atualizar para a versão de visualização

Às vezes, a versão mais recente das Operações do Azure IoT está em visualização. Verifique as Versões das Operações do Azure IoT para ver a versão mais recente. Durante as versões de visualização, a atualização de versão é bloqueada e você precisa desinstalar as Operações do Azure IoT e reinstalar a versão de visualização.

Você só pode instalar uma versão de visualização usando a CLI do Azure.

  1. Se você tiver uma instância existente das Operações do Azure IoT, será necessário Desinstalar as Operações do Azure IoT para fazer uma nova implantação.

  2. Adicione a versão mais recente da extensão da CLI das Operações do Azure IoT com o sinalizador --allow-preview.

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

Se você quiser atualizar para uma versão específica das Operações do Azure IoT que não seja a mais recente, poderá executar az iot ops get-versions ou consultar Versões das Operações do Azure IoT para localizar a versão da extensão da CLI associada à versão das Operações do Azure IoT desejada. Obtenha o número da versão e execute o seguinte comando para atualizar para essa versão:

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

Considerações sobre a atualização do servidor MQTT

Para garantir a perda de dados zero e a alta disponibilidade durante as atualizações de implantação, o agente MQTT implementa atualizações sem interrupção nos pods do agente MQTT. O pod do gerenciador de integridade coordena um processo de atualização incremental para os pods do Agente MQTT para garantir que:

  • As conexões de cliente ativo permanecem ininterruptas.
  • Todas as mensagens em voo são preservadas.
  • Os dados armazenados no disco são migrados corretamente entre versões.

Se ocorrer uma falha durante o processo de atualização, o pod do gerenciador de integridade reiniciará automaticamente o processo de atualização, garantindo que não haja perda de dados ou conectividade.

As atualizações sem interrupção só poderão ocorrer se o Agente MQTT for implantado com duas ou mais réplicas de back-end. Não há suporte para atualizações do Agente MQTT para implantações de réplica única. Ao implantar operações de IoT do Azure, especifique o número de réplicas de back-end a serem criadas no comando az iot ops create com o --broker-backend-rf parâmetro.

Versões suportadas

Microsoft suporta três versões GA (geralmente disponíveis) do Azure IoT Operations a qualquer momento: a versão mais recente e as duas versões anteriores menores. Além disso, as versões de visualização estão disponíveis para testar novos recursos.

Atualmente, o suporte do Azure está disponível para as seguintes versões:

Versão Tipo Patch atual
versão (AAMM)		 Notas de lançamento Current
Versão da CLI
1.2.x GA 1.2.154 (2512) Notas de lançamento 2.1.0
1.1.x GA 1.1.59 (2506) Notas de lançamento 1.7.0
1.0.x GA 1.0.34 (2503) Notas de lançamento 1.3.0

Para saber mais sobre atualizações entre versões, consulte Atualizar para uma nova versão.

Importante

As versões secundárias anteriores não recebem patches de segurança. Atualize para a versão mais recente para obter as atualizações de segurança e os recursos mais recentes.

Aviso

Não use versões prévias em ambientes de produção.

Para verificar sua versão atual, vá para a página de visão geral da instância de Operações IoT do Azure no portal do Azure ou use o comando az iot ops instance show da CLI de Operações IoT do Azure.

  • Last updated on