Atualizar o IoT Edge

Em dispositivos Linux x64, use apt-get ou o gerenciador de pacotes apropriado para atualizar o módulo de runtime para a versão mais recente.

Atualizar a ferramenta apt.

sudo apt-get update

Verifique quais versões do IoT Edge estão disponíveis.

apt list -a iotedge

Se você quiser atualizar para a versão mais recente do módulo de runtime, use o seguinte comando, que também atualiza libiothsm-std para a versão mais recente:

sudo apt-get install iotedge

Se você quiser atualizar para uma versão específica do módulo de runtime, especifique a versão da saída da lista apt. Sempre que iotedge é atualizado, ele tenta atualizar automaticamente o pacote libiothsm-std para sua versão mais recente, o que pode causar um conflito de dependência. Se você não estiver indo para a versão mais recente, certifique-se de direcionar ambos os pacotes para a mesma versão. Por exemplo, o comando a seguir instala uma versão específica da versão 1.1:

sudo apt-get install iotedge=1.1.1 libiothsm-std=1.1.1

Se a versão que você deseja instalar não estiver disponível por meio do apt-get, poderá usar o curl para direcionar qualquer versão do repositório de lançamentos do IoT Edge . Para a versão que você deseja instalar, localize os arquivos apropriados libiothsm-std e iotedge para seu dispositivo. Para cada arquivo, clique com o botão direito do mouse no link do arquivo e copie o endereço do link. Use o endereço de link para instalar as versões específicas desses componentes:

curl -L <libiothsm-std link> -o libiothsm-std.deb && sudo apt-get install ./libiothsm-std.deb
curl -L <iotedge link> -o iotedge.deb && sudo apt-get install ./iotedge.deb

Não há suporte para o IoT Edge versão 1.1 no Red Hat Enterprise Linux 8.

Para obter informações sobre o IoT Edge para Linux em atualizações do Windows, consulte Atualizações de EFLOW.

Com o IoT Edge para Windows, o IoT Edge é executado diretamente no dispositivo Windows.

Use o comando Update-IoTEdge para atualizar o runtime do módulo. O script puxa automaticamente a versão mais recente do runtime do módulo.

. {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; Update-IoTEdge

A execução do comando Update-IoTEdge remove e atualiza o módulo de runtime do seu dispositivo, juntamente com as duas imagens de contêiner de runtime. O arquivo config.yaml é mantido no dispositivo, assim como os dados do mecanismo de contêiner Moby. Manter as informações de configuração significa que você não precisa fornecer a cadeia de conexão ou informações do Serviço de Provisionamento de Dispositivos para seu dispositivo novamente durante o processo de atualização.

Se você quiser atualizar para uma versão específica do subsistema de segurança, encontre a versão do canal de distribuição 1.1 que você deseja a partir de versões do IoT Edge. Nessa versão, baixe o arquivo Microsoft-Azure-IoTEdge.cab. Em seguida, use o parâmetro -OfflineInstallationPath para apontar para o local do arquivo local. Por exemplo:

. {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; Update-IoTEdge -OfflineInstallationPath <absolute path to directory>

Se você quiser atualizar um dispositivo offline, encontre a versão que deseja atualizar de versões do Azure IoT Edge. Nessa versão, baixe os arquivos IoTEdgeSecurityDaemon.ps1 e Microsoft-Azure-IoTEdge.cab. É importante usar o script do PowerShell da mesma versão do arquivo .cab que você usa porque a funcionalidade é alterada para dar suporte aos recursos em cada versão.

Se o arquivo .cab que você baixou tiver um sufixo de arquitetura, renomeie o arquivo para apenas Microsoft-Azure-IoTEdge.cab.

Para atualizar com componentes offline, utilize ponto de origem na cópia local do script do PowerShell. Em seguida, use o parâmetro -OfflineInstallationPath como parte do comando Update-IoTEdge e forneça o caminho absoluto para o diretório do arquivo. Por exemplo

. <path>\IoTEdgeSecurityDaemon.ps1
Update-IoTEdge -OfflineInstallationPath <path>

Para obter mais informações sobre opções de atualização, use o comando Get-Help Update-IoTEdge -full ou consulte scripts do PowerShell para IoT Edge utilizando contêineres do Windows.

A partir da versão 1.2, o serviço do IoT Edge usa um novo nome de pacote e tem algumas diferenças nos processos de instalação e configuração. Se você tiver um dispositivo IoT Edge executando a versão 1.0 ou 1.1, use estas instruções para saber como atualizar para a versão mais recente.

Algumas das principais diferenças entre a versão mais recente e a versão 1.1 e anterior incluem:

• O nome do pacote foi alterado de iotedge para aziot-edge.
• O pacote libiothsm-std não é mais usado. Se você usou o pacote padrão fornecido como parte da versão do IoT Edge, suas configurações poderão ser transferidas para a nova versão. Se você usou uma implementação diferente de libiothsm-std, todos os certificados fornecidos pelo usuário, como o certificado de identidade do dispositivo, a AC do dispositivo e o pacote de confiança, precisarão ser reconfigurados.
• Um novo serviço de identidade, aziot-identity-service foi introduzido como parte da versão 1.2. Esse serviço lida com o provisionamento e o gerenciamento de identidade do IoT Edge e outros componentes de dispositivos que precisam se comunicar com o Hub IoT, como Atualização de Dispositivo para o Hub IoT.
• O arquivo de configuração padrão tem um novo nome e local. Anteriormente /etc/iotedge/config.yaml, as informações de configuração do dispositivo agora devem estar em /etc/aziot/config.toml por padrão. O comando iotedge config import pode ser usado para ajudar a migrar informações de configuração do local e da sintaxe antigos para a nova.
  • O comando de importação não pode detectar ou modificar regras de acesso para o TPM (módulo de plataforma confiável) de um dispositivo. Se o dispositivo usar o atestado do TPM, você precisará atualizar manualmente o arquivo /etc/udev/rules.d/tpmaccess.rules para dar acesso ao serviço aziottpm. Para mais informações, consulte Conceder acesso do IoT Edge ao TPM.
• A API de carga de trabalho na versão mais recente salva segredos criptografados em um novo formato. Se você atualizar de uma versão mais antiga para a versão mais recente, a chave de criptografia mestra existente será importada. A API de carga de trabalho pode ler segredos salvos no formato anterior usando a chave de criptografia importada. No entanto, a API de carga de trabalho não pode gravar segredos criptografados no formato antigo. Depois que um segredo é criptografado novamente por um módulo, ele é salvo no novo formato. Os segredos criptografados na versão mais recente não podem ser lidos pelo mesmo módulo na versão 1.1. Se você persistir dados criptografados em uma pasta ou volume montado pelo host, sempre crie uma cópia de backup dos dados antes da atualização para poder fazer o downgrade, se necessário.
• Para compatibilidade com versões anteriores ao conectar dispositivos que não dão suporte ao TLS 1.2, você pode configurar o Hub do Edge para ainda aceitar o TLS 1.0 ou 1.1 por meio da variável de ambiente SslProtocols. Observe que o suporte para TLS 1.0 e 1.1 no Hub IoT é considerado herdado e também pode ser removido do Hub do Edge em versões futuras. Para evitar problemas futuros, use o TLS 1.2 como a única versão do TLS ao se conectar ao Hub do Edge ou ao Hub IoT.
• A versão prévia do agente MQTT experimental no Edge Hub 1.2 terminou e não está incluída no Edge Hub 1.3 ou posterior. Continuamos a refinar nossos planos para um agente MQTT com base nos comentários recebidos. Enquanto isso, se você precisar de um agente MQTT compatível com padrões no IoT Edge, considere implantar um agente de software livre, como o Mosquitto, como um módulo do IoT Edge.
• A partir da versão 1.2, quando uma imagem de backup é removida de um contêiner, o contêiner continua em execução e ele persiste entre reinicializações. Na versão 1.1, quando uma imagem de backup é removida, o contêiner é recriado imediatamente e a imagem de backup é atualizada.

Antes de automatizar os processos de atualização, valide se ele funciona em computadores de teste.

Quando estiver pronto, siga estas etapas para atualizar o IoT Edge em seus dispositivos:

1. Atualizar a ferramenta apt.

   sudo apt-get update
   

2. Desinstale a versão anterior do IoT Edge, deixando seus arquivos de configuração em vigor.

   sudo apt-get remove iotedge
   

3. Instale a versão mais recente do IoT Edge, juntamente com o serviço de identidade IoT e o micro agente do Microsoft Defender para IoT para Edge.

   sudo apt-get install aziot-edge defender-iot-micro-agent-edge
   

É recomendável instalar o micro agente com o agente do Edge para habilitar o monitoramento de segurança e a proteção de seus dispositivos do Edge. Para saber mais sobre o Microsoft Defender para IoT, consulte O que é o Microsoft Defender para IoT para compiladores de dispositivos.

1. Importe o arquivo config.yaml antigo para seu novo formato e aplique as informações de configuração.

   sudo iotedge config import
   

Não há suporte para o IoT Edge versão 1.1 no Red Hat Enterprise Linux 8.

Se você estiver usando contêineres do Windows ou IoT Edge para Linux no Windows, esta seção de caso especial não se aplicará.

Atualmente, não há suporte para o IoT Edge versão 1.2 ou posterior em execução em dispositivos Windows.