로컬 디버그 콘솔 - AWS IoT Greengrass

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

로컬 디버그 콘솔

로컬 디버그 콘솔 구성 요소 (aws.greengrass.LocalDebugConsole) 는 AWS IoT Greengrass 핵심 장치 및 해당 구성 요소에 대한 정보를 표시하는 로컬 대시보드를 제공합니다. 이 대시보드를 사용하여 핵심 장치를 디버깅하고 로컬 구성 요소를 관리할 수 있습니다.

중요

이 구성 요소는 프로덕션 환경이 아닌 개발 환경에서만 사용하는 것이 좋습니다. 이 구성 요소를 사용하면 일반적으로 프로덕션 환경에서는 필요하지 않은 정보와 작업에 액세스할 수 있습니다. 이 구성 요소를 필요한 핵심 장치에만 배포하여 최소 권한 원칙을 따르세요.

버전

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

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

유형

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

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

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

운영 체제

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

  • Linux

  • Windows

요구 사항

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

  • 사용자 이름과 암호를 사용하여 대시보드에 로그인합니다. 사용자 이름 () 이 제공됩니다. debug 를 사용하여 코어 디바이스의 AWS IoT Greengrass CLI 대시보드에서 사용자를 인증하는 임시 비밀번호를 만들어야 합니다. 를 사용하여 로컬 디버그 AWS IoT Greengrass CLI 콘솔을 사용할 수 있어야 합니다. 자세한 내용은 Greengrass 요구 사항을 CLI 참조하십시오. 암호 생성 및 로그인 방법에 대한 자세한 내용은 로컬 디버그 콘솔 구성 요소 사용을 참조하십시오.

  • 로컬 디버그 콘솔 구성 요소는 a에서 실행되도록 지원됩니다. VPC

의존성

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

2.4.3

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.10.0 <2.14.0 하드
그린그래스 CLI >=2.10.0 <2.14.0 하드
2.4.3

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.10.0 <2.14.0 하드
그린그래스 CLI >=2.10.0 <2.14.0 하드
2.4.1 – 2.4.2

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.10.0 <2.13.0 하드
그린그래스 CLI >=2.10.0 <2.13.0 하드
2.4.0

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.10.0 <2.12.0 하드
그린그래스 CLI >=2.10.0 <2.12.0 하드
2.3.0 and 2.3.1

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.10.0 <2.12.0 하드
그린그래스 CLI >=2.10.0 <2.12.0 하드
2.2.9

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.1.0 <2.12.0 하드
그린그래스 CLI >=2.1.0 <2.12.0 하드
2.2.8

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.1.0 <2.11.0 하드
그린그래스 CLI >=2.1.0 <2.11.0 하드
2.2.7

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.1.0 <2.10.0 하드
그린그래스 CLI >=2.1.0 <2.10.0 하드
2.2.6

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.1.0 <2.9.0 하드
그린그래스 CLI >=2.1.0 <2.9.0 하드
2.2.5

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.1.0 <2.8.0 하드
그린그래스 CLI >=2.1.0 <2.8.0 하드
2.2.4

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.1.0 <2.7.0 하드
그린그래스 CLI >=2.1.0 <2.7.0 하드
2.2.3

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.1.0 <2.6.0 하드
그린그래스 CLI >=2.1.0 <2.6.0 하드
2.2.2

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.1.0 <2.5.0 하드
그린그래스 CLI >=2.1.0 <2.5.0 하드
2.2.1

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.1.0 <2.4.0 하드
그린그래스 CLI >=2.1.0 <2.4.0 하드
2.2.0

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.1.0 <2.3.0 하드
그린그래스 CLI >=2.1.0 <2.3.0 하드
2.1.0

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.1.0 <2.2.0 하드
그린그래스 CLI >=2.1.0 <2.2.0 하드
2.0.x

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

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

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

구성

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

v2.1.x - v2.4.x
httpsEnabled

(선택 사항) 로컬 디버그 콘솔에 대한 HTTPS 통신을 활성화할 수 있습니다. HTTPS통신을 활성화하면 로컬 디버그 콘솔이 자체 서명된 인증서를 만듭니다. 웹 브라우저에서는 자체 서명된 인증서를 사용하는 웹 사이트에 대한 보안 경고를 표시하므로 인증서를 수동으로 확인해야 합니다. 그러면 경고를 우회할 수 있습니다. 자세한 내용은 사용량 단원을 참조하십시오.

기본값: true

port

(선택 사항) 로컬 디버그 콘솔을 제공할 포트입니다.

기본값: 1441

websocketPort

(선택 사항) 로컬 디버그 콘솔에 사용할 웹 소켓 포트입니다.

기본값: 1442

bindHostname

(선택 사항) 로컬 디버그 콘솔에 사용할 호스트 이름.

Docker 컨테이너에서 AWS IoT Greengrass Core 소프트웨어를 실행하는 경우 이 매개변수를 로 0.0.0.0 설정하면 Docker 컨테이너 외부에서 로컬 디버그 콘솔을 열 수 있습니다.

기본값: localhost

예: 구성 병합 업데이트

다음 예제 구성은 기본 포트가 아닌 포트에서 로컬 디버그 콘솔을 열고 비활성화하도록 지정합니다. HTTPS

{ "httpsEnabled": false, "port": "10441", "websocketPort": "10442" }
v2.0.x
port

(선택 사항) 로컬 디버그 콘솔을 제공할 포트입니다.

기본값: 1441

websocketPort

(선택 사항) 로컬 디버그 콘솔에 사용할 웹 소켓 포트입니다.

기본값: 1442

bindHostname

(선택 사항) 로컬 디버그 콘솔에 사용할 호스트 이름.

Docker 컨테이너에서 AWS IoT Greengrass Core 소프트웨어를 실행하는 경우 이 매개변수를 로 0.0.0.0 설정하면 Docker 컨테이너 외부에서 로컬 디버그 콘솔을 열 수 있습니다.

기본값: localhost

예: 구성 병합 업데이트

다음 예제 구성은 기본 포트가 아닌 포트에서 로컬 디버그 콘솔을 열도록 지정합니다.

{ "port": "10441", "websocketPort": "10442" }

사용량

로컬 디버그 콘솔을 사용하려면 CLI Greengrass에서 세션을 생성하십시오. 세션을 생성하면 CLI Greengrass는 로컬 디버그 콘솔에 로그인하는 데 사용할 수 있는 사용자 이름과 임시 비밀번호를 제공합니다.

다음 지침에 따라 코어 기기 또는 개발 컴퓨터에서 로컬 디버그 콘솔을 여십시오.

v2.1.x - v2.4.x

버전 2.1.0 이상에서는 로컬 디버그 콘솔이 기본적으로 를 사용합니다HTTPS. HTTPS가 활성화되면 로컬 디버그 콘솔은 연결을 보호하기 위해 자체 서명된 인증서를 만듭니다. 이 자체 서명된 인증서 때문에 로컬 디버그 콘솔을 열면 웹 브라우저에 보안 경고가 표시됩니다. CLIGreengrass로 세션을 생성하면 출력에 인증서의 지문이 포함되므로 인증서가 합법적이고 연결이 안전한지 확인할 수 있습니다.

비활성화할 수 있습니다. HTTPS 자세한 내용은 로컬 디버그 콘솔 구성을 참조하십시오.

로컬 디버그 콘솔을 열려면
  1. (선택 사항) 개발 컴퓨터에서 로컬 디버그 콘솔을 보려면 콘솔의 포트를 포워딩하면 됩니다. SSH 하지만 먼저 코어 디바이스의 SSH 구성 파일에서 AllowTcpForwarding 옵션을 활성화해야 합니다. 이 옵션은 기본적으로 활성화되어 있습니다. 개발 컴퓨터에서 다음 명령을 실행하여 개발 컴퓨터의 대시보드를 보십시오localhost:1441.

    ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
    참고

    기본 포트는 1441 및 에서 변경할 수 1442 있습니다. 자세한 내용은 로컬 디버그 콘솔 구성을 참조하십시오.

  2. 세션을 생성하여 로컬 디버그 콘솔을 사용하십시오. 세션을 만들 때 인증에 사용할 암호를 생성합니다. 로컬 디버그 콘솔에는 보안을 강화하기 위해 암호가 필요합니다. 이 구성 요소를 사용하여 중요한 정보를 보고 코어 장치에서 작업을 수행할 수 있기 때문입니다. 구성 요소 HTTPS 구성에서 활성화한 경우 로컬 디버그 콘솔은 연결 보안을 위한 인증서도 생성합니다. HTTPS기본적으로 활성화되어 있습니다.

    를 AWS IoT Greengrass CLI 사용하여 세션을 생성합니다. 이 명령은 8시간 후에 만료되는 임의의 43자 암호를 생성합니다. /greengrass/v2바꾸거나 C:\greengrass\v2 AWS IoT Greengrass V2 루트 폴더 경로와 함께

    Linux or UnixWindows
    Linux or Unix
    sudo /greengrass/v2/bin/greengrass-cli get-debug-password
    Windows
    C:\greengrass\v2\bin\greengrass-cli get-debug-password

    사용할 HTTPS 로컬 디버그 콘솔을 구성한 경우 명령 출력은 다음 예제와 같습니다. 로컬 디버그 콘솔을 열 때 인증서 지문을 사용하여 연결이 안전한지 확인합니다.

    Username: debug Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE Password expires at: 2021-04-01T17:01:43.921999931-07:00 The local debug console is configured to use TLS security. The certificate is self-signed so you will need to bypass your web browser's security warnings to open the console. Before you bypass the security warning, verify that the certificate fingerprint matches the following fingerprints. SHA-256: 15 0B 2C E2 54 8B 22 DE 08 46 54 8A B1 2B 25 DE FB 02 7D 01 4E 4A 56 67 96 DA A6 CC B1 D2 C4 1B SHA-1: BC 3E 16 04 D3 80 70 DA E0 47 25 F9 90 FA D6 02 80 3E B5 C1

    디버그 뷰 구성 요소는 8시간 동안 지속되는 세션을 만듭니다. 그런 다음 로컬 디버그 콘솔을 다시 보려면 새 암호를 생성해야 합니다.

  3. 대시보드를 열고 로그인합니다. Greengrass 코어 디바이스에서 대시보드를 보거나 포트를 포워딩하는 경우 개발 컴퓨터에서 대시보드를 볼 수 있습니다. SSH 다음 중 하나를 수행합니다.

    • 로컬 디버그 HTTPS 콘솔에서 기본 설정인 활성화한 경우 다음을 수행하십시오.

      1. 코어 https://localhost:1441 디바이스에서 열거나, 포트를 포워딩한 경우 개발 컴퓨터에서 엽니다. SSH

        브라우저에 잘못된 보안 인증서에 대한 보안 경고가 표시될 수 있습니다.

      2. 브라우저에 보안 경고가 표시되면 인증서가 합법적인지 확인하고 보안 경고를 우회하십시오. 다음을 따릅니다.

        1. 인증서의 SHA -256 또는 SHA -1 지문을 찾아 명령이 이전에 인쇄한 SHA -256 또는 SHA -1 지문과 일치하는지 확인합니다. get-debug-password 브라우저가 하나 또는 두 개의 지문을 모두 제공할 수 있습니다. 인증서 및 지문을 보려면 브라우저 설명서를 참조하십시오. 일부 브라우저에서는 인증서 지문을 지문이라고 합니다.

          참고

          인증서 지문이 일치하지 않는 경우 로 단계 2 이동하여 새 세션을 생성하십시오. 인증서 지문이 여전히 일치하지 않으면 연결이 안전하지 않을 수 있습니다.

        2. 인증서 지문이 일치하면 브라우저의 보안 경고를 우회하여 로컬 디버그 콘솔을 여십시오. 브라우저 보안 경고를 우회하려면 브라우저 설명서를 참조하십시오.

      3. get-debug-password명령에서 이전에 인쇄한 사용자 이름과 암호를 사용하여 웹 사이트에 로그인합니다.

        로컬 디버그 콘솔이 열립니다.

      4. 로컬 디버그 콘솔에 TLS 핸드셰이크 WebSocket 실패로 인해 연결할 수 없다는 오류가 표시되면 에 대한 자체 서명된 보안 경고를 우회해야 합니다. WebSocket URL

        로컬 WebSocket TLS 디버그 콘솔의 핸드셰이크 오류

        다음을 따릅니다.

        1. 로컬 디버그 콘솔을 연 브라우저와 동일한 https://localhost:1442 브라우저에서 엽니다.

        2. 인증서를 확인하고 보안 경고를 우회하십시오.

          경고를 우회한 후 브라우저에 HTTP 404 페이지가 표시될 수 있습니다.

        3. 다시 엽니다https://localhost:1441.

          로컬 디버그 콘솔에는 코어 디바이스에 대한 정보가 표시됩니다.

    • 로컬 디버그 HTTPS 콘솔에서 비활성화한 경우 다음을 수행하십시오.

      1. 코어 http://localhost:1441 기기에서 열고, 포트를 전달한 경우에는 개발 컴퓨터에서 여십시오. SSH

      2. get-debug-password명령에서 이전에 인쇄한 사용자 이름과 암호를 사용하여 웹 사이트에 로그인합니다.

        로컬 디버그 콘솔이 열립니다.

v2.0.x
로컬 디버그 콘솔을 열려면
  1. (선택 사항) 개발 컴퓨터에서 로컬 디버그 콘솔을 보려면 콘솔의 포트를 포워딩하면 됩니다. SSH 하지만 먼저 코어 디바이스의 SSH 구성 파일에서 AllowTcpForwarding 옵션을 활성화해야 합니다. 이 옵션은 기본적으로 활성화되어 있습니다. 개발 컴퓨터에서 다음 명령을 실행하여 개발 컴퓨터의 대시보드를 보십시오localhost:1441.

    ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
    참고

    기본 포트는 1441 및 에서 변경할 수 1442 있습니다. 자세한 내용은 로컬 디버그 콘솔 구성을 참조하십시오.

  2. 세션을 생성하여 로컬 디버그 콘솔을 사용하십시오. 세션을 만들 때 인증에 사용할 암호를 생성합니다. 로컬 디버그 콘솔에는 보안을 강화하기 위해 암호가 필요합니다. 이 구성 요소를 사용하여 중요한 정보를 보고 코어 장치에서 작업을 수행할 수 있기 때문입니다.

    를 AWS IoT Greengrass CLI 사용하여 세션을 생성합니다. 이 명령은 8시간 후에 만료되는 임의의 43자 암호를 생성합니다. /greengrass/v2바꾸거나 C:\greengrass\v2 AWS IoT Greengrass V2 루트 폴더 경로와 함께

    Linux or UnixWindows
    Linux or Unix
    sudo /greengrass/v2/bin/greengrass-cli get-debug-password
    Windows
    C:\greengrass\v2\bin\greengrass-cli get-debug-password

    명령 출력은 다음 예제와 같습니다.

    Username: debug Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE Password will expire at: 2021-04-01T17:01:43.921999931-07:00

    디버그 뷰 구성 요소는 4시간 동안 지속되는 세션을 만든 다음 새 암호를 생성해야 로컬 디버그 콘솔을 다시 볼 수 있습니다.

  3. 코어 http://localhost:1441 디바이스에서 열고, 포트를 전달한 경우에는 개발 컴퓨터에서 여십시오. SSH

  4. get-debug-password명령에서 이전에 인쇄한 사용자 이름과 암호를 사용하여 웹 사이트에 로그인합니다.

    로컬 디버그 콘솔이 열립니다.

로컬 로그 파일

이 구성 요소는 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.4.3

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

버그 수정 및 개선
  • 초당 바이트 수 (Bps) 가 아닌 초당 메가비트 (Mbps) 로 잘못 표시되는 STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH 문제를 수정합니다.

2.4.2

버그 수정 및 개선
  • 일반적인 버그 수정 및 개선입니다.

2.4.1

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

2.4.0

새로운 기능
  • 스트림 매니저 디버깅 콘솔을 추가합니다.

2.3.1

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

2.3.0

그린그래스 뉴클리어스 버전 2.10.0 릴리스를 위해 버전이 업데이트되었습니다.
새로운 기능
  • 클라이언트 포함 및 디버그 PubSub . AWS IoT Core MQTT

2.2.7

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

2.2.6

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

2.2.5

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

2.2.4

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

2.2.3

버그 수정 및 개선
  • 구성 요소가 개인 키를 보유한 키스토어를 해독하지 못할 때 시작되지 않던 문제를 수정합니다SSL.

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

2.2.2

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

2.2.1

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

2.2.0

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

2.1.0

새로운 기능
  • 로컬 디버그 콘솔에 대한 연결을 보호하는 HTTPS 데 사용합니다. HTTPS기본적으로 활성화됩니다.

버그 수정 및 개선
  • 구성 편집기에서 플래시바 메시지를 무시할 수 있습니다.

2.0.3

초기 버전