Greengrass 설치 CLI - AWS IoT Greengrass
사전 조건Greengrass CLI 구성 요소 배포

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

Greengrass 설치 CLI

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

  • 디바이스에서 AWS IoT Greengrass 코어 소프트웨어를 처음 설정할 때 --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 단원을 참조하십시오.

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

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

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

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

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

Greengrass CLI 구성 요소 배포

다음 단계를 완료하여 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.14.0",
      "configurationUpdate": {
        "merge": "{\"AuthorizedPosixGroups\":\"<group1>,<group2>,...,<groupN>\",\"AuthorizedWindowsGroups\":\"<group1>,<group2>,...,<groupN>\"}"
      }
    }
  }
}

    • target 필드에서를 배포 대상으로 지정할 사물 또는 사물 그룹의 Amazon 리소스 이름(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

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

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

      configurationUpdate.AuthorizedWindowsGroups

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

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

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

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

설치하는 동안 구성 요소는 디바이스greengrass-cli의 /greengrass/v2/bin 폴더에 심볼 링크를 추가하고이 경로CLI에서 Greengrass를 실행합니다. 절대 경로 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를 찾을 수 없는 경우 배포가 Greengrass를 설치하지 못했을 수 있습니다CLI. 자세한 내용은 문제 해결 AWS IoT Greengrass V2 단원을 참조하십시오.