자습서: Ubuntu(18.04 x64) 시뮬레이터 참조 에이전트를 사용하는 Azure IoT Hub용 디바이스 업데이트

아티클
1/26/2022

Device Update for Azure IoT Hub는 이미지 기반, 패키지 기반 및 스크립트 기반 업데이트를 지원합니다.

이미지 업데이트는 디바이스의 최종 상태에서 더 높은 수준의 신뢰도를 제공합니다. 일반적으로 사전 프로덕션 환경과 프로덕션 환경 간에 이미지 업데이트 결과를 복제하는 것이 패키지 및 해당 종속성과 동일한 문제를 제기하지 않기 때문에 더 쉽습니다. 원자성 특성으로 인해 A/B 장애 조치(failover) 모델을 쉽게 채택할 수도 있습니다.

이 자습서에서는 IoT Hub에 대한 디바이스 업데이트를 사용하여 엔드투엔드 이미지 기반 업데이트를 완료하는 단계를 안내합니다.

이 자습서에서 학습할 방법은 다음과 같습니다.

이미지를 다운로드하여 설치합니다.
IoT 디바이스에 태그를 추가합니다.
업데이트를 가져옵니다.
장치 그룹을 만듭니다.
이미지 업데이트 배포
업데이트 배포를 모니터링합니다.

사전 요구 사항

아직 만들지 않았다면 디바이스 업데이트 계정 및 인스턴스를 만들고 IoT Hub를 구성합니다.

최신 릴리스의 릴리스 자산에서 Tutorial_Simulator.zip이라는 zip 파일을 다운로드하고 압축을 풉니다.

Azure IoT Hub에 디바이스 추가

디바이스 업데이트 에이전트가 IoT 디바이스에서 실행되고 나면 디바이스를 IoT Hub에 추가해야 합니다. IoT Hub 내에서 특정 디바이스에 대한 연결 문자열이 생성됩니다.

Azure Portal에서 IoT Hub에 대한 디바이스 업데이트를 시작합니다.
새 디바이스를 만듭니다.
왼쪽 창에서 디바이스로 이동합니다. 그런 다음, 새로 만들기를 선택합니다.
디바이스 ID에서 디바이스 이름을 입력합니다. 키 자동 생성 확인란이 선택되어 있는지 확인합니다.
저장을 선택합니다.
이제 디바이스 페이지로 돌아가면 만든 디바이스가 목록에 있어야 합니다. 해당 디바이스를 선택합니다.
디바이스 보기에서 기본 연결 문자열 옆의 복사 아이콘을 선택합니다.
다음 단계에서 나중에 사용할 수 있도록 복사한 문자를 어딘가에 붙여넣습니다.

복사된 이 문자열은 디바이스 연결 문자열입니다.

디바이스 업데이트 에이전트를 설치하여 시뮬레이터로 테스트

지침에 따라 Azure IoT Edge 런타임을 설치합니다.

참고

디바이스 업데이트 에이전트는 IoT Edge에 의존하지 않습니다. 그러나 IoT Edge(1.2.0 이상)와 함께 설치되는 IoT ID 서비스 디먼을 사용하여 ID를 가져오고 IoT Hub에 연결합니다.

이 자습서에서는 설명하지 않지만 IoT ID 서비스 디먼을 독립 실행형으로 Linux 기반 IoT 디바이스에 설치할 수 있습니다. 설치 순서가 중요합니다. 디바이스 업데이트 패키지 에이전트는 IoT ID 서비스 다음에 설치해야 합니다. 그렇지 않으면 패키지 에이전트가 IoT Hub에 대한 연결을 설정할 수 있는 권한 있는 구성 요소로 등록되지 않습니다.
그런 다음, 디바이스 업데이트 에이전트 .deb 패키지를 설치합니다.
```
sudo apt-get install deviceupdate-agent deliveryoptimization-plugin-apt 
```
다음 명령을 실행하여 구성 파일에 IoT 디바이스의 모듈(또는 디바이스 업데이트로 디바이스를 프로비저닝한 방법에 따라 디바이스) 기본 연결 문자열을 입력합니다.
```
sudo nano /etc/adu/du-config.json
```
시뮬레이터로 실행되도록 에이전트를 설정합니다. IoT 디바이스에서 다음 명령을 실행하여 디바이스 업데이트 에이전트가 시뮬레이터 처리기를 호출하여 APT('microsoft/apt:1')로 패키지 업데이트를 처리하도록 합니다.
```
sudo /usr/bin/AducIotAgent --register-content-handler /var/lib/adu/extensions/sources/libmicrosoft_simulator_1.so --update-type 'microsoft/apt:1'
```
시뮬레이터 처리기를 등록하고 호출하려면 다음 형식을 사용하여 자리 표시자를 채우세요.

sudo /usr/bin/AducIotAgent --register--content-handler <full path to the handler file> --update-type <update type name>
필수 구성 요소에서 다운로드한 Tutorial_Simulator.zip의 sample-du-simulator-data.json 파일이 필요합니다.

sample-du-simulator-data.json 파일을 열고 내용을 클립보드에 복사합니다.
```
nano sample-du-simulator-data.json
```
파일의 내용을 선택하고 Ctrl+C를 누릅니다. Ctrl+X를 눌러 파일을 닫고 변경 내용을 저장하지 않습니다.

다음 명령을 실행하여 tmp 폴더에 du-simulator-data.json 파일을 만들고 편집합니다.
```
sudo nano /tmp/du-simulator-data.json
```
Ctrl+V를 눌러 내용을 편집기에 붙여넣습니다. Ctrl+X를 선택하여 변경 내용을 저장한 다음, Y를 선택합니다.

사용 권한을 변경합니다.
```
sudo chown adu:adu /tmp/du-simulator-data.json
sudo chmod 664 /tmp/du-simulator-data.json
```
/tmp가 존재하지 않는 경우:
```
 sudo mkdir/tmp
 sudo chown root:root/tmp
 sudo chmod 1777/tmp
```
다음 명령을 실행하여 디바이스 업데이트 에이전트를 다시 시작합니다.
```
 sudo systemctl restart adu-agent
```

Azure IoT Hub에 대한 디바이스 업데이트 소프트웨어에는 다음 사용 조건이 적용됩니다.

에이전트를 사용하기 전에 사용 조건을 읽어보세요. 설치 및 사용하면 이러한 사용 조건에 동의하게 됩니다. 사용 조건에 동의하지 않는 경우 IoT Hub 에이전트용 디바이스 업데이트를 사용하지 마세요.

참고

시뮬레이터로 테스트한 후 다음 명령을 실행하여 APT 처리기를 호출하고 무선 패키지 업데이트를 배포합니다.

# sudo /usr/bin/AducIotAgent --register-content-handler /var/lib/adu/extensions/sources/libmicrosoft_apt_1.so --update-type 'microsoft/a pt:1'

디바이스에 태그 추가

Azure Portal에 로그인하고 IoT Hub로 이동합니다.
왼쪽 창의 디바이스 에서 IoT 디바이스를 찾아 디바이스 쌍 또는 모듈 쌍으로 이동합니다.
디바이스 업데이트 에이전트 모듈의 모듈 쌍에서 기존 디바이스 업데이트 태그 값을 null로 설정하여 삭제합니다. 디바이스 업데이트 에이전트와 함께 디바이스 ID를 사용하는 경우 디바이스 쌍에서 다음과 같이 변경합니다.
다음과 같이 새 디바이스 업데이트 태그 값을 추가합니다.
```
    "tags": {
            "ADUGroup": "<CustomTagValue>"
            }
```

업데이트 가져오기

필수 구성 요소에서 다운로드한 Tutorial_Simulator.zip의 TutorialImportManifest_Sim.importmanifest.json 및 adu-update-image-raspberrypi3.swu 파일이 필요합니다. 업데이트 파일은 Raspberry Pi 자습서에서 재사용됩니다. 이 자습서의 업데이트는 시뮬레이션되기 때문에 파일의 내용은 중요하지 않습니다.
Azure Portal에 로그인하고 디바이스 업데이트를 사용하여 IoT Hub로 이동합니다. 왼쪽 창의 자동 디바이스 관리에서 업데이트를 선택합니다.
업데이트 탭을 선택합니다.
+ 새 업데이트 가져오기를 선택합니다.
+ 스토리지 컨테이너에서 선택을 선택합니다. 기존 계정을 선택하거나 + 스토리지 계정을 사용하여 새 계정을 만듭니다. 그런 다음 + 컨테이너를 사용하여 기존 컨테이너를 선택하거나 새 컨테이너를 만듭니다. 이 컨테이너는 가져올 업데이트 파일을 스테이징하는 데 사용됩니다.

참고

이전 업데이트에서 실수로 파일을 가져오지 않도록 업데이트를 가져올 때마다 새 컨테이너를 사용하는 것이 좋습니다. 새 컨테이너를 사용하지 않는 경우 이 단계를 완료하기 전에 기존 컨테이너에서 모든 파일을 삭제해야 합니다.
컨테이너에서 업로드를 선택하고 1단계에서 다운로드한 파일로 이동합니다. 모든 업데이트 파일을 선택한 후 업로드를 선택합니다. 그런 다음 선택 단추를 선택하여 업데이트 가져오기 페이지로 돌아갑니다.

이 스크린샷은 가져오기 단계를 보여 줍니다. 파일 이름은 예제에 사용된 이름과 일치하지 않을 수 있습니다.
업데이트 가져오기 페이지에서 가져올 파일을 검토합니다. 그런 다음 업데이트 가져오기를 선택하여 가져오기 프로세스를 시작합니다.
가져오기 프로세스가 시작되고 화면이 가져오기 기록 섹션으로 전환됩니다. 상태 열에 가져오기가 성공했다고 표시되면 사용 가능한 업데이트 헤더를 선택합니다. 이제 목록에 가져온 업데이트가 표시됩니다.

업데이트를 가져오는 방법에 대해 자세히 알아봅니다.

업데이트 그룹 만들기

페이지 위에 있는 그룹 및 배포 탭으로 이동합니다.
그룹 추가를 선택하여 새 그룹을 만듭니다.
목록에서 IoT Hub 태그와 디바이스 클래스를 선택합니다. 그런 다음 그룹 만들기를 선택합니다.
그룹이 만들어지면 업데이트 준수 차트 및 그룹 목록이 업데이트됩니다. 업데이트 준수 차트는 최신 업데이트,사용 가능한 새 업데이트 및 진행 중인 업데이트에 대한 다양한 준수 상태의 디바이스 수를 표시합니다. 업데이트 준수를 알아봅니다.
새로 만든 그룹 및 새 그룹의 디바이스에 사용 가능한 업데이트가 표시되어야 합니다. 그룹의 디바이스 클래스 요구 사항을 충족하지 않는 디바이스가 있는 경우 해당하는 잘못된 그룹에 표시됩니다. 이 보기에서 새 사용자 정의 그룹에 가장 적합한 업데이트를 배포하려면 그룹 옆에 있는 배포를 선택합니다.

태그를 추가하고 업데이트 그룹을 만드는 방법에 대해 자세히 알아봅니다.

업데이트 배포

그룹이 만들어지면 디바이스 그룹에 사용할 수 있는 새 업데이트가 표시됩니다. 업데이트 링크는 최상의 업데이트 아래에 있어야 합니다. 한 번 새로 고쳐야 할 수도 있습니다. 업데이트 규정 준수에 대해 자세히 알아보세요.
그룹 이름을 선택하여 대상 그룹을 선택합니다. 그룹 기본사항 아래의 그룹 세부 정보로 이동합니다.
배포를 시작하려면 현재 배포 탭으로 이동합니다. 사용 가능한 업데이트 섹션에서 원하는 업데이트 옆에 있는 배포 링크를 선택합니다. 지정된 그룹에서 사용할 수 있는 최상의 업데이트는 최상이라는 강조 표시로 나타납니다.
즉시 또는 나중에 시작하도록 배포를 예약합니다. 그런 다음 만들기를 선택합니다.
배포 세부 정보에서 상태는 활성으로 바뀝니다. 배포된 업데이트는 (배포 중)표시됩니다.
규정 준수 차트를 확인하여 업데이트가 현재 진행 중인지 봅니다.
디바이스가 성공적으로 업데이트되면 규정 준수 차트 및 배포 세부 정보가 동일하게 반영되도록 업데이트된 것을 볼 수 있습니다.