Gerencie os endpoints principais do dispositivo - AWS IoT Greengrass
Use o detector IP para gerenciar automaticamente os endpointsGerencie manualmente os endpoints

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

Gerencie os endpoints principais do dispositivo

Ao usar a descoberta na nuvem, você armazena endpoints de MQTT corretor para dispositivos principais no serviço de AWS IoT Greengrass nuvem. Os dispositivos cliente se conectam AWS IoT Greengrass para recuperar esses endpoints e outras informações para seus dispositivos principais associados.

Para cada dispositivo principal, você pode gerenciar endpoints automática ou manualmente.

  • Gerencie endpoints automaticamente com detector de IP

    Você pode implantar o componente detector de IP para gerenciar automaticamente os endpoints do dispositivo principal se tiver uma configuração de rede não complexa, como quando os dispositivos cliente estão na mesma rede do dispositivo principal. Você não pode usar o componente detector de IP se o dispositivo principal estiver atrás de um roteador que encaminha a porta do MQTT broker para o dispositivo principal, por exemplo.

    O componente detector de IP também é útil se você implantar em grupos de coisas, porque ele gerencia os endpoints de todos os dispositivos principais do grupo de coisas. Para obter mais informações, consulte Use o detector IP para gerenciar automaticamente os endpoints.

  • Gerencie manualmente os endpoints

    Se você não puder usar o componente detector de IP, deverá gerenciar manualmente os endpoints principais do dispositivo. Você pode atualizar esses endpoints com o console ou o. API Para obter mais informações, consulte Gerencie manualmente os endpoints.

Use o detector IP para gerenciar automaticamente os endpoints

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 para fazer o seguinte:

  • Monitore as informações de conectividade de rede local do dispositivo principal do Greengrass. Essas informações incluem os endpoints de rede do dispositivo principal e a porta em que o MQTT broker opera.

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

O componente detector de IP substitui 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 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 opte por 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 seguintes opções 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 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 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 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 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
}

    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 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 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 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 IP v2.2.0 ou posterior para usar essa opção.

O exemplo de documento de implantação parcial a seguir especifica o relatório da porta 8883 como a porta do MQTT intermediário.

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

Gerencie manualmente os endpoints

Você pode gerenciar manualmente os endpoints do MQTT broker para dispositivos principais.

Cada endpoint do MQTT broker tem as seguintes informações:

Ponto final () HostAddress

Um endereço IP ou DNS endereço em que os dispositivos do cliente podem se conectar a um MQTT corretor no dispositivo principal.

Port (Porta (PortNumber)

A porta em que o MQTT broker opera no dispositivo principal.

Você pode configurar essa porta no componente do MQTT agente Moquette, cujo padrão é usar a porta 8883.

Metadados () Metadata

Metadados adicionais para fornecer aos dispositivos clientes que se conectam a esse endpoint.

Gerenciar endpoints (console)

Você pode usar o AWS IoT Greengrass console para visualizar, atualizar e remover endpoints de um dispositivo principal.

Para gerenciar endpoints para um dispositivo principal (console)

  1. Escolha dispositivos principais.

  2. Escolha o dispositivo principal a ser gerenciado.

  3. Na página de detalhes do dispositivo principal, escolha a guia Dispositivos clientes.

  4. Na seção de endpoints do MQTT broker, você pode ver os endpoints do MQTT broker do dispositivo principal. Escolha Gerenciar endpoints.

  5. No modal Gerenciar endpoints, adicione ou remova endpoints do MQTT broker para o dispositivo principal.

  6. Selecione Atualizar.

Gerenciar endpoints ()AWS CLI

Você pode usar o AWS Command Line Interface (AWS CLI) para gerenciar endpoints de um dispositivo principal.

nota

Como o suporte ao dispositivo cliente AWS IoT Greengrass V2 é compatível com versões anteriores AWS IoT Greengrass V1, você pode usar AWS IoT Greengrass V2 nossas AWS IoT Greengrass V1 API operações para gerenciar os endpoints principais do dispositivo.

Para obter endpoints para um dispositivo principal ()AWS CLI
Para atualizar os endpoints de um dispositivo principal ()AWS CLI

Gerenciar endpoints () API

Você pode usar o AWS API para gerenciar endpoints de um dispositivo principal.

nota

Como o suporte ao dispositivo cliente AWS IoT Greengrass V2 é compatível com versões anteriores AWS IoT Greengrass V1, você pode usar AWS IoT Greengrass V2 nossas AWS IoT Greengrass V1 API operações para gerenciar os endpoints principais do dispositivo.

Para obter endpoints para um dispositivo principal ()AWS API
Para atualizar os endpoints de um dispositivo principal ()AWS API