기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
로컬 디버그 콘솔
로컬 디버그 콘솔 구성 요소 (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 로그 단원을 참조하십시오.
자세한 내용은 구성 요소 유형 단원을 참조하십시오.
운영 체제
이 구성 요소는 다음 운영 체제를 실행하는 코어 디바이스에 설치할 수 있습니다.
요구 사항
이 구성 요소의 요구 사항은 다음과 같습니다.
-
사용자 이름과 암호를 사용하여 대시보드에 로그인합니다. 사용자 이름 () 이 제공됩니다. 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.4.3
-
다음 표에는 이 구성 요소의 버전 2.4.3에 대한 종속성이 나와 있습니다.
- 2.4.1 – 2.4.2
-
다음 표에는 이 구성 요소의 버전 2.4.1 ~ 2.4.2에 대한 종속성이 나와 있습니다.
- 2.4.0
-
다음 표에는 이 구성 요소의 버전 2.4.0에 대한 종속성이 나와 있습니다.
- 2.3.0 and 2.3.1
-
다음 표에는 이 구성 요소의 버전 2.3.0 및 2.3.1에 대한 종속성이 나와 있습니다.
- 2.2.9
-
다음 표에는 이 구성 요소의 버전 2.2.9에 대한 종속성이 나와 있습니다.
- 2.2.8
-
다음 표에는 이 구성 요소의 버전 2.2.8에 대한 종속성이 나와 있습니다.
- 2.2.7
-
다음 표에는 이 구성 요소의 버전 2.2.7에 대한 종속성이 나와 있습니다.
- 2.2.6
-
다음 표에는 이 구성 요소의 버전 2.2.6에 대한 종속성이 나와 있습니다.
- 2.2.5
-
다음 표에는 이 구성 요소의 버전 2.2.5에 대한 종속성이 나와 있습니다.
- 2.2.4
-
다음 표에는 이 구성 요소의 버전 2.2.4에 대한 종속성이 나와 있습니다.
- 2.2.3
-
다음 표에는 이 구성 요소의 버전 2.2.3에 대한 종속성이 나와 있습니다.
- 2.2.2
-
다음 표에는 이 구성 요소의 버전 2.2.2에 대한 종속성이 나와 있습니다.
- 2.2.1
-
다음 표에는 이 구성 요소의 버전 2.2.1에 대한 종속성이 나열되어 있습니다.
- 2.2.0
-
다음 표에는 이 구성 요소의 버전 2.2.0에 대한 종속성이 나와 있습니다.
- 2.1.0
-
다음 표에는 이 구성 요소의 버전 2.1.0에 대한 종속성이 나와 있습니다.
- 2.0.x
-
다음 표에는 이 구성 요소의 버전 2.0.x에 대한 종속성이 나와 있습니다.
구성 요소 종속성에 대한 자세한 내용은 구성 요소 레시피 참조를 참조하십시오.
구성
이 구성 요소는 구성 요소를 배포할 때 사용자 지정할 수 있는 다음과 같은 구성 매개 변수를 제공합니다.
- 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": "10441",
"websocketPort": "10442"
}
사용량
로컬 디버그 콘솔을 사용하려면 CLI Greengrass에서 세션을 생성하십시오. 세션을 생성하면 CLI Greengrass는 로컬 디버그 콘솔에 로그인하는 데 사용할 수 있는 사용자 이름과 임시 비밀번호를 제공합니다.
다음 지침에 따라 코어 기기 또는 개발 컴퓨터에서 로컬 디버그 콘솔을 여십시오.
- v2.1.x - v2.4.x
-
버전 2.1.0 이상에서는 로컬 디버그 콘솔이 기본적으로 를 사용합니다HTTPS. HTTPS가 활성화되면 로컬 디버그 콘솔은 연결을 보호하기 위해 자체 서명된 인증서를 만듭니다. 이 자체 서명된 인증서 때문에 로컬 디버그 콘솔을 열면 웹 브라우저에 보안 경고가 표시됩니다. CLIGreengrass로 세션을 생성하면 출력에 인증서의 지문이 포함되므로 인증서가 합법적이고 연결이 안전한지 확인할 수 있습니다.
비활성화할 수 있습니다. HTTPS 자세한 내용은 로컬 디버그 콘솔 구성을 참조하십시오.
로컬 디버그 콘솔을 열려면
-
(선택 사항) 개발 컴퓨터에서 로컬 디버그 콘솔을 보려면 콘솔의 포트를 포워딩하면 됩니다. SSH 하지만 먼저 코어 디바이스의 SSH 구성 파일에서 AllowTcpForwarding
옵션을 활성화해야 합니다. 이 옵션은 기본적으로 활성화되어 있습니다. 개발 컴퓨터에서 다음 명령을 실행하여 개발 컴퓨터의 대시보드를 보십시오localhost:1441
.
ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username
@core-device-ip-address
-
세션을 생성하여 로컬 디버그 콘솔을 사용하십시오. 세션을 만들 때 인증에 사용할 암호를 생성합니다. 로컬 디버그 콘솔에는 보안을 강화하기 위해 암호가 필요합니다. 이 구성 요소를 사용하여 중요한 정보를 보고 코어 장치에서 작업을 수행할 수 있기 때문입니다. 구성 요소 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시간 동안 지속되는 세션을 만듭니다. 그런 다음 로컬 디버그 콘솔을 다시 보려면 새 암호를 생성해야 합니다.
-
대시보드를 열고 로그인합니다. Greengrass 코어 디바이스에서 대시보드를 보거나 포트를 포워딩하는 경우 개발 컴퓨터에서 대시보드를 볼 수 있습니다. SSH 다음 중 하나를 수행합니다.
- v2.0.x
-
로컬 디버그 콘솔을 열려면
-
(선택 사항) 개발 컴퓨터에서 로컬 디버그 콘솔을 보려면 콘솔의 포트를 포워딩하면 됩니다. SSH 하지만 먼저 코어 디바이스의 SSH 구성 파일에서 AllowTcpForwarding
옵션을 활성화해야 합니다. 이 옵션은 기본적으로 활성화되어 있습니다. 개발 컴퓨터에서 다음 명령을 실행하여 개발 컴퓨터의 대시보드를 보십시오localhost:1441
.
ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username
@core-device-ip-address
-
세션을 생성하여 로컬 디버그 콘솔을 사용하십시오. 세션을 만들 때 인증에 사용할 암호를 생성합니다. 로컬 디버그 콘솔에는 보안을 강화하기 위해 암호가 필요합니다. 이 구성 요소를 사용하여 중요한 정보를 보고 코어 장치에서 작업을 수행할 수 있기 때문입니다.
를 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시간 동안 지속되는 세션을 만든 다음 새 암호를 생성해야 로컬 디버그 콘솔을 다시 볼 수 있습니다.
-
코어 http://localhost:1441
디바이스에서 열고, 포트를 전달한 경우에는 개발 컴퓨터에서 여십시오. SSH
-
get-debug-password
명령에서 이전에 인쇄한 사용자 이름과 암호를 사용하여 웹 사이트에 로그인합니다.
로컬 디버그 콘솔이 열립니다.
로컬 로그 파일
이 구성 요소는 Greengrass 핵 구성 요소와 동일한 로그 파일을 사용합니다.
- Linux
-
/greengrass/v2
/logs/greengrass.log
- Windows
-
C:\greengrass\v2
\logs\greengrass.log
Changelog
다음 표에는 각 구성 요소 버전의 변경 사항이 설명되어 있습니다.
버전
|
변경
|
2.4.3
|
그린그래스 뉴클리어스 버전 2.13.0 릴리스를 위해 버전이 업데이트되었습니다.
|
2.4.2
|
|
2.4.1
|
그린그래스 뉴클리어스 버전 2.12.0 릴리스를 위해 버전이 업데이트되었습니다. |
2.4.0
|
|
2.3.1
|
그린그래스 뉴클리어스 버전 2.11.0 릴리스를 위해 버전이 업데이트되었습니다. |
2.3.0
|
그린그래스 뉴클리어스 버전 2.10.0 릴리스를 위해 버전이 업데이트되었습니다. |
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
|
|
2.2.2
|
그린그래스 뉴클리어스 버전 2.4.0 릴리스를 위해 버전이 업데이트되었습니다.
|
2.2.1
|
그린그래스 뉴클리어스 버전 2.3.0 릴리스를 위해 버전이 업데이트되었습니다.
|
2.2.0
|
Greengrass 뉴클리어스 버전 2.2.0 릴리스를 위해 버전이 업데이트되었습니다.
|
2.1.0
|
|
2.0.3
|
초기 버전
|