Compartilhar via

Atualizar o IoT Edge para Linux no Windows

Aplica-se a:ícone de sim IoT Edge 1.1

Importante

O IoT Edge 1.1 data de término do suporte foi 13 de dezembro de 2022. Confira o Ciclo de Vida do Produto da Microsoft para obter informações sobre o suporte deste produto, serviço, tecnologia ou API. Para obter mais informações sobre como atualizar para a versão mais recente do IoT Edge, consulte Update IoT Edge.

À medida que o aplicativo IoT Edge para Linux no Windows (EFLOW) lança novas versões, você desejará atualizar seus 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 tem nenhum gerenciador de pacotes, portanto, você não pode 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 de lançamento do EFLOW, a versão indica a versão do CBL-Mariner usada, e os usuários podem consultar 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 da máquina virtual são gerenciados por meio de diferentes componentes: WSSDAgent, serviço EFLOWProxy e o módulo do PowerShell.

As atualizações de EFLOW são sequenciais e você precisará atualizar para todas as versões em ordem, o que significa que, para chegar à versão mais recente, você precisará fazer uma nova instalação usando a versão mais recente disponível ou aplicar todas as atualizações de manutenção anteriores à 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:

  1. Abra Configurações no host do Windows.

  2. Selecione Atualização e Segurança.

  3. Selecione Opções avançadas.

  4. 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:

  1. Verifique a versão atual instalada do EFLOW. Abra Configurações, selecione Aplicativos ->Aplicativos e recursos e procure por Azure IoT Edge LTS.

  2. Pesquise e baixe a atualização necessária pelo EFLOW − Catálogo do Microsoft Update.

  3. Extraia AzureIoTEdge.msi do arquivo .cab baixado.

  4. Instale o AzureIoTEdge.msi extraído.

Gerenciar as Atualizações da Microsoft Update

Conforme explicado anteriormente, as atualizações do IoT Edge for Linux on Windows (EFLOW) são gerenciadas por meio do canal do Microsoft Update, portanto, para ativar ou desativar as atualizações do EFLOW, será necessário gerenciar as Atualizações da Microsoft. Listadas abaixo estão algumas das maneiras de 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.

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

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

Caso especial: migração do HCS para o VMMS em SKUs de servidor

Se você estiver atualizando um dispositivo SKU do Windows Server anterior à versão 1.1.2110.0311 do IoT Edge para Linux no Windows para a versão mais recente disponível, será necessário fazer uma migração manual.

A atualização 1.1.2110.0311 introduziu uma alteração na tecnologia de VM (HCS para VMMS) usada para implantações do Windows Server EFLOW. Você pode executar a migração de VM com as seguintes etapas:

  1. Usando o Microsoft Update, baixe e instale a atualização 1.1.2110.0311 (igual a qualquer outra atualização do EFLOW, sem necessidade de etapas manuais, desde que as atualizações do EFLOW estejam ativadas).

  2. Depois que a atualização do EFLOW for concluída, abra uma sessão do PowerShell com privilégios elevados.

  3. Execute o script de migração:

    Migrate-EflowVmFromHcsToVmms

Observação

Novas instalações de MSI do EFLOW 1.1.2110.0311 em SKUs do Windows Server resultarão em implantações de EFLOW usando a tecnologia VMMS, portanto, nenhuma migração é necessária.

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 você quiser migrar da versão 1.1LTS ou 1.4LTS para a versão ou viceversa da Versão Contínua (CR), 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 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
  • 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.

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

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

  3. Abra uma sessão do PowerShell elevada

  4. Iniciar a migração do EFLOW

    Observação

    Você pode migrar com um único cmdlet usando o sinalizador -autoConfirm com o cmdlet Start-EflowMigration. Caso especificado, Confirm-EflowMigration não precisará ser chamado para prosseguir com a migração da versão 1.4.

    1. Se você estiver usando a opção de migração de download automático, execute o cmdlet a seguir 
      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"

  5. Confirmar a migração do EFLOW

    1. Se você estiver usando a opção de migração de download automático, execute o cmdlet a seguir 
      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"

Se, por algum motivo, a migração falhar, a VM EFLOW será restaurada para sua versão original 1.1LTS. Se você quiser cancelar a migração, poderá usar os cmdlets Start-EflowMigration a seguir e, em seguida, Restore-EflowPriorToMigration

Para obter mais informações, consulte a documentação do cmdlet para Start-EflowMigration, Confirm-EflowMigration e Restore-EflowPriorToMigration, utilizando 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 premissas de segurança do IoT Edge para Linux no Windows.

  • Last updated on