145. (Aws/Amazon) [Aws Iot Core] Aws Iot Core 원격 작업 Job OTA 업데이트 CreateJob API 설명 정리

---

[개발 환경 설정]

​

개발 환경 : Aws / Amazon Web Services

​

 

---

[설명 정리]

 

// --------------------------------------------------------------------------------------
[개발 및 환경]
// --------------------------------------------------------------------------------------

- 인프라 : Aws / Amazon Web Services


- 기술 구분 : Aws / Aws Iot Core / Job / OTA


- 사전) Aws Iot Core 간략 설명 : 

  >> AWS IoT 는 IoT 디바이스를 다른 디바이스 및 AWS 클라우드 서비스에 연결하는 클라우드 서비스를 제공합니다.

  >> 디바이스가에 연결할 수 있는 경우 AWS IoT는 AWS 가 제공하는 클라우드 서비스에 디바이스를 AWS IoT 연결할 수 있습니다.

  >> AWS IoT Core 메시지 브로커는 MQTT 및 MQTT over WSS 프로토콜을 사용하여 메시지를 게시하고 구독하는 디바이스 및 클라이언트를 지원합니다. 
  
    - HTTPS 프로토콜을 사용하여 메시지를 게시하는 디바이스와 클라이언트도 지원합니다.


- 사전) AWS Iot Core Job 간략 설명 : 

  >> AWS 원격 작업 이란 작업자 또는 기술자의 물리적 존재 없이 원격으로 수행할 수 있는 업데이트 작업입니다 (무선 업데이트 (OTA) 수행)

  >> AWS IoT 작업 서비스는 AWS IoT 에 연결 되는 하나 이상의 디바이스로 전송 된 후 실행 되는 원격 작업 세트를 정의하는데 사용됩니다

    - 주목적 : 소프트웨어 및 펌웨어 업데이트를 디바이스 기기에게 알리는데 사용 (기기에게 작업 문서 전송)

    - 작업 문서 : AWS IoT Job 생성 시 대상이 되는 디바이스로 전송 되는 문서 (펌웨어 다운로드 URL 정보 등 포함)

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[설 명]
// --------------------------------------------------------------------------------------

1. AWS IoT Jobs 는 “원격 장치(IoT 디바이스)” 들에게 특정 작업(job)을 보내고 실행하게 하기 위한 기능입니다

  >> 예 : 펌웨어 업데이트, 설정 변경, 재부팅, 원격 진단 등


2. AWS IoT CreateJob API 는 이런 “job 생성” 을 클라우드 측에서 정의하고 시작할 때 사용하는 핵심 API입니다

  >> AWS 사이트 : https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJob.html

  >> CreateJob API 를 호출하려면 IAM 정책에서 iot:CreateJob 권한이 필요합니다


3. AWS IoT CreateJob 요청 구조 (Request Syntax)

  >> PUT /jobs/{jobId}
     Content-Type: application/json


4. AWS IoT CreateJob 요청 본문(JSON) 주요 필드 

  >> jobId (URI parameter) : job을 식별하는 고유 ID. 계정 내에서 유니크해야 함. (예: UUID 사용 권장) 

  >> targets : job을 적용할 대상들의 리스트 — 개별 “thing” 또는 “thing group” ARN. 반드시 1개 이상 지정. 

  >> document : job 문서 — 디바이스가 실행할 원격 명령 JSON. (예: 펌웨어 설치, 스크립트 실행 등) 

  >> documentSource : 만약 job 문서를 S3에 저장했다면, 그 S3 URL. 이 경우 document 대신 사용. 

  >> description : job에 대한 설명 (선택적) 

  >> targetSelection : job이 단발성인지, 지속형인지 지정: SNAPSHOT (기본) 또는 CONTINUOUS. CONTINUOUS 설정 시, 나중에 타겟 그룹에 추가된 디바이스에도 job이 자동 적용됨. 

  >> jobExecutionsRolloutConfig : “롤아웃 설정” — job을 대상 디바이스들에 얼마나 빠르게 배포할지 제어 (예: 분당 최대 몇 대, 점진 배포 등). 

  >> abortConfig : “중단 조건 설정” — job 배포/실행 중 문제가 일정 기준 이상 나올 경우 자동으로 job을 취소할 조건 정의. 

  >> timeoutConfig : 디바이스가 job을 완료해야 하는 최대 시간 설정. 이 시간이 지나도 완료 보고가 없으면 TIMED_OUT 처리. 

  >> jobExecutionsRetryConfig : 실패한 디바이스나 타임아웃된 디바이스에 대해 “재시도” 설정 가능.


5. AWS IoT CreateJob 응답 본문(JSON) 예시 구문 

    HTTP/1.1 200
    Content-type: application/json

    {
    "description": "string",
    "jobArn": "string",
    "jobId": "string"
    }


6. AWS IoT CreateJob 수행된 후 흐름

  >> CreateJob 호출이 성공하면 HTTP 200 응답이 오고, 반환값에 jobId, jobArn, (optional) description 등이 포함됨

  >> 그 job은 AWS IoT Jobs 서비스에서 대기 → 지정된 대상(thing 또는 group)들에게 “job이 준비됨” 메시지가 전송됨. 

  >> 디바이스는 이 메시지를 받아 job 문서를 다운로드(또는 S3에서 가져오거나) → 실제 작업 수행 → 완료 후 상태를 보고 (예: 성공, 실패) → 전체 배포 상태를 추적 가능. 

  >> 옵션에 따라 rollout 속도 제어, 실패 시 자동 취소, 재시도 또는 timeout 처리 등이 가능함

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[참고 사이트]
// --------------------------------------------------------------------------------------

[Aws Iot Core] 원격 작업 무선 업데이트 (OTA) job 개념 학습 및 펌웨어 업데이트 프로세스 정리

https://kkh0977.tistory.com/8133

https://blog.naver.com/kkh0977/223926549194?trackingCode=blog_bloghome_searchlist


[Aws Iot Core] AWS 원격 펌웨어 업데이트 job 알림 수신 jobs/notify 토픽과 jobs/notify-next 토픽 차이점 정리

https://kkh0977.tistory.com/8178

https://blog.naver.com/kkh0977/223954213087?trackingCode=blog_bloghome_searchlist


[Aws Iot Core] AWS 펌웨어 업데이트 Job Execution Rollout 설정 값 snapshot 과 continuous 차이점 정리

https://blog.naver.com/kkh0977/223960153729?trackingCode=blog_bloghome_searchlist


[Aws Iot Core] AWS 원격 펌웨어 업데이트 OTA 수동 job 생성 및 특정 사물 notify 펌웨어 업데이트 요청 방법 정리

https://blog.naver.com/kkh0977/223944636139?trackingCode=blog_bloghome_searchlist


[안드로이드 AWS Iot Core 원격 업데이트 Job 리스트 목록 확인]

https://blog.naver.com/kkh0977/223926528254?trackingCode=blog_bloghome_searchlist


[업무 이슈] Aws Iot Core 에서 Job 원격 펌웨어 업데이트 요청 시 상태가 완료 로 처리 되지 않는 이슈 발생

https://blog.naver.com/kkh0977/223944640508?trackingCode=blog_bloghome_searchlist


[업무 이슈] AWS Job 디바이스 펌웨어 업데이트 파일 순차 업데이트 미동작 이슈 - IN_PROGRESS, QUEUED 배열 펌웨어 처리

https://blog.naver.com/kkh0977/223955019266?trackingCode=blog_bloghome_searchlist


[업무 이슈] AWS Job 디바이스 펌웨어 업데이트 시 동일 버전 펌웨어 버전 체크 및 업데이트 진행 미완료 표시 - publish status

https://blog.naver.com/kkh0977/223955010876?trackingCode=blog_bloghome_searchlist


[업무 이슈] 디바이스 Aws Job OTA 펌웨어 업데이트 시 STS 임시 자격 증명 S3 Presigned URL 프리 사인 주소 파싱 문제 발생

https://blog.naver.com/kkh0977/223951554000?trackingCode=blog_bloghome_searchlist

// --------------------------------------------------------------------------------------

 

---

[참고 사이트]

​

https://kkh0977.tistory.com/8133

83. (Aws/Amazon) [Aws Iot Core] 원격 작업 무선 업데이트 (OTA) job 개념 학습 및 펌웨어 업데이트 프로세

---