Partilhar via

Atualizar para uma nova versão

Saiba como atualizar uma implantação do Azure IoT Operations para uma versão mais recente.

Pré-requisitos

  • Uma conta do Azure com uma assinatura ativa. Se não tiver uma conta, pode criar uma conta gratuita.
  • Azure CLI versão 2.53.0 ou superior. Utilize az --version para verificar a sua versão e az upgrade para atualizar, se necessário. Para mais informações, consulte Get started with Azure CLI.

Compreender o suporte para atualizações

As versões de lançamento do Azure IoT Operations podem ser visualizadas ou geralmente disponíveis (GA), você pode encontrar a versão mais recente no documento de versões do Azure IoT Operations . A versão da extensão da CLI do Azure IoT Operations está vinculada à versão do Azure IoT Operations, portanto, você precisa garantir que tenha a versão correta da extensão da CLI instalada para executar uma atualização.

O Azure IoT Operations dá suporte aos seguintes cenários de atualização:

  • 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 mudar para uma versão mais antiga, desinstale o Azure IoT Operations e reinstale a versão desejada.
  • Não é possível atualizar de nenhuma versão de visualização para uma versão GA. Você precisa desinstalar o Azure IoT Operations e reinstalar a nova versão.
  • Não é possível atualizar de nenhuma versão do GA para uma versão de visualização. Para obter mais informações sobre como instalar uma versão de visualização, consulte Atualizar para a versão de visualização.

Observação

O Azure IoT Operations não oferece suporte a atualizações em tempo real. Espere algum tempo de inatividade durante o processo de atualização.

Atualização

A operação do Azure IoT suporta a atualização de instâncias para novas versões GA à medida que são lançadas. Se sua instância do Azure IoT Operations estiver qualificada para uma atualização, você poderá usar o portal do Azure ou a CLI do Azure para executar a atualização.

Se a versão mais recente das Operações do Azure IoT estiver em pré-visualização, consulte Atualizar para a versão de pré-visualização.

Se a sua implementação de operações do Azure IoT for elegível para uma atualização, o portal do Azure apresentará uma opção de Atualização. Se você não vir a opção de atualização, sua implantação está na versão mais recente.

  1. No Azure portal, acesse a sua instância Azure IoT Operations.

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

    Captura de ecrã que mostra o botão de atualização ativado no portal do Azure.

  3. Você precisa usar a versão mais recente da extensão da CLI de Operações do Azure IoT para obter a versão mais recente das Operações do Azure IoT. Se não atualizou a extensão como parte dos pré-requisitos, faça-o agora.

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

    Ou, se quiser atualizar a sua implementaçã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 versões do Azure IoT Operations desejadas em IoT Operations versions.

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

  4. O portal apresenta o comando Azure CLI para atualizar a sua instância, pré-preenchido com os detalhes da sua subscrição, grupo de recursos e instância. Selecione o ícone de cópia ao lado do comando CLI.

  5. Execute o comando copiado az iot ops upgrade .

  6. Após o comando de atualização ser concluído com sucesso, atualize a sua instância para ver as alterações.

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

Atualizar para a versão de pré-visualização

Às vezes, a versão mais recente do Azure IoT Operations está em visualização. Verifique as versões do Azure IoT Operations 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 o Azure IoT Operations 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 do Azure IoT Operations, precisará desinstalar o Azure IoT Operations para fazer uma nova implantação.

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

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

Se quiser atualizar para uma versão específica do Azure IoT Operations que não seja a mais recente, você pode executar az iot ops get-versions ou consultar as versões do IoT Operations para encontrar a versão da extensão da CLI associada à versão do Azure IoT Operations 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 para a atualização do broker MQTT

Para garantir zero perda de dados e alta disponibilidade durante as atualizações de implantação, o agente MQTT implementa atualizações contínuas nos pods do agente MQTT. O pod gestor de saúde coordena um processo de atualização incremental para os pods do broker MQTT para garantir que:

  • As ligações de clientes ativas permanecem ininterruptas.
  • Quaisquer mensagens em trânsito são preservadas.
  • Os dados armazenados em disco são devidamente migrados entre versões.

Se ocorrer uma falha durante o processo de atualização, o pod do gestor de saúde reinicia automaticamente o processo de atualização, garantindo que não haja perda de dados ou conectividade.

As atualizações contínuas só podem ocorrer se o broker MQTT for implantado com duas ou mais réplicas de backend. As atualizações do broker MQTT não são suportadas para implementações de réplica única. Quando implementa Operações de IoT da Azure, especifica o número de réplicas de backend a criar no comando az iot ops create com o parâmetro --broker-backend-rf.

Versões suportadas

A Microsoft dá suporte a três versões geralmente disponíveis (GA) do Azure IoT Operations a qualquer momento: a versão mais recente e as duas versões secundárias anteriores. Além disso, 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
lançamento (AAMM)		 Notas de lançamento Atual
Versão da CLI
1.2.x disponibilidade geral 1.2.154 (2512) Notas de lançamento 2.1.0
1.1.x disponibilidade geral 1.1.59 (2506) Notas de lançamento 1.7.0
1.0.x disponibilidade geral 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 e funcionalidades de segurança mais recentes.

Advertência

Não use versões de visualização em ambientes de produção.

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

  • Last updated on