코어 디바이스 엔드포인트 관리

클라우드 검색을 사용할 때 코어 디바이스의 MQTT 브로커 엔드포인트를 AWS IoT Greengrass 클라우드 서비스에 저장합니다. 클라이언트 디바이스는 AWS IoT Greengrass에 연결하여 연결된 코어 디바이스에 대한 이러한 엔드포인트 및 기타 정보를 검색합니다.

각 코어 디바이스에 대해 엔드포인트를 자동 또는 수동으로 관리할 수 있습니다.

IP 감지기로 엔드포인트 자동 관리

클라이언트 디바이스가 코어 디바이스와 동일한 네트워크에 있는 경우와 같이 네트워크 설정이 복잡하지 않은 경우 IP 감지기 구성 요소를 배포하여 코어 디바이스 엔드포인트를 자동으로 관리할 수 있습니다. 예를 들어 코어 디바이스가 MQTT 브로커 포트를 코어 디바이스로 전달하는 라우터 뒤에 있는 경우 IP 감지기 구성 요소를 사용할 수 없습니다.

IP 감지기 구성 요소는 사물 그룹에 배포하는 경우에도 사물 그룹의 모든 코어 디바이스에 대한 엔드포인트를 관리하기 때문에 유용합니다. 자세한 내용은 IP 감지기를 사용하여 엔드포인트 자동 관리 섹션을 참조하세요.
엔드포인트 수동 관리

IP 감지기 구성 요소를 사용할 수 없는 경우 코어 디바이스 엔드포인트를 수동으로 관리해야 합니다. 콘솔 또는 API를 사용하여 이러한 엔드포인트를 업데이트할 수 있습니다. 자세한 내용은 엔드포인트 수동 관리 섹션을 참조하세요.

IP 감지기를 사용하여 엔드포인트 자동 관리

코어 디바이스와 동일한 네트워크에 있는 클라이언트 디바이스와 같이 네트워크 설정이 간단한 경우에는 IP 감지기 구성 요소를 배포하여 다음을 수행할 수 있습니다.

Greengrass 코어 디바이스의 로컬 네트워크 연결 정보를 모니터링합니다. 이 정보에는 코어 디바이스의 네트워크 엔드포인트와 MQTT 브로커가 작동하는 포트가 포함됩니다.
코어 디바이스의 연결 정보를 AWS IoT Greengrass 클라우드 서비스에 보고합니다.

IP 감지기 구성 요소는 수동으로 설정한 엔드포인트를 덮어씁니다.

중요

코어 디바이스의 AWS IoT 정책에서 IP 감지기 구성 요소를 사용할 수 있는 greengrass:UpdateConnectivityInfo 권한을 허용해야 합니다. 자세한 내용은 데이터 영역 작업에 대한 AWS IoT 정책 및 AWS IoT 사물 정책 구성 단원을 참조하세요.

다음 중 하나를 수행하여 IP 감지기 구성 요소를 배포할 수 있습니다.

콘솔의 검색 구성 페이지를 사용합니다. 자세한 내용은 클라우드 검색 구성(콘솔) 섹션을 참조하세요.
IP 감지기를 포함하도록 배포를 생성 및 수정합니다. 콘솔, AWS CLI 또는 AWS API를 사용하여 배포를 관리할 수 있습니다. 자세한 내용은 배포 만들기 섹션을 참조하세요.

AWS IoT Greengrass 콘솔 탐색 메뉴에서 구성 요소를 선택합니다.
구성 요소 페이지의 퍼블릭 구성 요소 탭을 선택한 다음 aws.greengrass.clientdevices.IPDetector를 선택합니다.
aws.greengrass.clientdevices.IPDetector 페이지에서 배포를 선택합니다.
배포에 추가에서 수정할 기존 배포를 선택하거나 새 배포 생성을 선택하고 다음을 선택합니다.
새 배포 생성을 선택한 경우 배포의 대상 코어 디바이스 또는 사물 그룹을 선택합니다. 대상 지정 페이지의 배포 대상에서 코어 디바이스 또는 사물 그룹을 선택하고 다음을 선택합니다.
구성 요소 선택 페이지에서 aws.greengrass.clientdevices.IPDetector 구성 요소가 선택되었는지 확인하고 다음을 선택합니다.
구성 요소 구성 페이지에서 aws.greengrass.clientdevices.IPDetector를 선택하고 다음을 수행합니다.
1. 구성 요소 구성을 선택합니다.
2. aws.greengrass.clientdevices.IPDetector 구성 모달의 구성 업데이트 아래의 병합할 구성에서 구성 업데이트를 입력하여 IP 감지기 구성 요소를 구성할 수 있습니다. 다음 구성 옵션을 지정할 수 있습니다.
  - defaultPort – (선택 사항) 이 구성 요소가 IP 주소를 감지할 때 보고할 MQTT 브로커 포트입니다. 기본 포트 8883이 아닌 다른 포트를 사용하도록 MQTT 브로커를 구성하는 경우 이 파라미터를 지정해야 합니다.
  - includeIPv4LoopbackAddrs – (선택 사항) 이 옵션을 활성화하여 IPv4 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: localhost)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다.
  - includeIPv4LinkLocalAddrs – (선택 사항) 이 옵션을 활성화하여 IPv4 링크-로컬 주소를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 DHCP(Dynamic Host Configuration Protocol) 또는 정적 할당 IP 주소가 없는 경우 이 옵션을 사용합니다.
  - includeIPv6LoopbackAddrs – (선택 사항) 이 옵션을 활성화하여 IPv6 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: localhost)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다. 이 옵션을 사용하려면 includeIPv4Addrs를 false, includeIPv6Addrs를 true로 설정해야 합니다. 이 옵션을 사용하려면 IP 감지기 v2.2.0 이상이 있어야 합니다.
  - includeIPv6LinkLocalAddrs – (선택 사항) 이 옵션을 활성화하여 IPv6 링크-로컬 주소를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 DHCP(Dynamic Host Configuration Protocol) 또는 정적 할당 IP 주소가 없는 경우 이 옵션을 사용합니다. 이 옵션을 사용하려면 includeIPv4Addrs를 false, includeIPv6Addrs를 true로 설정해야 합니다. 이 옵션을 사용하려면 IP 감지기 v2.2.0 이상이 있어야 합니다.
  - includeIPv4Addrs – (선택 사항) 기본값은 true로 설정됩니다. 이 옵션을 활성화하여 코어 디바이스에서 찾은 IPv4 주소를 게시할 수 있습니다. 이 옵션을 사용하려면 IP 감지기 v2.2.0 이상이 있어야 합니다.
  - includeIPv6Addrs – (선택 사항) 이 옵션을 활성화하여 코어 디바이스에서 찾은 IPv6 주소를 게시할 수 있습니다. 이 옵션을 사용하려면 includeIPv4Addrs를 false로 설정합니다. 이 옵션을 사용하려면 IP 감지기 v2.2.0 이상이 있어야 합니다.
  구성 업데이트는 다음 예제와 유사할 수 있습니다.
```
{
  "defaultPort": "8883",
  "includeIPv4LoopbackAddrs": false,
  "includeIPv4LinkLocalAddrs": false
}
```
3. 확인을 선택하여 모달을 닫고 다음을 선택합니다.
고급 설정 구성 페이지에서 기본 구성 설정을 유지하고 다음을 선택합니다.
검토 페이지에서 배포를 선택합니다.

배포를 완료하는 데 1분 정도 걸릴 수 있습니다.

IP 감지기 구성 요소를 배포하려면 components 객체에 aws.greengrass.clientdevices.IPDetector를 포함하는 배포 문서를 생성하고 구성 요소에 대한 구성 업데이트를 지정합니다. 배포 만들기의 지침에 따라 새 배포를 생성하거나 기존 배포를 수정합니다.

배포 문서를 생성하는 경우 다음 옵션 중 하나를 지정하여 IP 감지기 구성 요소를 구성할 수 있습니다.

defaultPort – (선택 사항) 이 구성 요소가 IP 주소를 감지할 때 보고할 MQTT 브로커 포트입니다. 기본 포트 8883이 아닌 다른 포트를 사용하도록 MQTT 브로커를 구성하는 경우 이 파라미터를 지정해야 합니다.
includeIPv4LoopbackAddrs – (선택 사항) 이 옵션을 활성화하여 IPv4 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: localhost)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다.
includeIPv4LinkLocalAddrs – (선택 사항) 이 옵션을 활성화하여 IPv4 링크-로컬 주소를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 DHCP(Dynamic Host Configuration Protocol) 또는 정적 할당 IP 주소가 없는 경우 이 옵션을 사용합니다.
includeIPv6LoopbackAddrs – (선택 사항) 이 옵션을 활성화하여 IPv6 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: localhost)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다. 이 옵션을 사용하려면 includeIPv4Addrs를 false, includeIPv6Addrs를 true로 설정해야 합니다. 이 옵션을 사용하려면 IP 감지기 v2.2.0 이상이 있어야 합니다.
includeIPv6LinkLocalAddrs – (선택 사항) 이 옵션을 활성화하여 IPv6 링크-로컬 주소를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 DHCP(Dynamic Host Configuration Protocol) 또는 정적 할당 IP 주소가 없는 경우 이 옵션을 사용합니다. 이 옵션을 사용하려면 includeIPv4Addrs를 false, includeIPv6Addrs를 true로 설정해야 합니다. 이 옵션을 사용하려면 IP 감지기 v2.2.0 이상이 있어야 합니다.
includeIPv4Addrs – (선택 사항) 기본값은 true로 설정됩니다. 이 옵션을 활성화하여 코어 디바이스에서 찾은 IPv4 주소를 게시할 수 있습니다. 이 옵션을 사용하려면 IP 감지기 v2.2.0 이상이 있어야 합니다.
includeIPv6Addrs – (선택 사항) 이 옵션을 활성화하여 코어 디바이스에서 찾은 IPv6 주소를 게시할 수 있습니다. 이 옵션을 사용하려면 includeIPv4Addrs를 false로 설정합니다. 이 옵션을 사용하려면 IP 감지기 v2.2.0 이상이 있어야 합니다.

다음 부분 배포 문서 예제에서는 포트 8883을 MQTT 브로커 포트로 보고하도록 지정합니다.


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

엔드포인트 수동 관리

코어 디바이스의 MQTT 브로커 엔드포인트를 수동으로 관리할 수 있습니다.

각 MQTT 브로커 엔드포인트에 대한 정보는 다음과 같습니다.

엔드포인트(HostAddress)

클라이언트 디바이스가 코어 디바이스의 MQTT 브로커에 연결할 수 있는 IP 주소 또는 DNS 주소입니다.

포트 (PortNumber)

코어 디바이스에서 MQTT 브로커가 작동하는 포트입니다.

기본적으로 포트 8883을 사용하는 Moquette MQTT 브로커 구성 요소에서 이 포트를 구성할 수 있습니다.

메타데이터(Metadata)

이 엔드포인트에 연결하는 클라이언트 디바이스에 제공할 추가 메타데이터입니다.

주제

엔드포인트 관리(콘솔)
엔드포인트 관리(AWS CLI)
엔드포인트 관리(API)

엔드포인트 관리(콘솔)

AWS IoT Greengrass 콘솔을 사용하여 코어 디바이스의 엔드포인트를 보고 업데이트하고 제거할 수 있습니다.

코어 디바이스의 엔드포인트를 관리하려면(콘솔)

AWS IoT Greengrass 콘솔로 이동합니다.
코어 디바이스를 선택합니다.
관리할 코어 디바이스를 선택합니다.
코어 디바이스의 세부 정보 페이지에서 클라이언트 디바이스 탭을 선택합니다.
MQTT 브로커 엔드포인트 섹션에서 코어 디바이스의 MQTT 브로커 엔드포인트를 볼 수 있습니다. 엔드포인트 관리를 선택합니다.
엔드포인트 관리 모달에서 코어 디바이스의 MQTT 브로커 엔드포인트를 추가하거나 제거합니다.
업데이트를 선택합니다.

엔드포인트 관리(AWS CLI)

AWS Command Line Interface(AWS CLI)를 사용하여 코어 디바이스의 엔드포인트를 관리할 수 있습니다.

참고

AWS IoT Greengrass V2의 클라이언트 디바이스 지원은 이전 버전 AWS IoT Greengrass V1과 호환되므로 AWS IoT Greengrass V2 또는 AWS IoT Greengrass V1 API 작업을 사용하여 코어 디바이스 엔드포인트를 관리할 수 있습니다.