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 cliente podem usar a descoberta de nuvem do Greengrass 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 Interagir com dispositivos de 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.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 é reiniciado 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 logs.

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:

  • 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 Política mínima de AWS IoT 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 Gerenciar endpoints do dispositivo principal do.

  • 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 é 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.

2.2.1

A tabela a seguir lista as dependências da versão 2.2.1 deste componente.

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

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

Dependência Versões compatíveis Tipo de dependência
Núcleo do 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 do 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 do 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 do 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 do 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 do 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 do 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 do 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 do 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 do 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 deste componente.

Dependência Versões compatíveis Tipo de dependência
Núcleo do 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 deste componente.

Dependência Versões compatíveis Tipo de dependência
Núcleo do Greengrass >=2.2.0 <2.3.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.

2.2.x
defaultPort

(Opcional) A porta do MQTT agente para relatar 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. Eles são endereços IP, como localhost, pelo qual um dispositivo pode se comunicar com ele 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. Eles são endereços IP, como localhost, pelo qual um dispositivo pode se comunicar com ele 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 como true. 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. Defina includeIPv4Addrs como false para usar essa opção.

Padrão: false

2.1.x
defaultPort

(Opcional) A porta do MQTT agente para relatar 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. Eles são endereços IP, como localhost, pelo qual um dispositivo pode se comunicar com ele 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. Eles são endereços IP, como localhost, pelo qual um dispositivo pode se comunicar com ele 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 de núcleo do Greengrass.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.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/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.

Versão

Alterações

2.2.1

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

2.2.0

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

Novos recursos

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

2.1.9
Correções de bugs e melhorias

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

2.1.8

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

2.1.7

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

2.1.6

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

2.1.5

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

2.1.4

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

2.1.3

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

2.1.2
Correções de bugs e melhorias

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

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

2.1.1

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

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 log mais claras.

2.0.2

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

2.0.1

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

2.0.0

Versão inicial.