Detector IP - AWS IoT Greengrass
VersõesTipoSistema operacionalRequisitosDependênciasConfiguraçãoArquivo 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á.

Detector IP

O componente detector de IP (aws.greengrass.clientdevices.IPDetector) faz o seguinte:

  • Monitora as informações de conectividade de rede do dispositivo principal do Greengrass. Essas informações incluem os endpoints de rede do dispositivo principal e a porta em que um MQTT agente opera.

  • Atualiza as informações de conectividade do dispositivo principal no serviço de AWS IoT Greengrass nuvem.

Os dispositivos clientes podem usar o Greengrass Cloud Discovery para recuperar as informações de conectividade dos dispositivos principais associados. Em seguida, os dispositivos cliente podem tentar se conectar a cada dispositivo principal até que se conectem com sucesso.

nota

Os dispositivos cliente são dispositivos IoT locais que se conectam a um dispositivo principal do Greengrass para enviar MQTT mensagens e dados para processamento. Para obter mais informações, consulte Interaja com dispositivos IoT locais.

O componente detector de IP substitui as informações de conectividade existentes de um dispositivo principal pelas informações que ele detecta. Como esse componente remove as informações existentes, você pode usar o componente detector de IP ou gerenciar manualmente as informações de conectividade.

Versões

Esse componente tem as seguintes versões:

  • 2.2.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipo

Este componente é um componente de plug-in (aws.greengrass.plugin). O núcleo do Greengrass executa esse componente na mesma Java Virtual Machine (JVM) do núcleo. O núcleo reinicia quando você altera a versão desse componente no dispositivo principal.

Esse componente usa o mesmo arquivo de log do núcleo do Greengrass. Para obter mais informações, consulte Monitore AWS IoT Greengrass os registros.

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

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:

  • A função de serviço do Greengrass deve estar associada às suas Conta da AWS e permitir as permissões iot:GetThingShadow e. iot:UpdateThingShadow

  • A AWS IoT política do dispositivo principal deve permitir a greengrass:UpdateConnectivityInfo permissão. Para ter mais informações, consulte Políticas do AWS IoT para operações de plano de dados e AWS IoTPolítica mínima para oferecer suporte aos dispositivos do cliente.

  • Se você configurar o componente MQTT intermediário do dispositivo principal para usar uma porta diferente da porta padrão 8883, deverá usar o detector de IP v2.1.0 ou posterior. Configure-o para relatar a porta em que o agente opera.

  • Se você tiver uma configuração de rede complexa, o componente detector de IP talvez não consiga identificar os endpoints nos quais os dispositivos cliente podem se conectar ao dispositivo principal. Se o componente detector de IP não puder gerenciar os endpoints, você deverá gerenciar manualmente os endpoints do dispositivo principal. Por exemplo, se o dispositivo principal estiver atrás de um roteador que encaminha a porta do MQTT broker para ele, você deverá especificar o endereço IP do roteador como um endpoint para o dispositivo principal. Para obter mais informações, consulte Gerencie os endpoints principais do dispositivo.

  • O componente detector de IP é suportado para ser executado em umVPC.

Dependências

Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que você deve atender aos requisitos do componente e de todas as suas dependências para implantá-lo com êxito. Esta seção lista 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. Você também pode visualizar as dependências de cada versão do componente no AWS IoT Greengrass console. Na página de detalhes do componente, procure a lista de dependências.

2.2.0

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=2.2.0 <2.14.0 Flexível
2.2.0

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=2.2.0 <2.14.0 Flexível
2.1.8 – 2.1.9

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=2.2.0 <2.13.0 Flexível
2.1.7

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=2.2.0 <2.12.0 Flexível
2.1.6

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=2.2.0 <2.11.0 Flexível
2.1.5

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=2.2.0 <2.10.0 Flexível
2.1.4

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

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

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

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

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=2.2.0 <2.7.0 Flexível
2.1.1

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=2.2.0 <2.6.0 Flexível
2.1.0 and 2.0.2

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

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

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

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

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

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

Para obter mais informações sobre dependências de componentes, consulte a referência da receita do componente.

Configuração

Esse componente fornece os seguintes parâmetros de configuração que você pode personalizar ao implantar o componente.

2.2.x
defaultPort

(Opcional) A porta do MQTT agente a ser relatada quando esse componente detecta endereços IP. Você deve especificar esse parâmetro se configurar o MQTT broker para usar uma porta diferente da porta padrão 8883.

Padrão: 8883

includeIPv4LoopbackAddrs

(Opcional) Você pode ativar essa opção para detectar e relatar endereços de IPv4 loopback. Esses são endereços IP, como, por exemplolocalhost, onde um dispositivo pode se comunicar consigo mesmo. Use essa opção em ambientes de teste em que o dispositivo principal e o dispositivo cliente são executados no mesmo sistema.

Padrão: false

(Opcional) Você pode ativar essa opção para detectar e relatar endereços IPv4 locais de links. Use essa opção se a rede do dispositivo principal não tiver o Dynamic Host Configuration Protocol (DHCP) ou endereços IP atribuídos estaticamente.

Padrão: false

includeIPv6LoopbackAddrs

(Opcional) Você pode ativar essa opção para detectar e relatar endereços de IPv6 loopback. Esses são endereços IP, como, por exemplolocalhost, onde um dispositivo pode se comunicar consigo mesmo. Use essa opção em ambientes de teste em que o dispositivo principal e o dispositivo cliente são executados no mesmo sistema. Você deve includeIPv4Addrs definir como false e includeIPv6Addrs true para usar essa opção.

Padrão: false

(Opcional) Você pode ativar essa opção para detectar e relatar endereços IPv6 locais de links. Use essa opção se a rede do dispositivo principal não tiver o Dynamic Host Configuration Protocol (DHCP) ou endereços IP atribuídos estaticamente. Você deve includeIPv4Addrs definir como false e includeIPv6Addrs true para usar essa opção.

Padrão: false

includeIPv4Addrs

(Opcional) O padrão é definido comotrue. Você pode ativar essa opção para publicar IPv4 endereços encontrados no dispositivo principal.

Padrão: true

includeIPv6Addrs

(Opcional) Você pode ativar essa opção para publicar IPv6 endereços encontrados no dispositivo principal. includeIPv4AddrsDefina false para usar essa opção.

Padrão: false

2.1.x
defaultPort

(Opcional) A porta do MQTT agente a ser relatada quando esse componente detecta endereços IP. Você deve especificar esse parâmetro se configurar o MQTT broker para usar uma porta diferente da porta padrão 8883.

Padrão: 8883

includeIPv4LoopbackAddrs

(Opcional) Você pode ativar essa opção para detectar e relatar endereços de IPv4 loopback. Esses são endereços IP, como, por exemplolocalhost, onde um dispositivo pode se comunicar consigo mesmo. Use essa opção em ambientes de teste em que o dispositivo principal e o dispositivo cliente são executados no mesmo sistema.

Padrão: false

(Opcional) Você pode ativar essa opção para detectar e relatar endereços IPv4 locais de links. Use essa opção se a rede do dispositivo principal não tiver o Dynamic Host Configuration Protocol (DHCP) ou endereços IP atribuídos estaticamente.

Padrão: false

2.0.x
includeIPv4LoopbackAddrs

(Opcional) Você pode ativar essa opção para detectar e relatar endereços de IPv4 loopback. Esses são endereços IP, como, por exemplolocalhost, onde um dispositivo pode se comunicar consigo mesmo. Use essa opção em ambientes de teste em que o dispositivo principal e o dispositivo cliente são executados no mesmo sistema.

Padrão: false

(Opcional) Você pode ativar essa opção para detectar e relatar endereços IPv4 locais de links. Use essa opção se a rede do dispositivo principal não tiver o Dynamic Host Configuration Protocol (DHCP) ou endereços IP atribuídos estaticamente.

Padrão: false

Arquivo de log local

Esse componente usa o mesmo arquivo de log do componente do núcleo do Greengrass.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Para ver os registros desse componente

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

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

Changelog

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

Version (Versão)

Alterações

2.2.0

Versão atualizada para a versão 2.13.0 do Greengrass nucleus.

Novos atributos

  • Adiciona suporte para IPv6. Agora você pode usar IPv6 para mensagens locais.

2.1.9
Correções de erros e melhorias

  • Ajusta a etapa de aquisição do IP para enviar somente registros no nível do registro de depuração.

2.1.8

 Versão atualizada para a versão 2.12.0 do Greengrass nucleus.

2.1.7

 Versão atualizada para a versão 2.11.0 do Greengrass nucleus.

2.1.6

 Versão atualizada para a versão 2.10.0 do Greengrass nucleus.

2.1.5

 Versão atualizada para a versão 2.9.0 do Greengrass nucleus.

2.1.4

 Versão atualizada para a versão 2.8.0 do Greengrass nucleus.

2.1.3

Versão atualizada para a versão 2.7.0 do Greengrass nucleus.

2.1.2
Correções de erros e melhorias

  • Melhora as mensagens de erro que esse componente registra em determinados cenários.

  • Versão atualizada para a versão 2.6.0 do Greengrass nucleus.

2.1.1

Versão atualizada para a versão 2.5.0 do Greengrass nucleus.

2.1.0
Melhorias

  • Adiciona o defaultPort parâmetro, que permite usar uma porta de MQTT agente não padrão.

  • Atualizações para tornar as mensagens de registro mais claras.

2.0.2

Versão atualizada para a versão 2.4.0 do Greengrass nucleus.

2.0.1

Versão atualizada para a versão 2.3.0 do Greengrass nucleus.

2.0.0

Versão inicial.