AWS IoT 플릿 프로비저닝을 사용하여 AWS IoT Greengrass Core 소프트웨어 설치 - AWS IoT Greengrass

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

AWS IoT 플릿 프로비저닝을 사용하여 AWS IoT Greengrass Core 소프트웨어 설치

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

AWS IoT 플릿 프로비저닝을 사용하면 X.509 디바이스 인증서와 프라이빗 키를 생성하여 처음에 연결할 때 디바이스 AWS IoT 에 안전하게 전송 AWS IoT 하도록를 구성할 수 있습니다.는 Amazon Root 인증 기관(CA)에서 서명한 클라이언트 인증서를 AWS IoT 제공합니다. 플릿 프로비저닝으로 프로비저닝하는 Greengrass 코어 디바이스에 대한 사물 그룹, 사물 유형 및 권한을 지정 AWS IoT 하도록를 구성할 수도 있습니다. 프로비저닝 템플릿을 정의하여가 각 디바이스를 AWS IoT 프로비저닝하는 방법을 정의합니다. 프로비저닝 템플릿은 프로비저닝 시 디바이스에 대해 생성할 사물, 정책 및 인증서 리소스를 지정합니다. 자세한 내용은 AWS IoT Core 개발자 안내서프로비저닝 템플릿을 참조하세요.

AWS IoT Greengrass 는 AWS IoT 플릿 프로비저닝으로 생성된 AWS 리소스를 사용하여 AWS IoT Greengrass 코어 소프트웨어를 설치하는 데 사용할 수 있는 AWS IoT 플릿 프로비저닝 플러그인을 제공합니다. 플릿 프로비저닝 플러그인은 클레임에 의한 프로비저닝을 사용합니다. 디바이스는 프로비저닝 클레임 인증서와 프라이빗 키를 사용하여 일반 작업에 사용할 수 있는 고유한 X.509 디바이스 인증서와 프라이빗 키를 획득합니다. 제조 중에 클레임 인증서와 프라이빗 키를 각 디바이스에 내장할 수 있으므로 고객은 나중에 온라인 상태가 되면 각 디바이스를 활성화할 수 있습니다. 여러 디바이스에 동일한 클레임 인증서와 프라이빗 키를 사용할 수 있습니다. 자세한 내용은 AWS IoT Core 개발자 안내서클레임에 의한 프로비저닝을 참조하세요.

참고

플릿 프로비저닝 플러그인은 현재 하드웨어 보안 모듈()에 프라이빗 키 및 인증서 파일 저장을 지원하지 않습니다HSM. 를 사용하려면 수동 프로비저닝과 함께 Core 소프트웨어를 HSM설치합니다. AWS IoT Greengrass

AWS IoT 플릿 프로비저닝과 함께 AWS IoT Greengrass 코어 소프트웨어를 설치하려면가 Greengrass 코어 디바이스를 프로비저닝 AWS 계정 하는 데 AWS IoT 사용하는 리소스를에 설정해야 합니다. 이러한 리소스에는 프로비저닝 템플릿, 클레임 인증서 및 토큰 교환 IAM 역할이 포함됩니다. 이러한 리소스를 생성한 후 재사용하여 플릿에 여러 코어 디바이스를 프로비저닝할 수 있습니다. 자세한 내용은 Greengrass 코어 디바이스에 대한 AWS IoT 플릿 프로비저닝 설정 단원을 참조하십시오.

중요

AWS IoT Greengrass 코어 소프트웨어를 다운로드하기 전에 코어 디바이스가 AWS IoT Greengrass 코어 소프트웨어 v2.0 설치 및 실행 요구 사항을 충족하는지 확인합니다.

사전 조건

AWS IoT 플릿 프로비저닝과 함께 AWS IoT Greengrass 코어 소프트웨어를 설치하려면 먼저 Greengrass 코어 디바이스에 대한 AWS IoT 플릿 프로비저닝을 설정해야 합니다. 이 단계를 한 번 완료한 후 플릿 프로비저닝을 사용하여 코어 AWS IoT Greengrass 소프트웨어를 원하는 수의 디바이스에 설치할 수 있습니다.

AWS IoT 엔드포인트 검색

의 AWS IoT 엔드포인트를 가져 AWS 계정와 나중에 사용할 수 있도록 저장합니다. 디바이스에서는 이러한 엔드포인트를 사용하여 AWS IoT에 연결합니다. 다음을 수행합니다.

  1. 의 AWS IoT 데이터 엔드포인트를 가져옵니다 AWS 계정.

    aws iot describe-endpoint --endpoint-type iot:Data-ATS

    요청에 성공하는 경우 응답은 다음 예제와 유사합니다.

    { "endpointAddress": "device-data-prefix-ats.iot.us-west-2.amazonaws.com" }
  2. 의 AWS IoT 자격 증명 엔드포인트를 가져옵니다 AWS 계정.

    aws iot describe-endpoint --endpoint-type iot:CredentialProvider

    요청에 성공하는 경우 응답은 다음 예제와 유사합니다.

    { "endpointAddress": "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com" }

디바이스에 인증서 다운로드

디바이스는 클레임 인증서와 프라이빗 키를 사용하여 AWS 리소스를 프로비저닝하고 X.509 디바이스 인증서를 획득하기 위한 요청을 인증합니다. 제조 중에 클레임 인증서와 프라이빗 키를 디바이스에 내장하거나 설치 중에 인증서와 키를 디바이스에 복사할 수 있습니다. 이 섹션에서는 클레임 인증서와 프라이빗 키를 디바이스에 복사합니다. 또한 Amazon 루트 CA(인증 기관) 인증서를 디바이스에 다운로드할 수도 있습니다.

중요

프로비저닝 클레임 프라이빗 키는 Greengrass 코어 디바이스 등 어디에서든 항상 보안 유지되어야 합니다. Amazon CloudWatch 지표 및 로그를 사용하여 디바이스를 프로비저닝하기 위해 클레임 인증서의 무단 사용과 같은 오용 징후를 모니터링하는 것이 좋습니다. 오용이 감지되면 프로비저닝 클레임 인증서를 디바이스 프로비저닝에 사용할 수 없도록 비활성화합니다. 자세한 내용을 알아보려면 AWS IoT Core 개발자 안내서AWS IoT모니터링를 참조하세요.

에 자신을 등록하는 디바이스 수와 디바이스를 더 잘 관리할 수 있도록 AWS 계정플릿 프로비저닝 템플릿을 생성할 때 사전 프로비저닝 후크를 지정할 수 있습니다. 사전 프로비저닝 후크는 디바이스가 등록 중에 제공하는 템플릿 파라미터를 검증하는 AWS Lambda 함수입니다. 예를 들어 디바이스 ID를 데이터베이스와 비교하여 디바이스에 프로비저닝 권한이 있는지 확인하는 사전 프로비저닝 후크를 생성할 수 있습니다. 자세한 내용은 AWS IoT Core 개발자 안내서사전 프로비저닝 후크를 참조하세요.

디바이스에 클레임 인증서 다운로드
  1. 클레임 인증서와 프라이빗 키를 디바이스에 복사합니다. 개발 컴퓨터와 디바이스에서 SSH 및 SCP가 활성화된 경우 개발 컴퓨터에서 scp 명령을 사용하여 클레임 인증서와 프라이빗 키를 전송할 수 있습니다. 다음 예제 명령은 개발 컴퓨터의 claim-certs 폴더에서 이러한 파일을 디바이스로 전송합니다. device-ip-address를 디바이스의 IP 주소로 바꿉니다.

    scp -r claim-certs/ device-ip-address:~
  2. 디바이스에 Greengrass 루트 폴더를 생성합니다. 나중에이 폴더에 AWS IoT Greengrass 코어 소프트웨어를 설치합니다.

    참고

    Windows의 경우 260자의 경로 길이 제한이 있습니다. Windows를 사용하는 경우 루트 폴더(예: C:\greengrass\v2 또는 D:\greengrass\v2)를 사용하여 Greengrass 구성 요소 경로를 260자 제한 미만으로 유지합니다.

    Linux or Unix
    • /greengrass/v2를 사용할 폴더로 바꿉니다.

    sudo mkdir -p /greengrass/v2
    Windows Command Prompt
    • C:\greengrass\v2를 사용할 폴더로 바꿉니다.

    mkdir C:\greengrass\v2
    PowerShell
    • C:\greengrass\v2를 사용할 폴더로 바꿉니다.

    mkdir C:\greengrass\v2
  3. (Linux만 해당) Greengrass 루트 폴더의 상위 권한을 설정합니다.

    • 를 루트 폴더의 상위 폴더/greengrass로 바꿉니다.

    sudo chmod 755 /greengrass
  4. 클레임 인증서를 Greengrass 루트 폴더로 옮깁니다.

    • /greengrass/v2 또는를 Greengrass 루트 폴더C:\greengrass\v2로 바꿉니다.

    Linux or Unix
    sudo mv ~/claim-certs /greengrass/v2
    Windows Command Prompt (CMD)
    move %USERPROFILE%\claim-certs C:\greengrass\v2
    PowerShell
    mv -Path ~\claim-certs -Destination C:\greengrass\v2
  5. Amazon 루트 인증 기관(CA) 인증서를 다운로드합니다. AWS IoT 인증서는 기본적으로 Amazon의 루트 CA 인증서와 연결됩니다.

    Linux or Unix
    sudo curl -o /greengrass/v2/AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem
    Windows Command Prompt (CMD)
    curl -o C:\greengrass\v2\\AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem
    PowerShell
    iwr -Uri https://www.amazontrust.com/repository/AmazonRootCA1.pem -OutFile C:\greengrass\v2\\AmazonRootCA1.pem

디바이스 환경 설정

이 섹션의 단계에 따라 AWS IoT Greengrass 코어 디바이스로 사용할 Linux 또는 Windows 디바이스를 설정합니다.

Linux 디바이스 설정

용 Linux 디바이스를 설정하려면 AWS IoT Greengrass V2
  1. 실행에 필요한 AWS IoT Greengrass 코어 소프트웨어인 Java 런타임을 설치합니다. Amazon Corretto 또는 OpenJDK 장기 지원 버전을 사용하는 것이 좋습니다. 버전 8 이상이 필요합니다. 다음 명령은 디바이스에 OpenJDK을 설치하는 방법을 보여줍니다.

    • Debian 기반 또는 Ubuntu 기반 배포판의 경우:

      sudo apt install default-jdk
    • Red Hat 기반 배포판의 경우:

      sudo yum install java-11-openjdk-devel
    • 대상 Amazon Linux 2:

      sudo amazon-linux-extras install java-openjdk11
    • Amazon Linux 2023의 경우:

      sudo dnf install java-11-amazon-corretto -y

    설치가 완료되면 다음 명령을 실행하여 Linux 디바이스에서 Java가 실행되는지 확인합니다.

    java -version

    디바이스에서 실행되는 Java 버전이 명령을 통해 인쇄됩니다. 예를 들어 Debian 기반 배포의 경우 출력이 다음 샘플과 유사할 수 있습니다.

    openjdk version "11.0.9.1" 2020-11-04
    OpenJDK Runtime Environment (build 11.0.9.1+1-post-Debian-1deb10u2)
    OpenJDK 64-Bit Server VM (build 11.0.9.1+1-post-Debian-1deb10u2, mixed mode)
  2. (선택 사항) 디바이스에서 구성 요소를 실행하는 기본 시스템 사용자와 그룹을 생성합니다. 설치 관리자 인수를 사용하여 설치하는 동안 AWS IoT Greengrass 코어 소프트웨어 --component-default-user 설치 관리자가이 사용자 및 그룹을 생성하도록 선택할 수도 있습니다. 자세한 내용은 설치 프로그램 인수 단원을 참조하십시오.

    sudo useradd --system --create-home ggc_user sudo groupadd --system ggc_group
  3. AWS IoT Greengrass Core 소프트웨어(일반적으로 root)를 실행하는 사용자에게 모든 사용자 및 모든 그룹에서 실행할 수 sudo 있는 권한이 있는지 확인합니다.

    1. 다음 명령을 실행하여 /etc/sudoers 파일을 엽니다.

      sudo visudo
    2. 사용자에 대한 권한이 다음 예제와 같은지 확인합니다.

      root ALL=(ALL:ALL) ALL
  4. (선택 사항) 컨테이너화된 Lambda 함수를 실행하려면 cgroups v1을 활성화하고 memorydevices cgroups를 활성화하고 탑재해야 합니다. 컨테이너화된 Lambda 함수를 실행할 계획이 없는 경우 이 단계를 건너뛸 수 있습니다.

    이러한 cgroups 옵션을 활성화하려면 다음 Linux 커널 파라미터로 디바이스를 부팅합니다.

    cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

    디바이스의 커널 파라미터를 보고 설정하는 방법에 대한 자세한 내용은 운영 체제 및 부트 로더 설명서를 참조하세요. 지침에 따라 커널 파라미터를 영구적으로 설정합니다.

  5. 장치 요구 사항의 요구 사항 목록에 따라 디바이스에 기타 모든 필수 종속성을 설치합니다.

Windows 디바이스 설정

참고

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

용 Windows 디바이스를 설정하려면 AWS IoT Greengrass V2
  1. 실행에 필요한 AWS IoT Greengrass 코어 소프트웨어인 Java 런타임을 설치합니다. Amazon Corretto 또는 OpenJDK 장기 지원 버전을 사용하는 것이 좋습니다. 버전 8 이상이 필요합니다.

  2. PATH 시스템 변수에서 Java를 사용할 수 있는지 확인하고 사용할 수 없는 경우 추가합니다. LocalSystem 계정은 AWS IoT Greengrass 코어 소프트웨어를 실행하므로 사용자의 PATH 사용자 변수 대신 PATH 시스템 변수에 Java를 추가해야 합니다. 다음을 수행합니다.

    1. Windows 키를 눌러 시작 메뉴를 엽니다.

    2. 시작 메뉴에서 environment variables를 입력하여 시스템 옵션을 검색합니다.

    3. 시작 메뉴 검색 결과에서 시스템 환경 변수 편집을 선택하여 시스템 속성 창을 엽니다.

    4. 환경 변수...를 선택하여 환경 변수 창을 엽니다.

    5. 시스템 변수에서 경로를 선택하고 편집을 선택합니다. 환경 변수 편집 창에서 각 경로를 별도의 줄로 볼 수 있습니다.

    6. Java 설치 bin 폴더의 경로가 있는지 확인합니다. 경로는 다음 예제와 유사할 수 있습니다.

      C:\\Program Files\\Amazon Corretto\\jdk11.0.13_8\\bin
    7. 경로에서 Java 설치 bin 폴더가 누락된 경우 새로 만들기를 선택하여 추가한 다음 확인을 선택합니다.

  3. 관리자 권한으로 Windows 명령 프롬프트(cmd.exe)를 엽니다.

  4. Windows 디바이스의 LocalSystem 계정에 기본 사용자를 생성합니다. 를 보안 암호password로 바꿉니다.

    net user /add ggc_user password
    작은 정보

    Windows 구성에 따라 사용자의 암호가 미래의 날짜에 만료되도록 설정할 수 있습니다. Greengrass 애플리케이션이 계속 작동하도록 하려면 암호가 만료되는 시기를 추적하고 만료되기 전에 이를 업데이트합니다. 사용자의 암호가 만료되지 않도록 설정할 수도 있습니다.

    • 사용자와 암호가 만료되는 시기를 확인하려면 다음 명령을 실행합니다.

      net user ggc_user | findstr /C:expires
    • 사용자의 암호가 만료되지 않도록 설정하려면 다음 명령을 실행합니다.

      wmic UserAccount where "Name='ggc_user'" set PasswordExpires=False
    • wmic 명령이 더 이상 사용되지 않는 Windows 10 이상을 사용하는 경우 다음 PowerShell 명령을 실행합니다.

      Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = 'ggc_user'" | Set-CimInstance -Property @{PasswordExpires="False"}
  5. Microsoft에서 PsExec 유틸리티를 다운로드하여 디바이스에 설치합니다.

  6. PsExec 유틸리티를 사용하여 LocalSystem 계정의 Credential Manager 인스턴스에 기본 사용자의 사용자 이름과 암호를 저장합니다. 를 이전에 설정한 사용자의 암호password로 바꿉니다.

    psexec -s cmd /c cmdkey /generic:ggc_user /user:ggc_user /pass:password

    PsExec License Agreement 열기, 선택 Accept는 라이선스에 동의하고 명령을 실행합니다.

    참고

    Windows 디바이스에서 LocalSystem 계정은 Greengrass 핵을 실행하며, PsExec 유틸리티를 사용하여 LocalSystem 계정에 기본 사용자 정보를 저장해야 합니다. Credential Manager 애플리케이션을 사용하면이 정보가 계정 대신 현재 로그인한 사용자의 Windows LocalSystem 계정에 저장됩니다.

AWS IoT Greengrass 코어 소프트웨어 다운로드

다음 위치에서 최신 버전의 AWS IoT Greengrass Core 소프트웨어를 다운로드할 수 있습니다.

참고

다음 위치에서 특정 버전의 AWS IoT Greengrass Core 소프트웨어를 다운로드할 수 있습니다. version를 다운로드할 버전으로 바꿉니다.

https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-version.zip
AWS IoT Greengrass 코어 소프트웨어를 다운로드하려면
  1. 코어 디바이스에서 AWS IoT Greengrass 코어 소프트웨어를 라는 파일에 다운로드합니다greengrass-nucleus-latest.zip.

    Linux or Unix
    curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip
    Windows Command Prompt (CMD)
    curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip
    PowerShell
    iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip -OutFile greengrass-nucleus-latest.zip

    이 소프트웨어를 다운로드하면 Greengrass 코어 소프트웨어 라이선스 계약에 동의하는 것입니다.

  2. (선택 사항) Greengrass nucleus 소프트웨어 서명을 확인하려면

    참고

    이 기능은 Greengrass nucleus 버전 2.9.5 이상에서 사용할 수 있습니다.

    1. 다음 명령을 사용하여 Greengrass nucleus 아티팩트의 서명을 확인합니다.

      Linux or Unix
      jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip
      Windows Command Prompt (CMD)

      설치하는 JDK 버전에 따라 파일 이름이 다를 수 있습니다. jdk17.0.6_10를 설치한 JDK 버전으로 바꿉니다.

      "C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe" -verify -certs -verbose greengrass-nucleus-latest.zip
      PowerShell

      설치하는 JDK 버전에 따라 파일 이름이 다를 수 있습니다. jdk17.0.6_10를 설치한 JDK 버전으로 바꿉니다.

      'C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe' -verify -certs -verbose greengrass-nucleus-latest.zip
    2. jarsigner 간접 호출 시 확인 결과를 나타내는 출력이 생성됩니다.

      1. Greengrass nucleus zip 파일이 서명되면 출력에 다음 문이 포함됩니다.

        jar verified.
      2. Greengrass nucleus zip 파일이 서명되지 않으면 출력에 다음 문이 포함됩니다.

        jar is unsigned.
    3. -verify-certs 옵션과 함께 Jarsigner -verbose 옵션을 제공한 경우 출력에는 자세한 서명자 인증서 정보도 포함됩니다.

  3. AWS IoT Greengrass 코어 소프트웨어의 압축을 디바이스의 폴더에 풉니다. 를 사용하려는 폴더GreengrassInstaller로 바꿉니다.

    Linux or Unix
    unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip
    Windows Command Prompt (CMD)
    mkdir GreengrassInstaller && tar -xf greengrass-nucleus-latest.zip -C GreengrassInstaller && del greengrass-nucleus-latest.zip
    PowerShell
    Expand-Archive -Path greengrass-nucleus-latest.zip -DestinationPath .\\GreengrassInstaller rm greengrass-nucleus-latest.zip
  4. (선택 사항) 다음 명령을 실행하여 AWS IoT Greengrass 코어 소프트웨어의 버전을 확인합니다.

    java -jar ./GreengrassInstaller/lib/Greengrass.jar --version
중요

v2.4.0 이전 버전의 Greengrass 핵을 설치하는 경우 AWS IoT Greengrass Core 소프트웨어를 설치한 후에는이 폴더를 제거하지 마십시오. AWS IoT Greengrass Core 소프트웨어는이 폴더의 파일을 사용하여 실행합니다.

최신 버전의 소프트웨어를 다운로드한 경우 v2.4.0 이상을 설치하면 AWS IoT Greengrass Core 소프트웨어를 설치한 후이 폴더를 제거할 수 있습니다.

AWS IoT 플릿 프로비저닝 플러그인 다운로드

다음 위치에서 최신 버전의 AWS IoT 플릿 프로비저닝 플러그인을 다운로드할 수 있습니다.

참고

다음 위치에서 특정 버전의 AWS IoT 플릿 프로비저닝 플러그인을 다운로드할 수 있습니다. version를 다운로드할 버전으로 바꿉니다. 플릿 프로비저닝 플러그인의 각 버전에 대한 자세한 내용은 AWS IoT 플릿 프로비저닝 플러그인 변경 로그 섹션을 참조하세요.

https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-version.jar

플릿 프로비저닝 플러그인은 오픈 소스입니다. 소스 코드를 보려면 플AWS IoT 릿 프로비저닝 플러그인을 참조하세요 GitHub.

AWS IoT 플릿 프로비저닝 플러그인을 다운로드하려면
  • 디바이스에서 AWS IoT 플릿 프로비저닝 플러그인을 라는 파일에 다운로드합니다aws.greengrass.FleetProvisioningByClaim.jar. 를 사용하려는 폴더GreengrassInstaller로 바꿉니다.

    Linux or Unix
    curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar > GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar
    Windows Command Prompt (CMD)
    curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar > GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar
    PowerShell
    iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar -OutFile GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar

    이 소프트웨어를 다운로드하면 Greengrass 코어 소프트웨어 라이선스 계약에 동의하는 것입니다.

AWS IoT Greengrass Core 소프트웨어 설치

다음 작업을 지정하는 인수를 사용하여 설치 관리자를 실행합니다.

  • 플릿 프로비저닝 플러그인을 사용하여 AWS 리소스를 프로비저닝하도록 지정하는 부분 구성 파일에서를 설치합니다. AWS IoT Greengrass Core 소프트웨어는 디바이스의 모든 Greengrass 구성 요소의 구성을 지정하는 구성 파일을 사용합니다. 설치 관리자는 제공된 부분 구성 파일에서 전체 구성 파일과 플릿 프로비저닝 플러그인이 생성하는 AWS 리소스를 생성합니다.

  • ggc_user 시스템 사용자를 사용하도록 지정하여 코어 디바이스에서 소프트웨어 구성 요소를 실행합니다. Linux 디바이스에서 이 명령은 ggc_group 시스템 그룹을 사용하도록 지정하고 설치 관리자가 시스템 사용자와 그룹을 생성합니다.

  • AWS IoT Greengrass Core 소프트웨어를 부팅 시 실행되는 시스템 서비스로 설정합니다. Linux 디바이스에서는 Systemd init 시스템이 필요합니다.

    중요

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

지정할 수 있는 인수에 대한 자세한 내용은 설치 프로그램 인수 단원을 참조하세요.

참고

메모리가 제한된 디바이스 AWS IoT Greengrass 에서를 실행하는 경우 AWS IoT Greengrass Core 소프트웨어가 사용하는 메모리 양을 제어할 수 있습니다. 메모리 할당을 제어하기 위해 핵 구성 요소의 jvmOptions 구성 파라미터에서 JVM 힙 크기 옵션을 설정할 수 있습니다. 자세한 내용은 JVM 옵션으로 메모리 할당 제어 단원을 참조하십시오.

AWS IoT Greengrass 코어 소프트웨어를 설치하려면
  1. AWS IoT Greengrass 코어 소프트웨어의 버전을 확인합니다.

    • 를 소프트웨어가 포함된 폴더의 경로GreengrassInstaller로 바꿉니다.

    java -jar ./GreengrassInstaller/lib/Greengrass.jar --version
  2. 텍스트 편집기를 사용하여 config.yaml 구성 파일을 생성하고 설치 관리자에 제공합니다.

    예를 들어 Linux 기반 시스템에서 다음 명령을 실행하여 GNU 나노를 사용하여 파일을 생성할 수 있습니다.

    nano GreengrassInstaller/config.yaml

    다음 YAML 콘텐츠를 파일에 복사합니다. 이 부분 구성 파일은 플릿 프로비저닝 플러그인의 파라미터를 지정합니다. 지정할 수 있는 옵션에 대한 자세한 내용은 AWS IoT 플릿 프로비저닝 플러그인 구성 섹션을 참조하세요.

    Linux or Unix
    --- services: aws.greengrass.Nucleus: version: "2.14.0" aws.greengrass.FleetProvisioningByClaim: configuration: rootPath: "/greengrass/v2" awsRegion: "us-west-2" iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com" iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com" iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias" provisioningTemplate: "GreengrassFleetProvisioningTemplate" claimCertificatePath: "/greengrass/v2/claim-certs/claim.pem.crt" claimCertificatePrivateKeyPath: "/greengrass/v2/claim-certs/claim.private.pem.key" rootCaPath: "/greengrass/v2/AmazonRootCA1.pem" templateParameters: ThingName: "MyGreengrassCore" ThingGroupName: "MyGreengrassCoreGroup"
    Windows
    --- services: aws.greengrass.Nucleus: version: "2.14.0" aws.greengrass.FleetProvisioningByClaim: configuration: rootPath: "C:\\greengrass\\v2" awsRegion: "us-west-2" iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com" iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com" iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias" provisioningTemplate: "GreengrassFleetProvisioningTemplate" claimCertificatePath: "C:\\greengrass\\v2\\claim-certs\\claim.pem.crt" claimCertificatePrivateKeyPath: "C:\\greengrass\\v2\\claim-certs\\claim.private.pem.key" rootCaPath: "C:\\greengrass\\v2\\AmazonRootCA1.pem" templateParameters: ThingName: "MyGreengrassCore" ThingGroupName: "MyGreengrassCoreGroup"

    뒤이어 다음과 같이 하세요.

    • 2.14.0를 AWS IoT Greengrass 코어 소프트웨어 버전으로 바꿉니다.

    • /greengrass/v2 또는의 각 인스턴스를 Greengrass 루트 폴더C:\greengrass\v2로 바꿉니다.

      참고

      Windows 디바이스에서는 경로 구분자를 이중 백슬래시(\\)로 지정해야 합니다(예: C:\\greengrass\\v2).

    • 를 프로비저닝 템플릿 및 기타 리소스를 생성한 AWS 리전us-west-2으로 바꿉니다.

    • 를 AWS IoT 데이터 엔드포인트iotDataEndpoint로 바꿉니다.

    • 를 AWS IoT 자격 증명 엔드포인트iotCredentialEndpoint로 바꿉니다.

    • GreengrassCoreTokenExchangeRoleAlias를 토큰 교환 역할 별칭의 이름으로 바꿉니다.

    • GreengrassFleetProvisioningTemplate를 플릿 프로비저닝 템플릿의 이름으로 바꿉니다.

    • claimCertificatePath를 디바이스의 클레임 인증서 경로로 바꿉니다.

    • claimCertificatePrivateKeyPath를 디바이스의 클레임 인증서 프라이빗 키 경로로 바꿉니다.

    • 템플릿 파라미터(templateParameters)를 디바이스 프로비저닝에 사용하는 값으로 바꿉니다. 이 예제는 ThingNameThingGroupName 파라미터를 정의하는 예제 템플릿을 참조합니다.

    참고

    이 구성 파일에서는 다음 예제와 같이 사용할 포트 및 네트워크 프록시 등 다른 구성 옵션을 사용자 지정할 수 있습니다. 자세한 내용은 Greengrass nucleus 구성 섹션을 참조하세요.

    Linux or Unix
    --- services: aws.greengrass.Nucleus: version: "2.14.0" configuration: mqtt: port: 443 greengrassDataPlanePort: 443 networkProxy: noProxyAddresses: "http://192.168.0.1,www.example.com" proxy: url: "http://my-proxy-server:1100" username: "Mary_Major" password: "pass@word1357" aws.greengrass.FleetProvisioningByClaim: configuration: rootPath: "/greengrass/v2" awsRegion: "us-west-2" iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com" iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com" iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias" provisioningTemplate: "GreengrassFleetProvisioningTemplate" claimCertificatePath: "/greengrass/v2/claim-certs/claim.pem.crt" claimCertificatePrivateKeyPath: "/greengrass/v2/claim-certs/claim.private.pem.key" rootCaPath: "/greengrass/v2/AmazonRootCA1.pem" templateParameters: ThingName: "MyGreengrassCore" ThingGroupName: "MyGreengrassCoreGroup" mqttPort: 443 proxyUrl: "http://my-proxy-server:1100" proxyUserName: "Mary_Major" proxyPassword: "pass@word1357"
    Windows
    --- services: aws.greengrass.Nucleus: version: "2.14.0" configuration: mqtt: port: 443 greengrassDataPlanePort: 443 networkProxy: noProxyAddresses: "http://192.168.0.1,www.example.com" proxy: url: "http://my-proxy-server:1100" username: "Mary_Major" password: "pass@word1357" aws.greengrass.FleetProvisioningByClaim: configuration: rootPath: "C:\\greengrass\\v2" awsRegion: "us-west-2" iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com" iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com" iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias" provisioningTemplate: "GreengrassFleetProvisioningTemplate" claimCertificatePath: "C:\\greengrass\\v2\\claim-certs\\claim.pem.crt" claimCertificatePrivateKeyPath: "C:\\greengrass\\v2\\claim-certs\\claim.private.pem.key" rootCaPath: "C:\\greengrass\\v2\\AmazonRootCA1.pem" templateParameters: ThingName: "MyGreengrassCore" ThingGroupName: "MyGreengrassCoreGroup" mqttPort: 443 proxyUrl: "http://my-proxy-server:1100" proxyUserName: "Mary_Major" proxyPassword: "pass@word1357"

    HTTPS 프록시를 사용하려면 플릿 프로비저닝 플러그인 버전 1.1.0 이상을 사용해야 합니다. 다음 예제와 같이 system 아래에서 rootCaPath를 추가로 지정해야 합니다.

    Linux or Unix
    --- system: rootCaPath: "/greengrass/v2/AmazonRootCA1.pem" services: ...
    Windows
    --- system: rootCaPath: "C:\\greengrass\\v2\\AmazonRootCA1.pem" services: ...
  3. 설치 관리자를 실행합니다. --trusted-plugin을 지정하여 플릿 프로비저닝 플러그인을 제공하고, --init-config를 지정하여 구성 파일을 제공합니다.

    • /greengrass/v2를 Greengrass 루트 폴더로 바꿉니다.

    • 의 각 인스턴스를 설치 프로그램을 압축 해제한 폴더GreengrassInstaller로 바꿉니다.

    Linux or Unix
    sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \ -jar ./GreengrassInstaller/lib/Greengrass.jar \ --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar \ --init-config ./GreengrassInstaller/config.yaml \ --component-default-user ggc_user:ggc_group \ --setup-system-service true
    Windows Command Prompt (CMD)
    java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ^ -jar ./GreengrassInstaller/lib/Greengrass.jar ^ --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar ^ --init-config ./GreengrassInstaller/config.yaml ^ --component-default-user ggc_user ^ --setup-system-service true
    PowerShell
    java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ` -jar ./GreengrassInstaller/lib/Greengrass.jar ` --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar ` --init-config ./GreengrassInstaller/config.yaml ` --component-default-user ggc_user ` --setup-system-service true
    중요

    Windows 코어 디바이스에서는 AWS IoT Greengrass 코어 소프트웨어를 시스템 서비스로 설정--setup-system-service true하도록를 지정해야 합니다.

    --setup-system-service true를 지정하면 설치 관리자는 소프트웨어를 시스템 서비스로 설정하고 실행한 경우 Successfully set up Nucleus as a system service를 출력합니다. 그렇지 않은 경우 소프트웨어가 성공적으로 설치되면 설치 관리자에서 메시지가 출력되지 않습니다.

    참고

    --provision true 인수 없이 설치 관리자를 실행할 때는 deploy-dev-tools 인수를 사용하여 로컬 개발 도구를 배포할 수 없습니다. Greengrass를 디바이스에 CLI 직접 배포하는 방법에 대한 자세한 내용은 섹션을 참조하세요Greengrass 명령줄 인터페이스.

  4. 루트 폴더의 파일을 확인하여 설치를 확인합니다.

    Linux or Unix
    ls /greengrass/v2
    Windows Command Prompt (CMD)
    dir C:\greengrass\v2
    PowerShell
    ls C:\greengrass\v2

    설치에 성공하면 루트 폴더에 config, packageslogs와 같은 여러 폴더가 포함됩니다.

AWS IoT Greengrass Core 소프트웨어를 시스템 서비스로 설치한 경우 설치 관리자가 소프트웨어를 실행합니다. 그렇지 않으면 소프트웨어를 수동으로 실행해야 합니다. 자세한 내용은 AWS IoT Greengrass 코어 소프트웨어 실행 단원을 참조하십시오.

소프트웨어를 구성하고 사용하는 방법에 대한 자세한 내용은 다음을 AWS IoT Greengrass참조하세요.