Runtime do DLR - AWS IoT Greengrass
VersõesTipoSistema operacionalRequisitosDependênciasConfiguraçãoUsoArquivo de log localChangelog

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Runtime do DLR

O componente do runtime do DLR (variant.DLR) contém um script que instala o Runtime de aprendizado profundo (DLR) e as dependências dele em um ambiente virtual no seu dispositivo. Os componentes Classificação de imagens do DLR e Detecção de objetos do DLR usam esse componente como uma dependência para instalar o DLR. A versão 1.6.x do componente instala o DLR v1.6.0 e a versão 1.3.x do componente instala o DLR v1.3.0.

Para usar outro runtime, você pode aplicar a fórmula desse componente como modelo para criar um componente de machine learning personalizado.

Versões

Esse componente tem as seguintes versões:

  • 1.6.x

  • 1.3.x

Tipo

Esse é um componente genérico (aws.greengrass.generic). O núcleo do Greengrass executa os scripts do ciclo de vida do componente.

Para obter mais informações, consulte Tipos de componente.

Sistema operacional

Esse componente pode ser instalado em dispositivos principais que executam os seguintes sistemas operacionais:

  • Linux

  • Windows

Requisitos

Esse componente tem os seguintes requisitos:

  • Nos dispositivos principais do Greengrass que executam o Amazon Linux 2 ou o Ubuntu 18.04, a Biblioteca do GNU C (glibc) versão 2.27 ou posterior está instalada no dispositivo.

  • Em dispositivos Armv7l, como o Raspberry Pi, as dependências do OpenCV-Python estão instaladas no dispositivo. Execute o seguinte comando para instalar as dependências.

    sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev

  • Os dispositivos Raspberry Pi que executam o Raspberry Pi OS Bullseye devem atender aos seguintes requisitos:

    • NumPy 1.22.4 ou posterior instalado no dispositivo. O Raspberry Pi OS Bullseye inclui uma versão anterior do NumPy, então você pode executar o seguinte comando para atualizar NumPy o dispositivo.

      pip3 install --upgrade numpy

    • A pilha de câmeras antiga habilitada no dispositivo. O Raspberry Pi OS Bullseye inclui uma nova pilha de câmeras que está habilitada por padrão e não é compatível, portanto você precisa habilitar a pilha de câmeras antiga.

      Para habilitar a pilha de câmeras antiga

      1. Execute o comando abaixo para abrir a ferramenta de configuração do Raspberry Pi.

        sudo raspi-config

      2. Selecione Opções de interface.

      3. Selecione Câmera antiga para habilitar a pilha de câmeras antiga.

      4. Reinicie o Raspberry Pi.

Endpoints e portas

Por padrão, esse componente usa um script do instalador para instalar pacotes com os comandos apt, yum, brew e pip, dependendo da plataforma do dispositivo principal. Esse componente deve ser capaz de fazer solicitações de saída para vários índices e repositórios de pacotes para executar o script do instalador. Para permitir o tráfego de saída do componente por meio de um proxy ou firewall, você deve identificar os endpoints dos índices e repositórios de pacotes aos quais o seu dispositivo principal se conecta para a instalação.

Considere o seguinte quando for identificar os endpoints necessários para o script de instalação do componente:

  • Os endpoints dependem da plataforma do dispositivo principal. Por exemplo, um dispositivo principal com Ubuntu usa apt em vez de yum ou brew. Além disso, os dispositivos que usam o mesmo índice de pacotes podem ter listas de fontes diferentes e, portanto, podem recuperar pacotes de repositórios distintos.

  • Os endpoints podem ser diferentes entre os vários dispositivos que usam o mesmo índice de pacotes, já que cada dispositivo tem as próprias listas de fontes que definem onde recuperar os pacotes.

  • Os endpoints podem mudar ao longo do tempo. Cada índice URLs de pacotes fornece os repositórios nos quais você baixa pacotes, e o proprietário de um pacote pode alterar o que URLs o índice de pacotes fornece.

Para obter mais informações sobre as dependências que esse componente instala e como desabilitar o script do instalador, consulte o parâmetro de UseInstallerconfiguração.

Para obter mais informações sobre os endpoints e as portas necessários para operação básica, consulte Permitir o tráfego de dispositivos por meio de um proxy ou firewall.

Dependências

Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que é preciso atender aos requisitos do componente e de todas as dependências dele para implantá-lo com êxito. Nesta seção, há uma lista de todas as dependências das versões lançadas desse componente e as restrições de versão semântica que definem as versões dos componentes para cada dependência. Também é possível visualizar as dependências de cada versão do componente no console do AWS IoT Greengrass. Na página de detalhes do componente, procure a lista de dependências.

1.6.11 - 1.6.16

A tabela a seguir lista as dependências das versões 1.6.11 a 1.6.16 desse componente.

Dependência Versões compatíveis Tipo de dependência
Núcleo do Greengrass >=2.0.0 <3.0.0 Flexível
1.6.10

A tabela a seguir lista as dependências da versão 1.6.10 desse componente.

Dependência Versões compatíveis Tipo de dependência
Núcleo do Greengrass >=2.0.0 <2.9.0 Flexível
1.6.9

A tabela a seguir lista as dependências da versão 1.6.9 desse componente.

Dependência Versões compatíveis Tipo de dependência
Núcleo do Greengrass >=2.0.0 <2.8.0 Flexível
1.6.8

A tabela a seguir lista as dependências da versão 1.6.8 desse componente.

Dependência Versões compatíveis Tipo de dependência
Núcleo do Greengrass >=2.0.0 <2.7.0 Flexível
1.6.6 and 1.6.7

A tabela a seguir lista as dependências das versões 1.6.6 e 1.6.7 desse componente.

Dependência Versões compatíveis Tipo de dependência
Núcleo do Greengrass >=2.0.0 <2.6.0 Flexível
1.6.4 and 1.6.5

A tabela a seguir lista as dependências das versões 1.6.4 e 1.6.5 desse componente.

Dependência Versões compatíveis Tipo de dependência
Núcleo do Greengrass >=2.0.0 <2.5.0 Flexível
1.6.3

A tabela a seguir lista as dependências da versão 1.6.3 desse componente.

Dependência Versões compatíveis Tipo de dependência
Núcleo do Greengrass >=2.0.0 <2.4.0 Flexível
1.6.2

A tabela a seguir lista as dependências da versão 1.6.2 desse componente.

Dependência Versões compatíveis Tipo de dependência
Núcleo do Greengrass >=2.0.0 <2.3.0 Flexível
1.6.1

A tabela a seguir lista as dependências da versão 1.6.1 desse componente.

Dependência Versões compatíveis Tipo de dependência
Núcleo do Greengrass >=2.0.0 <2.2.0 Flexível
1.3.x

A tabela a seguir lista as dependências da versão 1.3.x desse componente.

Dependência Versões compatíveis Tipo de dependência
Núcleo do Greengrass ~2.0.0 Flexível

Para obter mais informações sobre as dependências dos componentes, consulte referência de fórmula do componente.

Configuração

Esse componente fornece os seguintes parâmetros de configuração que podem ser personalizados ao implantar o componente.

MLRootPath

(Opcional) O caminho da pasta nos dispositivos principais do Linux em que os componentes de inferência leem as imagens e gravam os resultados da inferência. É possível modificar esse valor em qualquer local no dispositivo no qual o usuário que está executando esse componente tenha acesso de leitura/gravação.

Padrão: /greengrass/v2/work/variant.DLR/greengrass_ml

WindowsMLRootPath

Esse recurso está disponível na versão 1.6.6 e mais recente desse componente.

(Opcional) O caminho da pasta nos dispositivos principais do Windows em que os componentes de inferência leem as imagens e gravam os resultados da inferência. É possível modificar esse valor em qualquer local no dispositivo no qual o usuário que está executando esse componente tenha acesso de leitura/gravação.

Padrão: C:\greengrass\v2\\work\\variant.DLR\\greengrass_ml

UseInstaller

(Opcional) Valor da string que define se o script do instalador deve ser usado nesse componente para instalar o DLR e as dependências dele. Os valores compatíveis são true e false.

Defina esse valor como false se você quiser usar um script personalizado para a instalação do DLR ou se quiser incluir dependências de runtime em uma imagem Linux pré-criada. Para usar esse componente com os componentes AWS de inferência DLR fornecidos, instale as bibliotecas a seguir, incluindo quaisquer dependências, e disponibilize-as para o usuário do sistema, como, por exemploggc_user, que executa os componentes de ML.

Padrão: true

Uso

Use esse componente com o parâmetro de configuração UseInstaller definido como true para instalar o DLR e as dependências dele em seu dispositivo. O componente configura um ambiente virtual em seu dispositivo que inclui o OpenCV NumPy e as bibliotecas necessárias para o DLR.

nota

O script do instalador nesse componente também instala as versões mais recentes das bibliotecas adicionais do sistema, que são necessárias para configurar o ambiente virtual em seu dispositivo e usar a estrutura de machine learning instalada. Isso pode atualizar as bibliotecas do sistema existentes em seu dispositivo. Consulte a tabela a seguir para ver a lista de bibliotecas que esse componente instala para cada sistema operacional compatível. Se você deseja personalizar esse processo de instalação, defina o parâmetro de configuração UseInstaller como false e desenvolva o próprio script do instalador.

Plataforma Bibliotecas instaladas no sistema do dispositivo Bibliotecas instaladas no ambiente virtual
Armv7l build-essential, cmake, ca-certificates, git setuptools, wheel
Amazon Linux 2 mesa-libGL Nenhum
Ubuntu wget Nenhum

Quando você implanta seu componente de inferência, esse componente de runtime primeiro verifica se seu dispositivo já tem o DLR e as dependências dele instaladas, caso contrário, ele instala para você.

Arquivo de log local

Esse componente usa o arquivo de log abaixo.

Linux
/greengrass/v2/logs/variant.DLR.log
Windows
C:\greengrass\v2\logs\variant.DLR.log
Para exibir os logs desse componente

  • Execute o comando a seguir no dispositivo principal para visualizar o arquivo de log desse componente em tempo real. Substitua /greengrass/v2 ou C:\greengrass\v2 pelo caminho para a pasta AWS IoT Greengrass raiz.

    Linux
    sudo tail -f /greengrass/v2/logs/variant.DLR.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\variant.DLR.log -Tail 10 -Wait

Changelog

A tabela a seguir descreve as alterações em cada versão do componente.

Versão

Alterações

1.6.16

Versão atualizada para o lançamento do núcleo do Greengrass versão 2.12.5.

1.6.12
Correções de bugs e melhorias

  • Corrige o script de instalação para usuários do sistema operacional Windows.

1.6.11

 Versão atualizada para o núcleo do Greengrass 2.9.0.

1.6.10

 Versão atualizada para o lançamento da versão 2.8.0 do núcleo do Greengrass.

1.6.9

Versão atualizada para o lançamento da versão 2.7.0 do núcleo do Greengrass.

1.6.8

Versão atualizada para o lançamento da versão 2.6.0 do núcleo do Greengrass.

1.6.7
Correções de bugs e melhorias

  • Atualiza o script de instalação UseInstaller para instalar a libGL, que não está disponível por padrão em determinadas plataformas Linux.

  • Atualiza o script de instalação UseInstaller para sempre usar o Python 3.9 no ambiente virtual desse componente. Essa alteração ajuda a garantir a compatibilidade com outras bibliotecas.

1.6.6
Novos recursos

  • Adiciona suporte para dispositivos principais que executam o Windows.

  • Adiciona o novo parâmetro de configuração WindowsMLRootPath, que você pode usar para configurar a pasta de resultados de inferência nos dispositivos principais do Windows.

1.6.5
Novos recursos

  • Adiciona o novo parâmetro de configuração UseInstaller que você pode usar para desativar o script de instalação nesse componente.

1.6.4

Versão atualizada para o lançamento da versão 2.4.0 do núcleo do Greengrass.

1.6.3

Versão atualizada para o lançamento da versão 2.3.0 do núcleo do Greengrass.

1.6.2

Versão atualizada para o lançamento do núcleo do Greengrass versão 2.2.0.

1.6.1
Novos recursos

  • Instale o Runtime de aprendizado profundo v1.6.0 e as dependências dele.

  • Adicione suporte para instalação de DLR em plataformas Armv8 ()AArch64. Isso amplia o suporte ao machine learning para os dispositivos principais do Greengrass que executam o NVIDIA Jetson, como o Jetson Nano.

Correções de bugs e melhorias

  • Instale o AWS IoT Device SDK no ambiente virtual para ler a configuração do componente e aplicar as alterações na configuração.

  • Correções de bugs secundárias e melhorias adicionais.

1.3.2

Versão inicial. Instala o DLR v1.3.0.