Atualizar para uma nova versão

Saiba como atualizar uma implantação do Operações IoT do Azure 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.
  • CLI do Azure 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 CLI do Azure.

Compreender o suporte para atualizações

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

O Operações IoT do Azure dá suporte aos seguintes cenários de atualização:

  • Pode atualizar uma instância existente do Operações IoT do Azure 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 Operações IoT do Azure 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 Operações IoT do Azure 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 Operações IoT do Azure 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 Operações IoT do Azure 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 Operações IoT do Azure.

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

  3. Deve usar a versão mais recente da extensão CLI do Operações IoT do Azure para obter a versão mais recente do Operações IoT do Azure. 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 Operações IoT do Azure desejadas em IoT Operations versions.

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

  4. O portal apresenta o comando CLI do Azure 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 Operações IoT do Azure. 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 Operações IoT do Azure está em versão prévia. Verifique as versões do Operações IoT do Azure 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 Operações IoT do Azure 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 tiver uma instância Operações IoT do Azure existente, Desinstalar Operações IoT do Azure para fazer uma nova implementação.

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

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

Se quiser atualizar para uma versão específica do Operações IoT do Azure 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 Operações IoT do Azure 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. O valor mínimo para este parâmetro é 2. Definir o fator de redundância do backend para 1 resulta num erro de implementação.

Versões suportadas

A Microsoft dá suporte a três versões geralmente disponíveis (GA) do Operações IoT do Azure 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.3.x disponibilidade geral 1.3.70 (2604) Notas de lançamento 2.5.0
1.2.x disponibilidade geral 1.2.189 (2602) Notas de lançamento 2.3.0
1.1.x disponibilidade geral 1.1.59 (2506) Notas de lançamento 1.7.0

Observação

Com o lançamento da 1.3.x, as versões suportadas passaram a ser 1.3.x, 1.2.x e 1.1.x. A série 1.0.x (versões 2411 a 2503) já não está dentro da janela de versões suportada.

Para mais informações sobre melhorias 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 Operações IoT do Azure no portal do Azure ou use o comando Operações IoT do Azure CLI az iot ops instance show .

  • Last updated on