그린그래스 CLI - AWS IoT Greengrass
버전유형운영 체제요구 사항의존성구성로컬 로그 파일Changelog

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

그린그래스 CLI

Greengrass CLI 구성 요소(aws.greengrass.Cli)는 코어 디바이스에서 로컬로 구성 요소를 개발하고 디버깅하는 데 사용할 수 있는 로컬 명령줄 인터페이스를 제공합니다. 예를 들어 Greengrass를 CLI 사용하면 코어 디바이스에서 로컬 배포를 생성하고 구성 요소를 다시 시작할 수 있습니다.

AWS IoT Greengrass Core 소프트웨어를 설치할 때 이 구성 요소를 설치할 수 있습니다. 자세한 내용은 자습서: AWS IoT Greengrass V2 시작하기 단원을 참조하십시오.

중요

이 구성 요소는 프로덕션 환경이 아닌 개발 환경에서만 사용하는 것이 좋습니다. 이 구성 요소는 프로덕션 환경에서 일반적으로 필요하지 않은 정보와 작업에 대한 액세스를 제공합니다. 필요한 코어 디바이스에만 이 구성 요소를 배포하여 최소 권한 원칙을 따르세요.

이 구성 요소를 설치한 후 다음 명령을 실행하여 도움말 설명서를 확인합니다. 이 구성 요소가 설치되면 greengrass-cli /greengrass/v2/bin 폴더에 기호 링크가 추가됩니다. 이 경로CLI에서 Greengrass를 실행하거나 PATH 환경 변수에 추가하여 절대 경로 greengrass-cli 없이 실행할 수 있습니다.

Linux or Unix
/greengrass/v2/bin/greengrass-cli help
Windows
C:\greengrass\v2\bin\greengrass-cli help

다음 명령은 com.example.HelloWorld예를 들어 라는 구성 요소를 다시 시작합니다.

Linux or Unix
sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"
Windows
C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld"

자세한 내용은 그린그래스 커맨드 라인 인터페이스 단원을 참조하십시오.

버전

이 구성 요소에는 다음 버전이 있습니다.

  • 2.13.x

  • 2.12.x

  • 2.11.x

  • 2.10.x

  • 2.9.x

  • 2.8.x

  • 2.7.x

  • 2.6.x

  • 2.5.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

유형

이 구성 요소는 플러그인 구성 요소()입니다aws.greengrass.plugin. Greengrass 핵은 핵과 동일한 Java Virtual Machine(JVM)에서 이 구성 요소를 실행합니다. 코어 디바이스에서 이 구성 요소의 버전을 변경하면 핵이 다시 시작됩니다.

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

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

운영 체제

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

  • Linux

  • Windows

요구 사항

이 구성 요소에는 다음과 같은 요구 사항이 있습니다.

  • Greengrass를 사용하여 AWS IoT Greengrass Core 소프트웨어와 상호 작용CLI할 수 있는 권한이 있어야 합니다. 다음 중 하나를 수행하여 Greengrass 를 사용합니다CLI.

    • AWS IoT Greengrass Core 소프트웨어를 실행하는 시스템 사용자를 사용합니다.

    • 루트 또는 관리 권한이 있는 사용자를 사용합니다. Linux 코어 디바이스에서는 sudo 를 사용하여 루트 권한을 얻을 수 있습니다.

    • 구성 요소를 배포할 때 AuthorizedPosixGroups 또는 AuthorizedWindowsGroups 구성 파라미터에 지정한 그룹에 있는 시스템 사용자를 사용합니다. 자세한 내용은 Greengrass CLI 구성 요소 구성 단원을 참조하세요.

  • Greengrass CLI 구성 요소는 에서 실행할 수 있습니다VPC.

의존성

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

2.13.0

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

종속성 호환 버전 종속성 유형
그린그라스 핵 >=2.12.0 <2.14.0 소프트
2.12.0 – 2.12.6

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

종속성 호환 버전 종속성 유형
그린그래스 핵 >=2.12.0 <2.13.0 소프트
2.11.0 – 2.11.3

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

종속성 호환 버전 종속성 유형
그린그라스 핵 >=2.11.0 <2.12.0 소프트
2.10.0 – 2.10.3

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

종속성 호환 버전 종속성 유형
그린그라스 핵 >=2.5.0 <2.11.0 소프트
2.9.0 – 2.9.6

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

종속성 호환 버전 종속성 유형
그린그라스 핵 >=2.5.0 <2.10.0 소프트
2.8.0 – 2.8.1

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

종속성 호환 버전 종속성 유형
그린그라스 핵 >=2.5.0 <2.9.0 소프트
2.7.0

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

종속성 호환 버전 종속성 유형
그린그라스 핵 >=2.5.0 <2.8.0 소프트
2.6.0

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

종속성 호환 버전 종속성 유형
그린그라스 핵 >=2.5.0 <2.7.0 소프트
2.5.0 – 2.5.6

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

종속성 호환 버전 종속성 유형
그린그라스 핵 >=2.5.0 <2.6.0 소프트
2.4.0

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

종속성 호환 버전 종속성 유형
그린그라스 핵 >=2.1.0 <2.5.0 소프트
2.3.0

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

종속성 호환 버전 종속성 유형
그린그라스 핵 >=2.1.0 <2.4.0 소프트
2.2.0

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

종속성 호환 버전 종속성 유형
그린그라스 핵 >=2.1.0 <2.3.0 소프트
2.1.0

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

종속성 호환 버전 종속성 유형
그린그라스 핵 >=2.1.0 <2.2.0 소프트
2.0.x

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

종속성 호환 버전 종속성 유형
그린그라스 핵 >=2.0.0 <2.1.0 소프트
참고

Greengrass 핵의 최소 호환 버전은 Greengrass CLI 구성 요소의 패치 버전과 일치합니다.

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

구성

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

2.5.x - 2.13.x
AuthorizedPosixGroups

(선택 사항) 쉼표로 구분된 시스템 그룹 목록이 포함된 문자열입니다. 이러한 시스템 그룹이 Greengrass를 사용하여 AWS IoT Greengrass Core 소프트웨어와 상호 작용CLI할 수 있는 권한을 부여합니다. 그룹 이름 또는 그룹 을 지정할 수 있습니다IDs. 예를 들어, 는 3개의 시스템 그룹(group1, 1002및 group3)이 Greengrass 를 사용하도록 group1,1002,group3 승인합니다CLI.

권한을 부여할 그룹을 지정하지 않으면 Greengrass를 CLI 루트 사용자(sudo)로 사용하거나 AWS IoT Greengrass Core 소프트웨어를 실행하는 시스템 사용자로 사용할 수 있습니다.

AuthorizedWindowsGroups

(선택 사항) 쉼표로 구분된 시스템 그룹 목록이 포함된 문자열입니다. 이러한 시스템 그룹이 Greengrass를 사용하여 AWS IoT Greengrass Core 소프트웨어와 상호 작용CLI할 수 있는 권한을 부여합니다. 그룹 이름 또는 그룹 을 지정할 수 있습니다IDs. 예를 들어, 는 3개의 시스템 그룹(group1, 1002및 group3)이 Greengrass 를 사용하도록 group1,1002,group3 승인합니다CLI.

권한을 부여할 그룹을 지정하지 않으면 Greengrass를 CLI 관리자 또는 AWS IoT Greengrass Core 소프트웨어를 실행하는 시스템 사용자로 사용할 수 있습니다.

예: 구성 병합 업데이트

다음 예제 구성은 세 개의 POSIX 시스템 그룹(group1, 1002및 group3)과 두 개의 Windows 사용자 그룹(Device Operators 및 QA Engineers)이 Greengrass 를 사용하도록 권한을 부여하도록 지정합니다CLI.

{
  "AuthorizedPosixGroups": "group1,1002,group3",
  "AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}
2.4.x - 2.0.x
AuthorizedPosixGroups

(선택 사항) 쉼표로 구분된 시스템 그룹 목록이 포함된 문자열입니다. 이러한 시스템 그룹이 Greengrass를 사용하여 AWS IoT Greengrass Core 소프트웨어와 상호 작용CLI할 수 있는 권한을 부여합니다. 그룹 이름 또는 그룹 을 지정할 수 있습니다IDs. 예를 들어, 는 3개의 시스템 그룹(group1, 1002및 group3)이 Greengrass 를 사용하도록 group1,1002,group3 승인합니다CLI.

권한을 부여할 그룹을 지정하지 않으면 Greengrass를 CLI 루트 사용자(sudo)로 사용하거나 AWS IoT Greengrass Core 소프트웨어를 실행하는 시스템 사용자로 사용할 수 있습니다.

예: 구성 병합 업데이트

다음 예제 구성은 가 3개의 시스템 그룹(group1, 1002및 group3)이 Greengrass 를 사용하도록 권한을 부여하도록 지정합니다CLI.

{
  "AuthorizedPosixGroups": "group1,1002,group3"
}

로컬 로그 파일

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

Greengrass nucleus 버전 2.13.0 릴리스에 대한 버전이 업데이트되었습니다.

2.12.6

Greengrass nucleus 버전 2.12.6 릴리스에 대한 버전이 업데이트되었습니다.

2.12.5

Greengrass nucleus 버전 2.12.5 릴리스에 대한 버전이 업데이트되었습니다.

2.12.4

Greengrass 핵 버전 2.12.4 릴리스에 대한 버전이 업데이트되었습니다.

2.12.3
주의

이 버전은 더 이상 사용할 수 없습니다. 이 버전의 개선 사항은 이 구성 요소의 이후 버전에서 사용할 수 있습니다.

Greengrass nucleus 버전 2.12.3 릴리스에 대한 버전이 업데이트되었습니다.

2.12.2

Greengrass nucleus 버전 2.12.2 릴리스에 대한 버전이 업데이트되었습니다.

2.12.1

Greengrass 핵 버전 2.12.1 릴리스에 대한 버전이 업데이트되었습니다.

2.12.0

Greengrass nucleus 버전 2.12.0 릴리스에 대한 버전이 업데이트되었습니다.

2.11.3

Greengrass nucleus 버전 2.11.3 릴리스에 대한 버전이 업데이트되었습니다.

2.11.2

Greengrass nucleus 버전 2.11.2 릴리스에 대한 버전이 업데이트되었습니다.

2.11.1

Greengrass 핵 버전 2.11.1 릴리스에 대한 버전이 업데이트되었습니다.

2.11.0
새로운 기능

  • 로컬 배포를 취소할 수 있습니다.

  • 로컬 배포에 대한 장애 처리 정책을 구성할 수 있습니다.

  • 자세한 배포 상태 보고를 개선합니다.

2.10.3

Greengrass nucleus 버전 2.10.3 릴리스에 대한 버전이 업데이트되었습니다.

2.10.2

Greengrass nucleus 버전 2.10.2 릴리스에 대한 버전이 업데이트되었습니다.

2.10.1

Greengrass nucleus 버전 2.10.1 릴리스에 대한 버전이 업데이트되었습니다.

2.10.0

Greengrass nucleus 버전 2.10.0 릴리스에 대한 버전이 업데이트되었습니다.

2.9.6

Greengrass 핵 버전 2.9.6 릴리스에 대한 버전이 업데이트되었습니다.

2.9.5

Greengrass nucleus 버전 2.9.5 릴리스에 대한 버전이 업데이트되었습니다.

2.9.4

Greengrass nucleus 버전 2.9.4 릴리스에 대한 버전이 업데이트되었습니다.

2.9.3

Greengrass 핵 버전 2.9.3 릴리스에 대한 버전이 업데이트되었습니다.

2.9.2

Greengrass nucleus 버전 2.9.2 릴리스에 대한 버전이 업데이트되었습니다.

2.9.1

Greengrass 핵 버전 2.9.1 릴리스에 대한 버전이 업데이트되었습니다.

2.9.0

 Greengrass nucleus 버전 2.9.0 릴리스에 대한 버전이 업데이트되었습니다.

2.8.1

Greengrass 핵 버전 2.8.1 릴리스에 대한 버전이 업데이트되었습니다.

2.8.0

 Greengrass nucleus 버전 2.8.0 릴리스에 대한 버전이 업데이트되었습니다.

2.7.0

Greengrass nucleus 버전 2.7.0 릴리스에 대한 버전이 업데이트되었습니다.

2.6.0
새로운 기능

  • Greengrass가 CLI 사용하는 프로세스 간 통신(IPC) 작업을 호출하기 위한 사용자 지정 구성 요소에 대한 지원을 추가합니다. 이러한 IPC 작업을 사용하여 로컬 배포를 관리하고, 구성 요소 세부 정보를 보고, 로컬 디버그 콘솔 에 로그인하는 데 사용할 수 있는 암호를 생성할 수 있습니다. 자세한 내용은 IPC: 로컬 배포 및 구성 요소 관리를 참조하세요.

버그 수정 및 개선

  • 추가 사소한 수정 및 개선 사항.

2.5.6

Greengrass 핵 버전 2.5.6 릴리스에 대한 버전이 업데이트되었습니다.

2.5.5

Greengrass nucleus 버전 2.5.5 릴리스에 대한 버전이 업데이트되었습니다.

2.5.4

Greengrass nucleus 버전 2.5.4 릴리스에 대한 버전이 업데이트되었습니다.

2.5.3

Greengrass 핵 버전 2.5.3 릴리스에 대한 버전이 업데이트되었습니다.

2.5.2

Greengrass 핵 버전 2.5.2 릴리스에 대한 버전이 업데이트되었습니다.

2.5.1

Greengrass 핵 버전 2.5.1 릴리스에 대한 버전이 업데이트되었습니다.

2.5.0
새로운 기능

  • Windows를 실행하는 코어 디바이스에 대한 지원을 추가합니다.

  • CLI Windows 디바이스에서 Greengrass를 사용하도록 시스템 그룹을 승인하도록 지정할 수 있는 새 AuthorizedWindowsGroups 구성 파라미터를 추가합니다.

  • 로컬 배포의 windowsUser 파라미터를 추가합니다. 이 파라미터를 사용하여 Windows 코어 디바이스에서 구성 요소를 실행하는 데 사용할 사용자를 지정할 수 있습니다.

2.4.0
새로운 기능

2.3.0

Greengrass nucleus 버전 2.3.0 릴리스에 대한 버전이 업데이트되었습니다.

2.2.0

Greengrass nucleus 버전 2.2.0 릴리스에 대한 버전이 업데이트되었습니다.

2.1.0

Greengrass nucleus 버전 2.1.0 릴리스에 대한 버전이 업데이트되었습니다.

2.0.5

 Greengrass nucleus 버전 2.0.5 릴리스에 대한 버전이 업데이트되었습니다.

2.0.4

 Greengrass nucleus 버전 2.0.4 릴리스에 대한 버전이 업데이트되었습니다.

2.0.3

초기 버전