Atualizar o IoT Edge para Linux no Windows
Aplica-se a: IoT Edge 1.4
Importante
O IoT Edge 1.5 LTS e o IoT Edge 1.4 são versões com suporte. O IoT Edge 1.4 LTS está chegando ao fim do serviço em 12 de novembro de 2024. Se você estiver em uma versão anterior, confira Atualizar o IoT Edge.
Conforme o aplicativo do IoT Edge para Linux no Windows (EFLOW) lança novas versões, é recomendável atualizar os dispositivos do IoT Edge para os recursos mais recentes e melhorias de segurança. Este artigo fornece as informações sobre como atualizar os dispositivos do IoT Edge para Linux no Windows quando uma nova versão estiver disponível.
Com o IoT Edge para Linux no Windows, o IoT Edge é executado em uma máquina virtual Linux hospedada em um dispositivo Windows. Essa máquina virtual é pré-instalada com o IoT Edge e não possui gerenciador de pacotes, portanto, não será possível atualizar ou alterar manualmente nenhum dos componentes da VM. Em vez disso, a máquina virtual é gerenciada com o Microsoft Update para manter os componentes atualizados automaticamente.
A máquina virtual EFLOW foi projetada para ser atualizada de forma confiável por meio do Microsoft Update. O sistema operacional da máquina virtual possui um esquema de partição de atualização A/B que utiliza um subconjunto de cada uma para tornar cada atualização segura e habilitar uma reversão para uma versão anterior se algo der errado durante o processo de atualização.
Cada atualização consiste em dois componentes principais que podem ser atualizados para as versões mais recentes. A primeira é a máquina virtual EFLOW e os componentes internos. Para obter mais informações sobre o EFLOW, consulte Composição do Azure IoT Edge para Linux no Windows. Isso também inclui o sistema operacional base da máquina virtual. A máquina virtual EFLOW é baseada no Microsoft CBL-Mariner e cada atualização fornece correções de desempenho e segurança para manter o sistema operacional com os patches CVE mais recentes. Como parte das notas sobre a versão do EFLOW, a versão indica a versão do CBL-Mariner usada, e os usuários podem verificar as Versões do CBL-Mariner para obter a lista de CVEs corrigidos para cada versão.
O segundo componente é o grupo dos componentes de runtime do Windows necessários para executar e permitir interoperabilidade com a máquina virtual EFLOW. O ciclo de vida e a interoperabilidade com a máquina virtual são gerenciados por meio de diferentes componentes: WSSDAgent, serviço EFLOWProxy e o módulo PowerShell.
As atualizações do EFLOW são sequenciais e cada versão deverá ser atualizada na ordem, isso significa que para obter a versão mais recente será necessário fazer uma nova instalação usando a última versão disponível ou aplicar todas as atualizações de manutenção anteriores até a versão desejada.
Para encontrar a versão mais recente do Azure IoT Edge para Linux no Windows, confira versões do EFLOW.
Atualizar usando o Microsoft Update
Para receber atualizações do IoT Edge para Linux no Windows, o host do Windows deve ser configurado para receber atualizações para outros produtos da Microsoft. Por padrão, o Microsoft Updates será ativado durante a instalação do EFLOW. Se a configuração personalizada for necessária após a instalação do EFLOW, você poderá Ativar/Desativar essa opção com as seguintes etapas:
Abra Configurações no host do Windows.
Selecione Atualização e Segurança.
Selecione Opções avançadas.
Alterne o botão Receber atualizações para outros produtos Microsoft quando você atualizar o Windows para Ativado.
Atualizar usando o WSUS (Windows Server Update Services)
Há suporte para atualizações locais usando o WSUS para as atualizações do IoT Edge para Linux no Windows. Para obter mais informações sobre o WSUS, consulte Visão geral do Gerenciamento de Dispositivo – WSUS.
Atualização manual offline
Em alguns cenários que tenham a conectividade com a Internet restrita ou limitada, convém aplicar manualmente as atualizações do EFLOW offline. Isso é possível usando os mecanismos offline do Microsoft Update. Você pode baixar e instalar manualmente as atualizações do IoT Edge para Linux no Windows usando as seguintes etapas:
Verifique a versão atual instalada do EFLOW. Abra Configurações, selecione Aplicativos − recursos de >Aplicativos e procure Azure IoT Edge.
Pesquise e baixe a atualização necessária pelo EFLOW − Catálogo do Microsoft Update.
Extraia AzureIoTEdge.msi do arquivo .cab baixado.
Instale o AzureIoTEdge.msi extraído.
Gerenciar as Atualizações da Microsoft Update
Conforme explicado anteriormente, as atualizações do IoT Edges para Linux no Windows são atendidas usando o canal do Microsoft Update, portanto, ativar/desativar as atualizações do EFLOW, e será necessário que você gerencie as Atualizações da Microsoft. Abaixo estão listadas algumas das maneiras para automatizar a ativação/desativação das atualizações da Microsoft. Para obter mais informações sobre como gerenciar as atualizações do SO, consulte Atualizações do sistema operacional.
Políticas de CSP – Usando a Política de CSP Update/AllowMUUpdateService – Para obter mais informações sobre a política de CSP de atualizações da Microsoft, consulte Políticas de CSP – Atualização de MU.
Gerenciar as Atualizações da Microsoft manualmente – Para obter mais informações sobre como aceitar as Atualizações da Microsoft, consulte Aderir ao Microsoft Update.
Migração entre o EFLOW 1.1LTS e o EFLOW 1.4LTS
O IoT Edge para Linux no Windows não dá suporte a migrações entre os diferentes trens de versão. Se desejar mudar da versão 1.1LTS ou 1.4LTS para a versão CR (Versão Contínua) ou vice-versa, será necessário desinstalar a versão atual e instalar a nova versão desejada.
A migração entre o EFLOW 1.1LTS para o EFLOW 1.4LTS foi introduzida como parte da atualização do EFLOW 1.1LTS (1.1.2212.12122). Essa migração lidará com a migração de VM do EFLOW da versão 1.1LTS para a versão 1.4LTS, incluindo o seguinte:
- runtime do IoT Edge
- Configurações do IoT Edge
- Contêineres
- Configuração de rede e VM
- Arquivos armazenados
Para fazer a migração entre o EFLOW 1.1LTS e o EFLOW 1.4LTS, use as etapas a seguir.
Obtenha a atualização mais recente do EFLOW 1.1LTS do Azure (1.1.2212.12122). Se você estiver usando o Windows Update, Verifique as Atualizações para obter a atualização mais recente do EFLOW.
Para a migração de download automático (precisa de conexão com a Internet), ignore esta etapa. Se a VM do EFLOW tiver acesso limitado/sem acesso à internet, baixe os arquivos necessários antes de iniciar a migração.
Abra uma sessão do PowerShell elevada
Iniciar a migração do EFLOW
Observação
Migre com um único cmdlet usando o sinalizador
-autoConfirm
com o cmdletStart-EflowMigration
. Se especificadoConfirm-EflowMigration
, não precisa ser chamado para prosseguir com a migração 1.4.- Se você estiver usando a opção de migração de download automático, execute o cmdlet a seguir
Start-EflowMigration
- Se você baixar o MSI na Etapa 2, use os arquivos baixados para aplicar a migração
Start-EflowMigration -standaloneMsiPath "<path-to-folder>\AzureIoTEdge_LTS_1.4.2.12122_X64.msi"
- Se você estiver usando a opção de migração de download automático, execute o cmdlet a seguir
Confirmar a migração do EFLOW
- Se você estiver usando a opção de migração de download automático, execute o cmdlet a seguir
Confirm-EflowMigration
- Se você baixar o MSI na Etapa 2, use os arquivos baixados para aplicar a migração
Confirm-EflowMigration -updateMsiPath "<path-to-folder>\AzureIoTEdge_LTS_Update_1.4.2.12122_X64.msi"
- Se você estiver usando a opção de migração de download automático, execute o cmdlet a seguir
Aviso
Se por algum motivo a migração falhar, a VM do EFLOW será restaurada para sua versão 1.1LTS original.
Se você quiser cancelar a migração ou restaurar manualmente a VM EFLOW para o estado anterior, poderá usar os seguintes cmdlets Start-EflowMigration
e, em seguida, Restore-EflowPriorToMigration
.
Para obter mais informações, verifique Start-EflowMigration
, Confirm-EflowMigration
e Restore-EflowPriorToMigration
na documentação do cmdlet e usando o comando Get-Help <cmdlet> -full
.
Próximas etapas
Exiba as versões mais recentes do IoT Edge para Linux no Windows.
Leia mais sobre as instalações de segurança do IoT Edge para Linux no Windows.