Atualizar o IoT Edge para Linux no Windows

Artigo
04/11/2024

Aplica-se a: IoT Edge 1.4

Importante

O IoT Edge 1.4 é a versão suportada. Se tiver uma versão anterior, consulte Atualizar IoT Edge.

À medida que o aplicativo IoT Edge para Linux no Windows (EFLOW) lança novas versões, você desejará atualizar seus dispositivos IoT Edge para obter os recursos e melhorias de segurança mais recentes. Este artigo fornece informações sobre como atualizar seu 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 é pré-instalada com o IoT Edge e não tem gerenciador de pacotes, portanto, não é 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 tem um esquema de partição de atualização A/B para utilizar um subconjunto desses 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. O primeiro é a máquina virtual EFLOW e os componentes internos. Para obter mais informações sobre EFLOW, consulte Azure IoT Edge para Linux na composição do 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 de versão do EFLOW, a versão indica a versão 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 de componentes do tempo de execução do Windows necessários para executar e interoperar com a máquina virtual EFLOW. O ciclo de vida e a interoperabilidade da 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 você precisará atualizar para cada versão em ordem, o que significa que, para chegar à versão mais recente, você terá que fazer uma nova instalação usando a versão mais recente disponível ou aplicar todas as atualizações de serviço anteriores até a versão desejada.

Para encontrar a versão mais recente do Azure IoT Edge para Linux no Windows, consulte Versões 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 e desativar essa opção com as seguintes etapas:

Abra Configurações no host Windows.
Selecione Atualizações & Segurança.
Selecione Opções avançadas.
Alterne o botão Receber atualizações para outros produtos da Microsoft ao atualizar o Windows para Ativado.

Atualizar usando o WSUS (Windows Server Update Services)

As atualizações locais usando o WSUS são suportadas para atualizações do IoT Edge para Linux no Windows. Para obter mais informações sobre o WSUS, consulte Visão geral do gerenciamento de dispositivos - WSUS.

Atualização manual offline

Em alguns cenários com conectividade restrita ou limitada com a Internet, convém aplicar manualmente as atualizações EFLOW offline. Isso é possível usando mecanismos offline do Microsoft Update. Você pode baixar e instalar manualmente um IoT Edge para atualizações do Linux no Windows com as seguintes etapas:

Verifique a versão atual instalada do EFLOW. Abra Configurações, selecione Apps ->Apps & features search for Azure IoT Edge.
Pesquise e baixe a atualização necessária do catálogo EFLOW - Microsoft Update.
Extraia AzureIoTEdge.msi do arquivo de .cab baixado.
Instale o AzureIoTEdge.msi extraído.

Gerenciando atualizações da Microsoft

Como explicado anteriormente, as atualizações do IoT Edges para Linux no Windows são atendidas usando o canal Microsoft Update, portanto, ative / desative as atualizações EFLOW, você terá que gerenciar as atualizações da Microsoft. Abaixo estão listadas algumas das maneiras de automatizar a ativação/desativação de atualizações da Microsoft. Para obter mais informações sobre como gerenciar atualizações do sistema operacional, consulte Atualizações do sistema operacional.

Políticas CSP - Usando a Política CSP Update/AllowMUUpdateService - Para obter mais informações sobre a política CSP do Microsoft Updates, consulte Policy CSP - MU Update.
Gerenciar manualmente as atualizações da Microsoft - Para obter mais informações sobre como aceitar as atualizações da Microsoft, consulte Aceitar o Microsoft Update.

Migração entre EFLOW 1.1LTS e EFLOW 1.4LTS

O IoT Edge para Linux no Windows não suporta migrações entre os diferentes trens de versão. Se você quiser mudar da versão 1.1LTS ou 1.4LTS para a versão Continuous Release (CR) ou vice-versa, você terá que desinstalar a versão atual e instalar a nova versão desejada.

A migração entre EFLOW 1.1LTS para EFLOW 1.4LTS foi introduzida como parte da atualização EFLOW 1.1LTS (1.1.2212.12122). Essa migração manipulará a migração da VM EFLOW da versão 1.1LTS para a versão 1.4LTS, incluindo o seguinte:

Runtime do IoT Edge
Configurações do IoT Edge
Contentores
Configuração de rede e VM
Ficheiros armazenados

Para migrar entre EFLOW 1.1LTS para EFLOW 1.4LTS, use as etapas a seguir.

Obtenha a atualização mais recente do Azure EFLOW 1.1LTS (1.1.2212.12122). Se estiver a utilizar o Windows Update, verifique as Atualizações para obter a atualização EFLOW mais recente.
Para migração de download automático (precisa de conexão com a Internet), ignore esta etapa. Se a VM EFLOW tiver acesso limitado/nenhum acesso à Internet, faça o download dos arquivos necessários antes de iniciar a migração.
- 1.4.2.12122 MSI independente
- 1.4.2.12122 Atualização MSI
Abrir uma sessão elevada do PowerShell
Iniciar a migração EFLOW

Nota

Você pode migrar com um único cmdlet usando o sinalizador com o -autoConfirm Start-EflowMigration cmdlet. Se especificado Confirm-EflowMigration não precisa ser chamado para prosseguir com a migração 1.4.
1. Se você estiver usando a opção de migração de download automático, execute o seguinte cmdlet:
```
Start-EflowMigration
```
2. 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" 
```
Confirmar a migração EFLOW
1. Se você estiver usando a opção de migração de download automático, execute o seguinte cmdlet:
```
Confirm-EflowMigration
```
2. 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" 
```

Aviso

Se, por qualquer motivo, a migração falhar, a VM EFLOW será restaurada para sua versão 1.1LTS original. Se quiser cancelar a migração ou restaurar manualmente a VM EFLOW para o estado anterior, você pode usar os seguintes cmdlets Start-EflowMigration e, em seguida Restore-EflowPriorToMigration, .

Para obter mais informações, verifique Start-EflowMigrationa documentação do Confirm-EflowMigration cmdlet usando Restore-EflowPriorToMigration o Get-Help <cmdlet> -full comando.

Próximos passos

Veja as versões mais recentes do IoT Edge para Linux no Windows.

Leia mais sobre o IoT Edge para Linux nas instalações de segurança do Windows.