인스톨러 인수 - AWS IoT Greengrass

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

인스톨러 인수

AWS IoT GreengrassCore 소프트웨어에는 소프트웨어를 설정하고 Greengrass 코어 장치 실행에 필요한 AWS 리소스를 프로비저닝하는 설치 프로그램이 포함되어 있습니다. 설치 프로그램에는 설치 구성을 위해 지정할 수 있는 다음과 같은 인수가 포함되어 있습니다.

-h, --help

(선택 사항) 설치 프로그램의 도움말 정보를 표시합니다.

--version

(선택 사항) AWS IoT Greengrass Core 소프트웨어 버전을 표시합니다.

-Droot

(선택 사항) AWS IoT Greengrass Core 소프트웨어의 루트로 사용할 폴더의 경로입니다.

참고

이 인수는 JVM 속성을 설정하므로 설치 프로그램을 실행할 -jar 때 먼저 JVM 속성을 지정해야 합니다. 예를 들어, java -Droot="/greengrass/v2" -jar /path/to/Greengrass.jar를 지정합니다.

기본값:

  • Linux: ~/.greengrass

  • Windows: %USERPROFILE%/.greengrass

-ar, --aws-region

AWS IoT GreengrassCore 소프트웨어가 필수 리소스를 검색하거나 생성하는 데 사용하는 AWS 항목입니다. AWS 리전

-p, --provision

(선택 사항) 이 장치를 AWS IoT 사물로 등록하고 코어 장치에 필요한 AWS 리소스를 제공할 수 있습니다. 지정하는 true 경우 AWS IoT Greengrass Core 소프트웨어는 AWS IoT 사물 (선택 사항), AWS IoT 사물 그룹, IAM 역할 및 AWS IoT 역할 별칭을 프로비전합니다.

기본값: false

-tn, --thing-name

(선택 사항) 이 코어 디바이스로 AWS IoT 등록한 사물의 이름. 해당 이름을 가진 항목이 사용자 AWS 계정 내부에 없는 경우 AWS IoT Greengrass Core 소프트웨어에서 해당 항목을 생성합니다.

참고

사물 이름에는 콜론 (:) 문자를 포함할 수 없습니다.

이 인수를 --provision true 적용하려면 지정해야 합니다.

기본값: 임의 UUID GreengrassV2IotThing_ 추가

-tgn, --thing-group-name

(선택 사항) 이 코어 디바이스의 AWS IoT 사물을 추가하는 AWS IoT 사물 그룹의 이름. 배포가 이 사물 그룹을 대상으로 하는 경우 이 코어 장치는 연결될 때 해당 배포를 AWS IoT Greengrass 수신합니다. 이 이름을 가진 사물 그룹이 사용자 AWS 계정 내에 없는 경우 AWS IoT Greengrass Core 소프트웨어에서 해당 사물 그룹을 생성합니다.

참고

사물 그룹 이름에는 콜론 (:) 문자를 포함할 수 없습니다.

이 인수를 --provision true 적용하도록 지정해야 합니다.

-tpn, --thing-policy-name

이 기능은 Greengrass 핵 구성 요소 v2.4.0 이상에서 사용할 수 있습니다.

(선택 사항) 이 코어 디바이스의 사물 인증서에 첨부할 AWS IoT 정책의 이름. AWS IoT 이 이름을 가진 AWS IoT 정책이 AWS 계정 귀사에 없는 경우 AWS IoT Greengrass Core 소프트웨어에서 해당 정책을 생성합니다.

AWS IoT GreengrassCore 소프트웨어는 기본적으로 허용 AWS IoT 정책을 생성합니다. 이 정책의 범위를 좁히거나 사용 사례에 대한 권한을 제한하는 사용자 지정 정책을 만들 수 있습니다. 자세한 설명은 AWS IoT Greengrass V2코어 디바이스에 대한 최소 AWS IoT 정책 섹션을 참조하세요.

이 인수를 --provision true 적용하도록 지정해야 합니다.

기본값: GreengrassV2IoTThingPolicy

-trn, --tes-role-name

(선택 사항) 코어 디바이스가 AWS 서비스와 상호 작용할 수 있도록 하는 AWS 자격 증명을 획득하는 데 사용할 IAM 역할의 이름입니다. 이 이름을 가진 역할이 사용자 AWS 계정 내에 없는 경우 AWS IoT Greengrass Core 소프트웨어에서 GreengrassV2TokenExchangeRoleAccess 정책을 사용하여 해당 역할을 생성합니다. 이 역할은 구성 요소 아티팩트를 호스팅하는 S3 버킷에 액세스할 수 없습니다. 따라서 구성 요소를 생성할 때 아티팩트의 S3 버킷 및 객체에 권한을 추가해야 합니다. 자세한 설명은 핵심 장치가 서비스와 상호 작용할 AWS 수 있도록 권한 부여 섹션을 참조하세요.

이 인수를 --provision true 적용하도록 지정해야 합니다.

기본값: GreengrassV2TokenExchangeRole

-tra, --tes-role-alias-name

(선택 사항) 이 코어 디바이스의 AWS 자격 증명을 제공하는 IAM 역할을 가리키는 AWS IoT 역할 별칭의 이름입니다. 이 이름의 역할 별칭이 사용자 AWS 계정 계정에 없는 경우 AWS IoT Greengrass Core 소프트웨어에서 이를 생성하여 지정한 IAM 역할을 가리킵니다.

이 인수를 --provision true 적용하도록 지정해야 합니다.

기본값: GreengrassV2TokenExchangeRoleAlias

-ss, --setup-system-service

(선택 사항) AWS IoT Greengrass Core 소프트웨어를 이 기기가 부팅될 때 실행되는 시스템 서비스로 설정할 수 있습니다. 시스템 서비스 이름은 입니다greengrass. 자세한 설명은 Greengrass 핵을 시스템 서비스로 구성 섹션을 참조하세요.

Linux 운영 체제에서 이 인수를 사용하려면 기기에서 systemd init 시스템을 사용할 수 있어야 합니다.

중요

Windows 코어 장치에서는 Core 소프트웨어를 시스템 서비스로 AWS IoT Greengrass 설정해야 합니다.

기본값: false

-u, --component-default-user

AWS IoT GreengrassCore 소프트웨어가 구성 요소를 실행하는 데 사용하는 사용자의 이름 또는 ID. 예를 들어, ggc_user를 지정할 수 있습니다. 이 값은 Windows 운영 체제에서 설치 프로그램을 실행할 때 필요합니다.

Linux 운영 체제에서는 그룹을 선택적으로 지정할 수도 있습니다. 사용자와 그룹을 콜론으로 구분하여 지정합니다. 예: ggc_user:ggc_group.

Linux 운영 체제에는 다음과 같은 추가 고려 사항이 적용됩니다.

  • 루트로 실행하는 경우 기본 구성 요소 사용자는 구성 파일에 정의된 사용자입니다. 구성 파일이 사용자를 정의하지 않는 경우 기본값은 입니다. ggc_user:ggc_group ggc_user존재하거나 존재하지 ggc_group 않는 경우 소프트웨어에서 생성합니다.

  • 루트가 아닌 사용자로 실행하는 경우 AWS IoT Greengrass Core 소프트웨어는 해당 사용자를 사용하여 구성 요소를 실행합니다.

  • 그룹을 지정하지 않으면 AWS IoT Greengrass Core 소프트웨어는 시스템 사용자의 기본 그룹을 사용합니다.

자세한 설명은 구성 요소를 실행하는 사용자를 구성하십시오. 섹션을 참조하세요.

-d, --deploy-dev-tools

(선택 사항) Greengrass CLI 구성 요소를 다운로드하여 이 코어 디바이스에 배포할 수 있습니다. 이 도구를 사용하여 이 코어 디바이스에서 구성 요소를 개발하고 디버그할 수 있습니다.

중요

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

이 인수를 --provision true 적용하도록 지정해야 합니다.

기본값: false

-init, --init-config

(선택 사항) AWS IoT Greengrass Core 소프트웨어를 설치하는 데 사용할 구성 파일의 경로입니다. 예를 들어 이 옵션을 사용하여 특정 Nucleus 구성으로 새 코어 장치를 설정할 수 있습니다.

중요

지정한 구성 파일은 코어 장치의 기존 구성 파일과 병합됩니다. 여기에는 코어 장치의 구성 요소 및 구성 요소 구성이 포함됩니다. 구성 파일에는 변경하려는 구성만 나열하는 것이 좋습니다.

-tp, --trusted-plugin

(선택 사항) 신뢰할 수 있는 플러그인으로 로드할 JAR 파일의 경로입니다. 이 옵션을 사용하여 프로비저닝 플러그인 JAR 파일을 제공할 수 있습니다. 예를 들어 플릿 프로비저닝 또는 사용자 지정 프로비저닝으로 설치하거나 하드웨어 보안 모듈에서 개인 키 및 인증서를 사용하여 설치할 수 있습니다.

-s, --start

(선택 사항) Core 소프트웨어를 설치한 후 AWS IoT Greengrass Core 소프트웨어를 시작하고 선택적으로 리소스를 프로비저닝할 수 있습니다.

기본값: true