Use IPv6 para mensagens locais - AWS IoT Greengrass
Configurar o detector 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á.

Use IPv6 para mensagens locais

Você pode configurar o componente detector de IP a ser usado IPv6 para enviar mensagens locais.

nota

Você deve ter o detector de IP v2.2.0 ou posterior para usar IPv6 para enviar mensagens locais.

Você pode implantar o componente detector de IP para detectar e usar IPv6 endereços. Você deve atualizar a configuração do componente detector de IP a ser usado IPv6 em vez doIPv4. Para obter mais informações, consulte Use o detector IP para gerenciar automaticamente os endpoints.

Configurar o detector IP para usar IPv6

Se você tiver uma configuração de rede simples, como os dispositivos cliente na mesma rede do dispositivo principal, poderá implantar o componente detector de IP IPv6 para uso em mensagens locais.

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

Importante

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

Você pode fazer o seguinte para implantar o componente detector de IP:

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

  • Crie e revise implantações para incluir o detector de IP. Você pode usar o console ou AWS API para gerenciar implantações. AWS CLI Para obter mais informações, consulte Criar implantações.

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

  2. Na página Componentes, escolha a guia Componentes públicos e, em seguida, escolha 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 escolha criar uma nova implantação e, em seguida, escolha Avançar.

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

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

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

    1. Escolha Configurar componente.

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

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

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

      • includeIPv4LinkLocalAddrs— (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.

      • 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. Você deve ter o detector de IP v2.2.0 ou posterior para usar essa opção.

      • includeIPv6LinkLocalAddrs— (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. Você deve ter o detector de IP v2.2.0 ou posterior para usar essa opção.

      • includeIPv4Addrs— (Opcional) O padrão é definido como verdadeiro. Você pode ativar essa opção para publicar IPv4 endereços encontrados no dispositivo principal. Você deve ter o detector de IP v2.2.0 ou posterior para usar essa opção.

      • includeIPv6Addrs— (Opcional) Você pode ativar essa opção para publicar IPv6 endereços encontrados no dispositivo principal. includeIPv4AddrsDefina false para usar essa opção. Você deve ter o detector de IP v2.2.0 ou posterior para usar essa opção.

      A atualização da 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 Review, escolha Deploy.

    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 components objeto e especifique a atualização de configuração do componente. Siga as instruções Criar implantações para criar uma nova implantação ou revisar uma implantação existente.

Você pode especificar qualquer uma das seguintes opções para configurar o componente do detector de IP ao criar o documento de implantação:

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

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

  • includeIPv4LinkLocalAddrs— (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.

  • 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. Você deve ter o detector de IP v2.2.0 ou posterior para usar essa opção.

  • includeIPv6LinkLocalAddrs— (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. Você deve ter o detector de IP v2.2.0 ou posterior para usar essa opção.

  • includeIPv4Addrs— (Opcional) O padrão é definido como verdadeiro. Você pode ativar essa opção para publicar IPv4 endereços encontrados no dispositivo principal. Você deve ter o detector de IP v2.2.0 ou posterior para usar essa opção.

  • includeIPv6Addrs— (Opcional) Você pode ativar essa opção para publicar IPv6 endereços encontrados no dispositivo principal. includeIPv4AddrsDefina false para usar essa opção. Você deve ter o detector de IP v2.2.0 ou posterior para usar essa opção.

O exemplo de documento de implantação parcial a seguir especifica o usoIPv6.

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