Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:
IoT Edge 1.5
Importante
O IoT Edge 1.5 LTS é a versão com suporte. O IoT Edge 1.4 LTS chegou ao fim de sua vida útil em 12 de novembro de 2024. Se você estiver em uma versão anterior, confira Atualizar o IoT Edge.
Quando uma nova versão do aplicativo IoT Edge para Linux no Windows (EFLOW) for lançada, atualize seus dispositivos do IoT Edge para obter os recursos e melhorias de segurança mais recentes. Este artigo explica como atualizar o IoT Edge para Linux em dispositivos 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 vem pré-instalada com o IoT Edge e não tem um gerenciador de pacotes, portanto, você não pode atualizar ou alterar manualmente nenhum dos componentes da VM. Em vez disso, o Microsoft Update gerencia a máquina virtual para manter os componentes atualizados automaticamente.
A máquina virtual EFLOW foi projetada para atualizações confiáveis por meio do Microsoft Update. O sistema operacional da máquina virtual usa um esquema de partição de atualização A/B para tornar cada atualização segura e permite reverter para uma versão anterior se algo der errado durante o processo de atualização.
Cada atualização tem dois componentes principais que podem ser atualizados para as versões mais recentes. A primeira é a máquina virtual EFLOW e seus 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 Azure Linux e cada atualização fornece correções de desempenho e segurança para manter o sistema operacional atualizado com os patches CVE mais recentes. As notas de versão do EFLOW mostram a versão do Azure Linux utilizada, e você pode verificar os ReleasesCBL-Mariner para obter a lista de CVEs corrigidos em 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 de EFLOW são sequenciais e você precisa atualizar para todas as versões em ordem. Para acessar a versão mais recente, faça uma nova instalação usando a versão mais recente disponível ou aplique todas as atualizações de manutenção anteriores à versão desejada.
Importante
Você pode atualizar do EFLOW 1.4 LTS para o EFLOW 1.5 LTS usando qualquer um dos métodos descritos neste artigo. Nenhuma etapa especial é necessária para atualizar do EFLOW 1.4 LTS para o EFLOW 1.5 LTS.
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 obter o IoT Edge para Linux em atualizações do Windows, configure o host do Windows para obter atualizações para outros produtos da Microsoft. Por padrão, o Microsoft Updates está ativado durante a instalação do EFLOW. Se você precisar de uma configuração personalizada após a instalação do EFLOW, ative ou desative esta opção com estas etapas:
Abra Configurações no host do Windows.
Selecione Atualização e Segurança.
Selecione Opções avançadas.
Ative a opção Receber atualizações de outros produtos Microsoft ao atualizar o Windows para Ligado.
Atualizar usando o WSUS (Windows Server Update Services)
Há suporte para atualizações locais usando o WSUS no IoT Edge para Linux em atualizações do Windows. Para obter mais informações sobre o WSUS, consulte Visão geral do Gerenciamento de Dispositivo – WSUS.
Atualização manual offline
Se você tiver conectividade de Internet restrita ou limitada, poderá aplicar manualmente atualizações de EFLOW offline. Use mecanismos offline do Microsoft Update para baixar e instalar manualmente o IoT Edge para Linux em atualizações do Windows. Siga estas etapas:
Verifique a versão atual instalada do EFLOW. Abra Configurações e selecione Aplicativos ->Aplicativos & Recursos. Pesquise pelo 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
As atualizações do IoT Edge para Linux no Windows são atendidas usando o canal do Microsoft Update. Para alterar o recebimento de atualizações de EFLOW, você precisa gerenciar o Microsoft Updates. A lista a seguir inclui maneiras de automatizar a ativação ou desativação de 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 – use a política de CSP Update/AllowMUUpdateService. Para obter mais informações sobre a política de CSP do Microsoft Updates, consulte Política CSP – MU Update.
Gerenciar manualmente as Atualizações do Microsoft – para inscrever-se nas Atualizações do Microsoft, consulte Opt-In para Microsoft Update.
Migração entre o EFLOW com o Azure Linux 2.0 para o EFLOW com o Azure Linux 3.0
A migração entre o Azure Linux 2.0 e o Azure Linux 3.0 foi introduzida como parte da atualização do EFLOW 1.5.5.07025. Essa migração manipula a migração de VM EFLOW do EFLOW 1.5.4.07025 com o Azure Linux 2.0 para o EFLOW 1.5.5.07025 com o Azure Linux 3.0, incluindo o seguinte:
- runtime do IoT Edge
- Configurações do IoT Edge
- Contêineres
- Configuração de rede e VM
- Arquivos armazenados
Para migrar do EFLOW 1.5.4.07025 com o Azure Linux 2.0 para o EFLOW 1.5.5.07025 com o Azure Linux 3.0, use as etapas a seguir.
Obtenha a atualização mais recente do Azure EFLOW 1.5.4.07025. 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 EFLOW tiver acesso limitado/sem acesso à Internet, baixe os arquivos necessários antes de iniciar a migração (baixe um dos seguintes).
Abra uma sessão do PowerShell elevada
Iniciar a migração do EFLOW
Observação
Migre com um único cmdlet usando o sinalizador
-autoConfirmcom o cmdletStart-EflowMigration. Caso especificado,Confirm-EflowMigrationnão precisa ser chamado para prosseguir com a migração do Azure Linux 3.0.- Se você estiver usando a opção de migração de download automático, execute o cmdlet a seguir
Start-EflowMigration - Se você baixou o MSI na Etapa 2, use os arquivos baixados para aplicar a migração (substitua "X64" por "ARM64" no caminho do arquivo se estiver usando ARM64).
Start-EflowMigration -standaloneMsiPath "<path-to-folder>\AzureIoTEdge_Update_LTS_1.5.5.07025_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ê baixou o MSI na Etapa 2, use os arquivos baixados para aplicar a migração (substitua "X64" por "ARM64" no caminho do arquivo se estiver usando ARM64).
Confirm-EflowMigration -updateMsiPath "<path-to-folder>\AzureIoTEdge_Update_LTS_1.5.5.07025_X64.msi"
- Se você estiver usando a opção de migração de download automático, execute o cmdlet a seguir
Aviso
Se a migração falhar por algum motivo, a VM EFLOW será restaurada para sua versão original do EFLOW 1.5.4.07025 com o Azure Linux 2.0.
Para cancelar a migração ou restaurar manualmente a VM EFLOW para seu estado anterior, execute o Start-EflowMigration cmdlet 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.
Saiba mais sobre o IoT Edge para Linux nas instalações de segurança do Windows.