AWS IoT Greengrass Version 1 2023년 6월 30일에 수명 연장 단계에 들어갔습니다. AWS IoT Greengrass V1 관리형 정책에 대한 자세한 정보는 섹션을 참조하세요. 이 날짜 이후에는 기능, 개선 사항, 버그 수정 또는 보안 패치를 제공하는 업데이트가 AWS IoT Greengrass V1 릴리스되지 않습니다. 에서 실행되는 기기는 AWS IoT Greengrass V1 중단되지 않으며 계속 작동하고 클라우드에 연결됩니다. 새로운 기능이 크게 추가되고 추가 플랫폼에 대한 지원이 추가되는 으로 마이그레이션하는 AWS IoT Greengrass Version 2 것이 좋습니다.

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

AWS IoT Greengrass 코어 소프트웨어의 OTA 업데이트

AWS IoT Greengrass 코어 소프트웨어 패키지에는 AWS IoT Greengrass 소프트웨어의 무선(OTA) 업데이트를 수행할 수 있는 업데이트 에이전트가 포함되어 있습니다. OTA 업데이트를 사용하여 하나 이상의 코어에 최신 버전의 AWS IoT Greengrass 코어 소프트웨어 또는 를 설치할 수 있습니다. OTA 업데이트를 사용하면 코어 디바이스가 물리적으로 존재할 필요가 없습니다.

가능하면 OTA 업데이트를 사용하는 것이 좋습니다. 업데이트 상태 및 업데이트 기록을 추적하는 데 사용할 수 있는 메커니즘을 제공합니다. 실패한 업데이트가 발생하면 OTA 업데이트 에이전트는 이전 소프트웨어 버전으로 롤백합니다.

OTA 업데이트를 통해 다음을 보다 효율적으로 수행할 수 있습니다.

이 기능은 AWS IoT 작업과 통합됩니다.

요구 사항

다음 요구 사항은 AWS IoT Greengrass 소프트웨어의 OTA 업데이트에 적용됩니다.

OTA 업데이트에 대한 IAM 권한

AWS IoT Greengrass에서 새 버전의 AWS IoT Greengrass 코어 소프트웨어를 AWS IoT Greengrass 릴리스하면 에서 OTA 업데이트에 사용되는 Amazon S3에 저장된 소프트웨어 아티팩트를 업데이트합니다.

AWS 계정 계정에 이러한 아티팩트에 액세스하는 데 사용할 수 있는 Amazon S3 URL URL 서명자 역할이 포함되어야 합니다. 역할에는 대상 AWS 리전 리전의 버킷에 대한 s3:GetObject 작업을 허용하는 권한 정책이 있어야 합니다. 역할에는 iot.amazonaws.com이 신뢰할 수 있는 엔터티로 역할을 수임할 수 있는 신뢰 정책도 있어야 합니다.

또한 OTA 업데이트를 시작하는 사용자는 greengrass:CreateSoftwareUpdateJob 및 iot:CreateJob, iam:PassRole을 사용하여 서명자 역할의 권한을 전달할 권한이 있어야 합니다. 다음은 IAM 정책의 예입니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "greengrass:CreateSoftwareUpdateJob"
            ],
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:CreateJob"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": "arn-of-s3-url-signer-role"
        }
    ]
}

고려 사항

Greengrass 코어 소프트웨어의 OTA 업데이트를 시작하기 전에 코어 디바이스와 해당 코어에 로컬로 연결된 클라이언트 디바이스 모두에서 Greengrass 그룹의 디바이스에 미치는 영향을 알고 있어야 합니다.

OTA 업데이트 중에 다음 상태 정보가 유지됩니다.

Greengrass OTA 업데이트 에이전트

Greengrass OTA 업데이트 에이전트는 클라우드에서 생성 및 배포된 업데이트 작업을 처리하는 디바이스의 소프트웨어 구성 요소입니다. OTA 업데이트 에이전트는 AWS IoT Greengrass 코어 소프트웨어와 동일한 소프트웨어 패키지로 배포됩니다. 에이전트는 /greengrass-root/ota/ota_agent/ggc-ota에 있습니다. /var/log/greengrass/ota/ggc_ota.txt에 로그를 씁니다.

바이너리를 수동으로 실행하거나 systemd 서비스 파일과 같은 init 스크립트의 일부로 통합하여 OTA 업데이트 에이전트를 시작할 수 있습니다. 바이너리를 수동으로 실행하는 경우 루트로 실행해야 합니다. 바이너리가 시작되면 OTA 업데이트 에이전트가 AWS IoT Core에서 AWS IoT Greengrass 소프트웨어 업데이트 작업을 수신하여 순차적으로 실행합니다. AWS IoT OTA 업데이트 에이전트는 다른 IoT 작업 유형을 모두 무시합니다.

다음 발췌문은 OTA 업데이트 에이전트를 시작, 중지 및 재시작하는 systemd 서비스 파일의 예를 보여줍니다.

[Unit]
Description=Greengrass OTA Daemon

[Service]
Type=forking
Restart=on-failure
ExecStart=/greengrass/ota/ota_agent/ggc-ota

[Install]
WantedBy=multi-user.target

업데이트의 대상인 코어는 OTA 업데이트 에이전트의 두 인스턴스를 실행해서는 안 됩니다. 그러면 두 에이전트가 동일한 작업을 처리하게 되어 충돌이 발생합니다.

Init 시스템과의 통합

OTA 업데이트 중에 OTA 업데이트 에이전트가 코어에서 바이너리를 다시 시작합니다. 바이너리가 실행 중인 경우 init 시스템에서 업데이트 중에 AWS IoT Greengrass 코어 소프트웨어 또는 에이전트의 상태를 모니터링하는 경우 충돌이 발생할 수 있습니다. OTA 업데이트 메커니즘을 사용자의 init 모니터링 전략과 통합하기 위해 업데이트 전후에 실행되는 셸 스크립트를 쓸 수 있습니다. 예를 들어 디바이스를 종료하기 전에 데이터를 백업하거나 프로세스를 중지하는 ggc_pre_update.sh 스크립트를 쓸 수 있습니다.

이러한 셸 스크립트를 실행하도록 OTA 업데이트 에이전트에 지시하려면 config.json 파일에 "managedRespawn" : true 플래그를 포함시켜야 합니다. 이 설정은 다음 발췌문에 표시됩니다.

{
   "coreThing": {                                                     
       …
   },
   "runtime": {                                                       
       …
   },
   "managedRespawn": true
       …
}

OTA 업데이트가 지원되는 관리형 Respawn

managedRespawn이(가) true(으)로 설정된 OTA 업데이트에는 다음 요구 사항이 적용됩니다.

OTA 업데이트 에이전트는 /greengrass-root/usr/scripts에서 스크립트를 실행합니다. 디렉터리 트리는 다음과 같아야 합니다.

<greengrass_root>
|-- certs
|-- config
|   |-- config.json
|-- ggc
|-- usr/scripts
|   |-- ggc_pre_update.sh
|   |-- ggc_post_update.sh
|   |-- ota_pre_update.sh
|   |-- ota_post_update.sh
|-- ota

managedRespawn이 true로 설정된 경우 OTA 업데이트 에이전트는 소프트웨어 업데이트 전후에 해당 스크립트에 대한 /greengrass-root/usr/scripts 디렉토리를 확인합니다. 스크립트가 없으면 업데이트가 실패합니다. AWS IoT Greengrass은(는) 이러한 스크립트의 내용을 확인하지 않습니다. 가장 좋은 방법은 스크립트가 제대로 작동하는지 확인하고 오류에 대한 적절한 종료 코드를 발행하는 것입니다.

OTA 업데이트 생성

하나 이상의 코어에서 AWS IoT Greengrass 소프트웨어의 OTA 업데이트를 수행하려면 다음 단계를 따르십시오.

CreateSoftwareUpdateJob API

CreateSoftwareUpdateJob API를 사용하여 코어 디바이스의 AWS IoT Greengrass 코어 소프트웨어 또는 OTA 업데이트 에이전트 소프트웨어를 업데이트할 수 있습니다. 이 API는 업데이트를 사용할 수 있을 때 디바이스에 알리는 AWS IoT 스냅샷 작업을 생성합니다. CreateSoftwareUpdateJob을 호출한 후 다른 AWS IoT 작업 명령을 사용하여 소프트웨어 업데이트를 추적할 수 있습니다. 자세한 내용은 AWS IoT 개발자 가이드의 작업 섹션을 참조하세요.

다음 예제에서는 코어 디바이스에서 AWS CLI를 사용하여 AWS IoT Greengrass 코어 소프트웨어 업데이트 작업을 생성하는 방법을 보여줍니다.

aws greengrass create-software-update-job \
--update-targets-architecture x86_64 \
--update-targets [\"arn:aws:iot:region:123456789012:thing/myCoreDevice\"] \
--update-targets-operating-system ubuntu \
--software-to-update core \
--s3-url-signer-role arn:aws:iam::123456789012:role/myS3UrlSignerRole \
--update-agent-log-level WARN \
--amzn-client-token myClientToken1

create-software-update-job 명령은 작업 ID, 작업 ARN, 업데이트가 설치하는 소프트웨어 버전을 포함하는 JSON 응답을 반환합니다.

{
    "IotJobId": "GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "IotJobArn": "arn:aws:iot:region:123456789012:job/GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "PlatformSoftwareVersion": "1.9.2"
}

create-software-update-job을 사용하여 코어 디바이스를 업데이트하는 방법을 보여 주는 단계는 OTA 업데이트 생성 단원을 참조하십시오.

create-software-update-job 명령에는 다음 파라미터가 있습니다.