그린그래스 설치 CLI - AWS IoT Greengrass
사전 조건CLIGreengrass 구성 요소 배포

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

그린그래스 설치 CLI

다음 방법 중 하나로 Greengrass를 CLI 설치할 수 있습니다.

  • 디바이스에 AWS IoT Greengrass Core 소프트웨어를 처음 설치할 때 --deploy-dev-tools 인수를 사용하십시오. 또한 이 인수를 --provision true 적용하도록 지정해야 합니다.

  • Greengrass CLI 구성 요소 (aws.greengrass.Cli) 를 디바이스에 배포합니다.

이 섹션에서는 Greengrass CLI 구성 요소를 배포하는 단계를 설명합니다. 초기 설정 CLI 시 Greengrass 설치에 대한 자세한 내용은 을 참조하십시오. 자습서: AWS IoT Greengrass V2 시작하기

사전 조건

Greengrass CLI 구성 요소를 배포하려면 다음 요구 사항을 충족해야 합니다.

  • AWS IoT Greengrass 코어 디바이스에 코어 소프트웨어가 설치 및 구성되었습니다. 자세한 내용은 자습서: AWS IoT Greengrass V2 시작하기 단원을 참조하십시오.

  • 를 사용하여 Greengrass를 AWS CLI CLI 배포하려면 를 설치하고 구성해야 합니다. AWS CLI자세한 내용은 AWS Command Line Interface 사용 설명서의 AWS CLI구성을 참조하세요.

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

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

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

    • 구성 요소를 배포할 때 AuthorizedPosixGroups 또는 AuthorizedWindowsGroups 구성 매개 변수에 지정한 그룹에 속한 시스템 사용자를 사용하십시오. 자세한 내용은 Greengrass CLI 구성 요소 구성을 참조하십시오.

CLIGreengrass 구성 요소 배포

다음 단계를 완료하여 Greengrass CLI 구성 요소를 코어 디바이스에 배포하세요.

  1. AWS IoT Greengrass 콘솔에 로그인합니다.

  2. 탐색 메뉴에서 구성 요소를 선택합니다.

  3. 구성 요소 페이지의 퍼블릭 구성 요소 탭에서 aws.greengrass.Cli을(를) 선택합니다.

  4. aws.greengrass.Cli 페이지에서 배포를 선택합니다.

  5. 배포에 추가에서 새 배포 생성을 선택합니다.

  6. 대상 지정 페이지의 배포 대상 아래에 있는 대상 이름 목록에서 배포하려는 Greengrass 그룹을 선택하고 다음을 선택합니다.

  7. 구성 요소 선택 페이지에서 구성 aws.greengrass.Cli요소가 선택되었는지 확인하고 다음을 선택합니다.

  8. 구성 요소 구성 페이지에서 기본 구성 설정을 유지하고 다음을 선택합니다.

  9. 고급 설정 구성 페이지에서 기본 구성 설정을 유지하고 다음을 선택합니다.

  10. 검토 페이지에서 배포를 클릭합니다.

  1. 디바이스에서 Greengrass CLI 구성 요소의 배포 구성을 정의하는 deployment.json 파일을 생성합니다. 이 파일은 다음과 같아야 합니다.

    {
  "targetArn":"targetArn",
  "components": {
    "aws.greengrass.Cli": {
      "componentVersion": "2.13.0",
      "configurationUpdate": {
        "merge": "{\"AuthorizedPosixGroups\":\"<group1>,<group2>,...,<groupN>\",\"AuthorizedWindowsGroups\":\"<group1>,<group2>,...,<groupN>\"}"
      }
    }
  }
}

    • target필드에서 배포 대상으로 지정할 사물 또는 사물 그룹의 Amazon Resource Name (ARN) 을 다음 형식으로 targetArn 대체합니다.

      • 사물: arn:aws:iot:region:account-id:thing/thingName

      • 사물 그룹: arn:aws:iot:region:account-id:thinggroup/thingGroupName

    • aws.greengrass.Cli구성 요소 객체에서 다음과 같이 값을 지정합니다.

      version

      Greengrass CLI 컴포넌트의 버전입니다.

      configurationUpdate.AuthorizedPosixGroups

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

      승인할 그룹을 지정하지 않은 경우 CLI Greengrass를 루트 사용자 sudo () 또는 Core 소프트웨어를 실행하는 AWS IoT Greengrass 시스템 사용자로 사용할 수 있습니다.

      configurationUpdate.AuthorizedWindowsGroups

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

      승인할 그룹을 지정하지 않은 경우 CLI Greengrass를 관리자 또는 Core 소프트웨어를 실행하는 AWS IoT Greengrass 시스템 사용자로 사용할 수 있습니다.

  2. 다음 명령을 실행하여 Greengrass CLI 구성 요소를 디바이스에 배포합니다.

    $ aws greengrassv2 create-deployment --cli-input-json file://path/to/deployment.json

설치 중에 컴포넌트는 디바이스의 /greengrass/v2/bin 폴더에 심볼릭 링크를 추가하며, 사용자는 이 경로에서 CLI Greengrass를 실행합니다. greengrass-cli 절대 경로 CLI 없이 Greengrass를 실행하려면 변수에 /greengrass/v2/bin 폴더를 추가하세요. PATH Greengrass CLI 설치를 확인하려면 다음 명령을 실행합니다.

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

다음 결과가 표시됩니다.

Usage: greengrass-cli [-hV] [--ggcRootPath=<ggcRootPath>] [COMMAND]
Greengrass command line interface

      --ggcRootPath=<ggcRootPath>
                  The AWS IoT Greengrass V2 root directory.
  -h, --help      Show this help message and exit.
  -V, --version   Print version information and exit.
Commands:
  help                Show help information for a command.
  component           Retrieve component information and stop or restart
                        components.
  deployment          Create local deployments and retrieve deployment status.
  logs                Analyze Greengrass logs.
  get-debug-password  Generate a password for use with the HTTP debug view
                        component.

찾을 수 greengrass-cli 없는 경우 배포 시 CLI Greengrass를 설치하지 못한 것일 수 있습니다. 자세한 내용은 문제 해결 AWS IoT Greengrass V2 단원을 참조하십시오.