Usar IPv6 para mensagens locais - AWS IoT Greengrass
Configurar o detector de IP para usar IPv6

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

Usar IPv6 para mensagens locais

É possível configurar o componente detector de IP para usar IPv6 para enviar mensagens locais.

nota

É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar IPv6 para enviar mensagens locais.

É possível implantar o componente detector de IP para detectar e usar endereços IPv6. É necessário atualizar a configuração do componente detector de IP para usar IPv6 em vez de IPv4. Para obter mais informações, consulte Use o detector de IP para gerenciar automaticamente os endpoints.

Configurar o detector de IP para usar IPv6

Se você tem uma configuração de rede simples, por exemplo, os dispositivos cliente estão na mesma rede que o dispositivo principal, pode implantar o componente detector de IP para usar IPv6 para mensagens locais.

O componente detector de IP substitui os endpoints que você define manualmente.

Importante

A política AWS IoT do dispositivo principal deve conceder a permissão greengrass:UpdateConnectivityInfo para usar o componente detector de IP. Para obter mais informações, consulte AWS IoT políticas para operações de plano de dados e Configure a política da AWS IoT coisa.

É possível executar uma das seguintes ações para implantar o componente detector de IP:

  • Usar a página Configurar a descoberta no console. Para obter mais informações, consulte Configurar a descoberta na nuvem (console).

  • Criar e revisar as implantações para incluir o detector de IP. É possível usar o console, a AWS CLI ou a API da AWS para gerenciar implantações. Para obter mais informações, consulte Criar implantações.

  1. No menu de navegação do console do AWS IoT Greengrass, selecione Componentes.

  2. Na página Componentes, escolha a guia Componentes públicos e aws.greengrass.clientdevices.IPDetector.

  3. Na página aws.greengrass.clientdevices.IPDetector, escolha Implantar.

  4. Em Adicionar à implantação, escolha uma implantação existente para revisar ou opte por criar uma nova e, em seguida, escolha Avançar.

  5. Se você criar uma nova implantação, escolha o dispositivo principal ou grupo de objetos de destino para ela. Na página Especificar destino, em Destino de implantação, escolha um dispositivo principal ou grupo de objetos e, depois, Avançar.

  6. Na página Selecionar componentes, verifique se o componente aws.greengrass.clientdevices.IPDetector está selecionado e escolha Avançar.

  7. Na página Configurar componentes, selecione aws.greengrass.clientdevices.IPDetector e faça o seguinte:

    1. Escolha Configurar componente.

    2. No modal Configurar aws.greengrass.clientdevices.IPDetector, em Atualização de configuração e Configuração a ser mesclada, você pode inserir uma atualização de configuração para configurar o componente detector de IP. Você também pode especificar qualquer uma das opções de configuração a seguir. Defina includeIPv4Addrs como false e includeIPv6Addrs como true. Na sequência, você pode atualizar as outras opções de configuração de IPv6.

      • defaultPort: (opcional) a porta do agente MQTT para relatar quando esse componente detecta endereços IP. É necessário especificar esse parâmetro se configurar o agente MQTT para usar uma porta diferente da porta padrão 8883.

      • includeIPv4LoopbackAddrs – (opcional): você pode ativar essa opção para detectar e relatar endereços de loopback IPv4. Esses são endereços IP, como, por exemplo, localhost, em que 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.

      • includeIPv4LinkLocalAddrs (opcional): você pode ativar essa opção para detectar e relatar endereços locais de links IPv4. Use essa opção se a rede do dispositivo principal não tiver o Protocolo de Configuração Dinâmica de Host (DHCP) ou endereços IP atribuídos estaticamente.

      • includeIPv6LoopbackAddrs – (opcional): você pode ativar essa opção para detectar e relatar endereços de loopback IPv6. Esses são endereços IP, como, por exemplo, localhost, em que 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. É necessário definir includeIPv4Addrs como false e includeIPv6Addrs como true para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.

      • includeIPv6LinkLocalAddrs (opcional): você pode ativar essa opção para detectar e relatar endereços locais de links IPv6. Use essa opção se a rede do dispositivo principal não tiver o Protocolo de Configuração Dinâmica de Host (DHCP) ou endereços IP atribuídos estaticamente. É necessário definir includeIPv4Addrs como false e includeIPv6Addrs como true para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.

      • includeIPv4Addrs – (opcional): o padrão é definido como verdadeiro. É possível habilitar essa opção para publicar endereços IPv4 encontrados no dispositivo principal. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.

      • includeIPv6Addrs – (opcional) você pode habilitar essa opção para publicar endereços IPv6 encontrados no dispositivo principal. Defina includeIPv4Addrs como false para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.

      A atualização de configuração pode ser semelhante ao exemplo a seguir.

      {
  "defaultPort": "8883",
  "includeIPv4LoopbackAddrs": false,
  "includeIPv4LinkLocalAddrs": false,
  "includeIPv6LoopbackAddrs": true,
  "includeIPv6LinkLocalAddrs": true,
  "includeIPv4Addrs": false,
  "includeIPv6Addrs": true
}

    3. Escolha Confirmar para fechar o modal e, em seguida, escolha Avançar.

  8. Na página Definir configurações avançadas, mantenha as configurações padrão e escolha Avançar.

  9. Na página Pré-visualizar, escolha Implantar.

    A implantação pode levar até um minuto para ser concluída.

Para implantar o componente detector de IP, crie um documento de implantação que inclua aws.greengrass.clientdevices.IPDetector no objeto components e especifique a atualização de configuração do componente. Siga as instruções em Criar implantações para criar uma nova implantação ou revisar uma existente.

É possível especificar qualquer uma das seguintes opções para configurar o componente detector de IP ao criar o documento de implantação:

  • defaultPort (opcional): a porta do agente MQTT para relatar quando esse componente detecta endereços IP. É necessário especificar esse parâmetro se configurar o agente MQTT para usar uma porta diferente da porta padrão 8883.

  • includeIPv4LoopbackAddrs – (opcional): você pode ativar essa opção para detectar e relatar endereços de loopback IPv4. Esses são endereços IP, como, por exemplo, localhost, em que 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.

  • includeIPv4LinkLocalAddrs (opcional): você pode ativar essa opção para detectar e relatar endereços locais de links IPv4. Use essa opção se a rede do dispositivo principal não tiver o Protocolo de Configuração Dinâmica de Host (DHCP) ou endereços IP atribuídos estaticamente.

  • includeIPv6LoopbackAddrs – (opcional): você pode ativar essa opção para detectar e relatar endereços de loopback IPv6. Esses são endereços IP, como, por exemplo, localhost, em que 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. É necessário definir includeIPv4Addrs como false e includeIPv6Addrs como true para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.

  • includeIPv6LinkLocalAddrs (opcional): você pode ativar essa opção para detectar e relatar endereços locais de links IPv6. Use essa opção se a rede do dispositivo principal não tiver o Protocolo de Configuração Dinâmica de Host (DHCP) ou endereços IP atribuídos estaticamente. É necessário definir includeIPv4Addrs como false e includeIPv6Addrs como true para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.

  • includeIPv4Addrs (opcional): o padrão é definido como verdadeiro. É possível habilitar essa opção para publicar endereços IPv4 encontrados no dispositivo principal. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.

  • includeIPv6Addrs: (opcional) você pode habilitar essa opção para publicar endereços IPv6 encontrados no dispositivo principal. Defina includeIPv4Addrs como false para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.

O exemplo de documento de implantação parcial a seguir especifica o uso do IPv6.

{
  ...,
  "components": {
    ...,
    "aws.greengrass.clientdevices.IPDetector": {
      "componentVersion": "2.1.1",
      "configurationUpdate": {
        "merge": "{\"defaultPort\":\"8883\",}"
      }
    }
  }
}