IP 감지기 - AWS IoT Greengrass
버전유형운영 체제요구 사항의존성구성로컬 로그 파일Changelog

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

IP 감지기

IP 탐지기 구성 요소 (aws.greengrass.clientdevices.IPDetector) 는 다음을 수행합니다.

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

  • AWS IoT Greengrass 클라우드 서비스에서 코어 디바이스의 연결 정보를 업데이트합니다.

클라이언트 디바이스는 Greengrass 클라우드 디스커버리를 사용하여 관련 코어 디바이스의 연결 정보를 검색할 수 있습니다. 그러면 클라이언트 디바이스가 성공적으로 연결될 때까지 각 코어 디바이스에 연결을 시도할 수 있습니다.

참고

클라이언트 디바이스는 Greengrass 코어 디바이스에 연결하여 처리할 MQTT 메시지와 데이터를 전송하는 로컬 IoT 디바이스입니다. 자세한 내용은 로컬 IoT 기기와 상호작용 단원을 참조하십시오.

IP 탐지기 구성요소는 코어 장치의 기존 연결 정보를 탐지된 정보로 대체합니다. 이 구성 요소는 기존 정보를 제거하므로 IP 감지기 구성 요소를 사용하거나 연결 정보를 수동으로 관리할 수 있습니다.

버전

이 구성 요소의 버전은 다음과 같습니다.

  • 2.2.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

유형

이 구성 요소는 플러그인 구성 요소 () aws.greengrass.plugin 입니다. Greengrass 핵은 핵과 동일한 자바 가상 머신 (JVM) 에서 이 컴포넌트를 실행합니다. 코어 디바이스에서 이 구성 요소의 버전을 변경하면 NUCLEUS가 다시 시작됩니다.

이 구성 요소는 Greengrass 핵과 동일한 로그 파일을 사용합니다. 자세한 내용은 모니터 AWS IoT Greengrass 로그 단원을 참조하십시오.

자세한 내용은 구성 요소 유형 단원을 참조하십시오.

운영 체제

이 구성 요소는 다음 운영 체제를 실행하는 코어 디바이스에 설치할 수 있습니다.

  • Linux

  • Windows

요구 사항

이 구성 요소의 요구 사항은 다음과 같습니다.

  • Greengrass 서비스 역할은 사용자 AWS 계정 및 권한에 연결되고 허용되어야 합니다. iot:GetThingShadow iot:UpdateThingShadow

  • 코어 디바이스의 AWS IoT 정책에서 greengrass:UpdateConnectivityInfo 권한을 허용해야 합니다. 자세한 내용은 데이터 영역 작업에 대한 AWS IoT 정책 및 클라이언트 AWS IoT 장치를 지원하기 위한 최소 정책 단원을 참조하세요.

  • 기본 포트 8883이 아닌 포트를 사용하도록 코어 디바이스의 MQTT 브로커 구성 요소를 구성하는 경우 IP detector v2.1.0 이상을 사용해야 합니다. 브로커가 작동하는 포트를 보고하도록 구성하십시오.

  • 복잡한 네트워크 설정을 사용하는 경우 IP 탐지기 구성 요소가 클라이언트 장치가 코어 장치에 연결할 수 있는 엔드포인트를 식별하지 못할 수 있습니다. IP 탐지기 구성 요소가 엔드포인트를 관리할 수 없는 경우 대신 코어 장치 엔드포인트를 수동으로 관리해야 합니다. 예를 들어, 코어 디바이스가 MQTT 브로커 포트를 전달하는 라우터 뒤에 있는 경우 라우터의 IP 주소를 코어 디바이스의 엔드포인트로 지정해야 합니다. 자세한 내용은 코어 디바이스 엔드포인트 관리 단원을 참조하십시오.

  • IP 탐지기 구성 요소는 VPC a에서 실행되도록 지원됩니다.

의존성

구성 요소를 배포하면 호환되는 버전의 종속 AWS IoT Greengrass 항목도 배포됩니다. 즉, 구성 요소를 성공적으로 배포하려면 구성 요소 및 해당 종속성에 대한 요구 사항을 모두 충족해야 합니다. 이 섹션에는 이 구성 요소의 릴리스된 버전에 대한 종속성과 각 종속성에 대한 구성 요소 버전을 정의하는 시맨틱 버전 제약 조건이 나열되어 있습니다. 콘솔에서 구성 요소의 각 버전에 대한 종속성을 볼 수도 있습니다.AWS IoT Greengrass 구성 요소 세부 정보 페이지에서 종속성 목록을 찾아보십시오.

2.2.0

다음 표에는 이 구성 요소의 버전 2.2.0에 대한 종속성이 나와 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.2.0 <2.14.0 소프트
2.2.0

다음 표에는 이 구성 요소의 버전 2.2.0에 대한 종속성이 나와 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.2.0 <2.14.0 소프트
2.1.8 – 2.1.9

다음 표에는 이 구성 요소의 버전 2.1.8 및 2.1.9에 대한 종속성이 나와 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.2.0 <2.13.0 소프트
2.1.7

다음 표에는 이 구성 요소의 버전 2.1.7에 대한 종속성이 나와 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.2.0 <2.12.0 소프트
2.1.6

다음 표에는 이 구성 요소의 버전 2.1.6에 대한 종속성이 나와 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.2.0 <2.11.0 소프트
2.1.5

다음 표에는 이 구성 요소의 버전 2.1.5에 대한 종속성이 나열되어 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.2.0 <2.10.0 소프트
2.1.4

다음 표에는 이 구성 요소의 버전 2.1.4에 대한 종속성이 나와 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.2.0 <2.9.0 소프트
2.1.3

다음 표에는 이 구성 요소의 버전 2.1.3에 대한 종속성이 나와 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.2.0 <2.8.0 소프트
2.1.2

다음 표에는 이 구성 요소의 버전 2.1.2에 대한 종속성이 나와 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.2.0 <2.7.0 소프트
2.1.1

다음 표에는 이 구성 요소의 버전 2.1.1에 대한 종속성이 나열되어 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.2.0 <2.6.0 소프트
2.1.0 and 2.0.2

다음 표에는 이 구성 요소의 버전 2.1.0 및 2.0.2에 대한 종속성이 나와 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.2.0 <2.5.0 소프트
2.0.1

다음 표에는 이 구성 요소의 버전 2.0.1에 대한 종속성이 나열되어 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.2.0 <2.4.0 소프트
2.0.0

다음 표에는 이 구성 요소의 버전 2.0.0에 대한 종속성이 나와 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.2.0 <2.3.0 소프트

구성 요소 종속성에 대한 자세한 내용은 구성 요소 레시피 참조를 참조하십시오.

구성

이 구성 요소는 구성 요소를 배포할 때 사용자 지정할 수 있는 다음과 같은 구성 매개 변수를 제공합니다.

2.2.x
defaultPort

(선택 사항) 이 구성 요소가 IP 주소를 탐지할 때 보고할 MQTT 브로커 포트입니다. 기본 포트 8883이 아닌 다른 포트를 사용하도록 MQTT 브로커를 구성하는 경우 이 매개 변수를 지정해야 합니다.

기본값: 8883

includeIPv4LoopbackAddrs

(선택 사항) 이 옵션을 사용하여 IPv4 루프백 주소를 탐지하고 보고할 수 있습니다. 이러한 IP 주소는 예를 들어 장치가 자체적으로 localhost 통신할 수 있는 IP 주소입니다. 코어 기기와 클라이언트 기기가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용하십시오.

기본값: false

(선택 사항) 이 옵션을 사용하여 IPv4 링크-로컬 주소를 탐지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 동적 호스트 구성 프로토콜 (DHCP) 이 없거나 정적으로 할당된 IP 주소가 없는 경우 이 옵션을 사용하십시오.

기본값: false

includeIPv6LoopbackAddrs

(선택 사항) 이 옵션을 사용하여 IPv6 루프백 주소를 탐지하고 보고할 수 있습니다. 이러한 IP 주소는 예를 들어 장치가 자체적으로 localhost 통신할 수 있는 IP 주소입니다. 코어 기기와 클라이언트 기기가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용하십시오. 이 옵션을 includeIPv4Addrs 사용하도록 false 설정하고 includeIPv6Addrs 사용하도록 설정해야 합니다. true

기본값: false

(선택 사항) 이 옵션을 활성화하여 IPv6 링크-로컬 주소를 탐지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 동적 호스트 구성 프로토콜 (DHCP) 이 없거나 정적으로 할당된 IP 주소가 없는 경우 이 옵션을 사용하십시오. 이 옵션을 includeIPv4Addrs 사용하려면 로 false 설정하고 includeIPv6Addrs 사용하도록 설정해야 합니다. true

기본값: false

includeIPv4Addrs

(선택 사항) 기본값은 로 설정됩니다true. 이 옵션을 활성화하여 코어 장치에 있는 IPv4 주소를 게시할 수 있습니다.

기본값: true

includeIPv6Addrs

(선택 사항) 이 옵션을 사용하여 코어 장치에 있는 IPv6 주소를 게시할 수 있습니다. 이 옵션을 includeIPv4Addrs false 사용하도록 설정합니다.

기본값: false

2.1.x
defaultPort

(선택 사항) 이 구성 요소가 IP 주소를 탐지할 때 보고할 MQTT 브로커 포트입니다. 기본 포트 8883이 아닌 다른 포트를 사용하도록 MQTT 브로커를 구성하는 경우 이 매개 변수를 지정해야 합니다.

기본값: 8883

includeIPv4LoopbackAddrs

(선택 사항) 이 옵션을 사용하여 IPv4 루프백 주소를 탐지하고 보고할 수 있습니다. 이러한 IP 주소는 예를 들어 장치가 자체적으로 localhost 통신할 수 있는 IP 주소입니다. 코어 기기와 클라이언트 기기가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용하십시오.

기본값: false

(선택 사항) 이 옵션을 사용하여 IPv4 링크-로컬 주소를 탐지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 동적 호스트 구성 프로토콜 (DHCP) 이 없거나 정적으로 할당된 IP 주소가 없는 경우 이 옵션을 사용하십시오.

기본값: false

2.0.x
includeIPv4LoopbackAddrs

(선택 사항) 이 옵션을 사용하여 IPv4 루프백 주소를 탐지하고 보고할 수 있습니다. 이러한 IP 주소는 예를 들어 장치가 자체적으로 localhost 통신할 수 있는 IP 주소입니다. 코어 기기와 클라이언트 기기가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용하십시오.

기본값: false

(선택 사항) 이 옵션을 사용하여 IPv4 링크-로컬 주소를 탐지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 동적 호스트 구성 프로토콜 (DHCP) 이 없거나 정적으로 할당된 IP 주소가 없는 경우 이 옵션을 사용하십시오.

기본값: false

로컬 로그 파일

이 구성 요소는 Greengrass 핵 구성 요소와 동일한 로그 파일을 사용합니다.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
이 구성 요소의 로그를 보려면

  • 코어 디바이스에서 다음 명령을 실행하여 이 구성 요소의 로그 파일을 실시간으로 확인합니다. 교체 /greengrass/v2 또는 C:\greengrass\v2 AWS IoT Greengrass 루트 폴더 경로와 함께

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

다음 표에는 각 구성 요소 버전의 변경 사항이 설명되어 있습니다.

버전

변경

2.2.0

그린그래스 뉴클리어스 버전 2.13.0 릴리스를 위해 버전이 업데이트되었습니다.

새로운 기능

  • IPv6에 대한 지원을 추가합니다. 이제 로컬 메시징에 사용할 IPv6 수 있습니다.

2.1.9
버그 수정 및 개선

  • 디버그 로그 수준에서만 로그를 전송하도록 IP 획득 단계를 조정합니다.

2.1.8

 그린그래스 뉴클리어스 버전 2.12.0 릴리스를 위해 버전이 업데이트되었습니다.

2.1.7

 그린그래스 뉴클리어스 버전 2.11.0 릴리스를 위해 버전이 업데이트되었습니다.

2.1.6

 그린그래스 뉴클리어스 버전 2.10.0 릴리스를 위해 버전이 업데이트되었습니다.

2.1.5

 Greengrass 뉴클리어스 버전 2.9.0 릴리스를 위해 버전이 업데이트되었습니다.

2.1.4

 Greengrass 뉴클리어스 버전 2.8.0 릴리스를 위해 버전이 업데이트되었습니다.

2.1.3

Greengrass 뉴클리어스 버전 2.7.0 릴리스를 위해 버전이 업데이트되었습니다.

2.1.2
버그 수정 및 개선

  • 특정 시나리오에서 이 구성 요소가 기록하는 오류 메시지를 개선합니다.

  • Greengrass 뉴클리어스 버전 2.6.0 릴리스를 위해 버전이 업데이트되었습니다.

2.1.1

Greengrass 뉴클리어스 버전 2.5.0 릴리스를 위해 버전이 업데이트되었습니다.

2.1.0
개선 사항

  • 기본이 아닌 브로커 포트를 사용할 수 있는 defaultPort 파라미터를 추가합니다. MQTT

  • 로그 메시지를 보다 명확하게 표시하도록 업데이트되었습니다.

2.0.2

그린그래스 뉴클리어스 버전 2.4.0 릴리스를 위해 버전이 업데이트되었습니다.

2.0.1

그린그래스 뉴클리어스 버전 2.3.0 릴리스를 위해 버전이 업데이트되었습니다.

2.0.0

초기 버전