자습서: Raspberry Pi 3 B+ 참조 이미지를 사용하는 Device Update for Azure IoT Hub

아티클
06/09/2023

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

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

이 자습서에서는 Raspberry Pi 3 B+ 보드에서 Device Update for IoT Hub를 사용하여 엔드투엔드 이미지 기반 업데이트를 완료하는 단계를 설명합니다.

이 자습서에서는 다음 작업을 수행하는 방법을 알아봅니다.

이미지를 다운로드합니다.
IoT 디바이스에 태그를 추가합니다.
업데이트를 가져옵니다.
이미지 업데이트 배포
업데이트 배포 모니터링

참고 항목

이 자습서의 이미지 업데이트는 Raspberry Pi B3 보드에서 유효성 검사되었습니다.

필수 조건

아직 만들지 않았다면 디바이스 업데이트 계정 및 인스턴스를 만들고 IoT Hub를 구성합니다. 이 자습서에서는 이더넷 연결을 통해 디바이스를 연결해야 합니다.

디바이스 업데이트 GitHub 릴리스 페이지의 자산에서 파일을 다운로드합니다. Tutorial_RaspberryPi.zip 자습서에 필요한 모든 파일이 있습니다.

IoT Hub에서 디바이스 만들기 및 연결 문자열 가져오기

이제 IoT Hub에 디바이스를 추가합니다. IoT Hub 내에서 디바이스에 대한 연결 문자열이 생성됩니다.

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

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

참고 항목

이 자습서에서는 디바이스 연결 문자열을 사용하여 쉽게 설정할 수 있도록 IoT Hub로 인증하고 연결합니다. 프로덕션 시나리오의 경우 모듈 ID를 사용하고 AIS(IoT Identity Service)를 활용하여 디바이스를 프로비전하는 것이 좋습니다. 자세한 정보

Raspberry Pi 설정

디바이스 업데이트 GitHub 릴리스 페이지의 자산에 기본 이미지 및 업데이트 파일을 제공합니다. Tutorial_RaspberryPi.zip 자습서에 필요한 모든 파일이 있습니다. 이 .wic 파일은 Raspberry Pi 3 B+ 보드에 플래시가 켜질 수 있는 기본 이미지입니다. swUpdate(.swu) 파일, 사용자 지정 swupdate 스크립트 및 매니페스트는 IoT Hub 디바이스 업데이트를 통해 가져올 업데이트 파일입니다.

이 기본 이미지는 다음과 함께 Yocto 빌드(3.4.4 릴리스 기반)를 사용합니다.

DU를 사용하여 이중 파티션 업데이트를 사용하도록 설정하는 SWUpdate
Device Update 에이전트

사용된 Yocto 계층에 대한 자세한 내용은 디바이스 업데이트 Yocto GitHub를 참조하세요.

선호하는 OS 플래시 도구를 사용하여 Raspberry Pi 3 B+ 디바이스에서 사용될 SD 카드에 디바이스 업데이트 기본 이미지(adu-base-image)를 설치할 수 있습니다. 다음은 bmaptool을 사용하여 SD 카드로 플래시하기 위한 지침입니다.

bmaptool을 사용하여 SD 카드 플래시

아직 설치하지 않은 경우 bmaptool 유틸리티를 설치합니다.
```
sudo apt-get install bmap-tools
```
/dev에서 SD 카드의 경로를 찾습니다. 경로는 /dev/sd* 또는 /dev/mmcblk*와 같습니다. dmesg 유틸리티를 사용하여 올바른 경로를 쉽게 찾을 수 있습니다.
플래시하기 전에 탑재된 모든 파티션을 분리합니다.
```
sudo umount /dev/<device>
```
디바이스에 대한 쓰기 권한이 있는지 확인합니다.
```
sudo chmod a+rw /dev/<device>
```
선택 사항: 더 빠른 플래시를 위해 bimap 파일과 이미지 파일을 다운로드하여 동일한 디렉터리에 넣습니다.

SD 카드를 플래시합니다.

sudo bmaptool copy <path to image> /dev/<device>

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

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

Raspberry Pi에서 디바이스 업데이트 에이전트 구성

Raspberry Pi 3이 네트워크에 연결되어 있는지 확인합니다.
PowerShell 창에서 다음 명령을 사용하여 Raspberry Pi 3에 SSH합니다.
```
  ssh raspberrypi3 -l root
```
DU 구성 파일(du-config.json 및 du-진단-config.json)은 디바이스에 있어야 IoT Hub 디바이스 업데이트가 제대로 구성됩니다.
1. 다음을 수행하여 편집할 du-config.json 파일을 만들거나 엽니다.
```
  nano /adu/du-config.json
```
1. 명령을 실행한 후 파일과 함께 열려 있는 편집기가 표시되어야 합니다. 파일을 만든 적이 없으면 비어 있을 것입니다. 이제 아래의 du-config.json 콘텐츠를 복사하고 디바이스에 필요한 구성을 대체합니다. 그런 다음 예제 연결 문자열을 이전 단계에서 만든 디바이스에 대한 문자열로 바꿉니다.
  
  du-config.json
```
{
   "schemaVersion": "1.0",
   "aduShellTrustedUsers": [
      "adu",
      "do"
   ],
   "manufacturer": "contoso",
   "model": "virtual-vacuum-v2",
   "agents": [
      {
      "name": "main",
      "runas": "adu",
      "connectionSource": {
         "connectionType": "string",
         "connectionData": "HostName=example-connection-string.azure-devices.net;DeviceId=example-device;SharedAccessKey=M5oK/rOP12aB5678YMWv5vFWHFGJFwE8YU6u0uTnrmU=" 
      },
      "manufacturer": "contoso",
      "model": "virtual-vacuum-v2"
      }
   ]
}  
```
1. 변경을 완료한 후 Ctrl+X를 선택하여 편집기를 종료합니다. 그런 다음, y를 입력하여 변경 내용을 저장합니다.
이제 유사한 명령을 사용하여 du-diagnostics-config.json 파일을 만들어야 합니다.
1. 다음을 사용하여 편집할 du-diagnostics-config.json 파일을 만들거나 열어 시작합니다.
```
  nano /adu/du-diagnostics-config.json
```
1. 아래의 du-diagnostics-config.json 콘텐츠를 복사하고 기본 빌드와 다른 구성으로 대체합니다. 예제 du-diagnostics-config.json 파일은 Device Update for IoT Hub의 기본 로그 위치를 나타냅니다. 구현이 다른 경우에만 이러한 기본값을 변경하면 됩니다.
du-diagnostics-config.json
```
{
   "logComponents":[
      {
         "componentName":"adu",
         "logPath":"/adu/logs/"
      },
      {
         "componentName":"do",
         "logPath":"/var/log/deliveryoptimization-agent/"
      }
   ],
   "maxKilobytesToUploadPerLogPath":50
}
```
1. 변경을 완료한 후 Ctrl+X를 선택하여 편집기를 종료합니다. 그런 다음, y를 입력하여 변경 내용을 저장합니다.
다음 명령을 사용하여 /adu/ 디렉터리에 있는 파일을 표시합니다. 다음을 사용하여 편집할 구성 files.du-diagnostics-config.json 파일이 모두 표시되어야 합니다.
```
  ls -la /adu/
```
디바이스 업데이트 시스템 디먼을 다시 시작하여 구성이 적용되었는지 확인합니다. raspberrypi에 로그인한 터미널 내에서 다음 명령을 사용합니다.
```
  systemctl start deviceupdate-agent
```
다음 명령을 사용하여 에이전트가 활성 상태인지 확인합니다.
```
  systemctl status deviceupdate-agent
```
상태가 활성 및 녹색으로 표시되어야 합니다.

Device Update for IoT Hub에서 디바이스 연결

왼쪽 창에서 디바이스를 선택합니다.
디바이스 이름을 사용하여 링크를 선택합니다.
페이지 맨 위에서 디바이스 트윈을 선택합니다.
디바이스 쌍 속성의 보고됨 섹션에서 Linux 커널 버전을 찾습니다.

디바이스 업데이트에서 업데이트를 받지 않은 새 디바이스의 경우 DeviceManagement:DeviceInformation:1.swVersion 값은 디바이스에서 실행되는 펌웨어 버전을 나타냅니다. 업데이트가 디바이스에 적용되면 디바이스 업데이트는 AzureDeviceUpdateCore:ClientMetadata:4.installedUpdateId 속성 값을 사용하여 디바이스에서 실행되는 펌웨어 버전을 나타냅니다.
기본 이미지와 업데이트 이미지 파일의 이름에는 버전 번호가 있습니다.
```
 adu-<image type>-image-<machine>-<version number>.<extension>
```
나중에 "업데이트 가져오기" 섹션에서 해당 버전 번호를 사용합니다.

디바이스에 디바이스 업데이트 그룹 태그 추가

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

업데이트 가져오기

최신 에이전트에 대한 릴리스 자산 아래의 Tutorial_RaspberryPi.zip 샘플 자습서 매니페스트 및 샘플 업데이트(.swu 파일) 및 샘플 A/B 스크립트를 다운로드합니다.
Azure Portal에 로그인하고 Device Update를 사용하여 IoT 허브로 이동합니다. 왼쪽 창의 자동 디바이스 관리에서 업데이트를 선택합니다.
업데이트 탭을 선택합니다.
+ 새 업데이트 가져오기를 선택합니다.
+ 스토리지 컨테이너에서 선택을 선택합니다. 기존 계정을 선택하거나 + 스토리지 계정을 사용하여 새 계정을 만듭니다. 그런 다음 + 컨테이너를 사용하여 기존 컨테이너를 선택하거나 새 컨테이너를 만듭니다. 이 컨테이너는 가져올 업데이트 파일을 스테이징하는 데 사용됩니다.

참고 항목

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

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

가져오기 프로세스에 대한 자세한 내용은 로 업데이트 가져오기를 참조하세요.

디바이스 그룹 보기

Device Update는 그룹을 사용하여 디바이스를 구성합니다. Device Update는 할당된 태그 및 호환성 속성에 따라 디바이스를 그룹으로 자동 정렬합니다. 각 디바이스는 하나의 그룹에만 속하지만 그룹은 서로 다른 디바이스 클래스를 정렬하기 위해 여러 하위 그룹을 가질 수 있습니다.

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

태그 및 그룹에 대한 자세한 내용은 디바이스 그룹 관리를 참조하세요.

업데이트 배포

그룹이 생성되면 최상의 업데이트 아래에 업데이트 링크와 함께 디바이스 그룹에 사용할 수 있는 새 업데이트가 표시되어야 합니다. 한 번 새로 고쳐야 할 수도 있습니다.

규정 준수에 대한 자세한 내용은 디바이스 업데이트 규정 준수를 참조하세요.
그룹 이름을 선택하여 대상 그룹을 선택합니다. 그룹 기본 사항에서 그룹 세부 정보로 리디렉션됩니다.
배포를 시작하려면 현재 배포 탭으로 이동합니다. 사용 가능한 업데이트 섹션에서 원하는 업데이트 옆에 있는 배포 링크를 선택합니다. 지정된 그룹에서 사용할 수 있는 최상의 업데이트는 최상이라는 강조 표시로 나타납니다.
즉시 또는 나중에 시작하도록 배포를 예약합니다. 다음으로 만들기를 선택합니다.

팁

기본적으로 시작 날짜/시간은 현재 시간으로부터 24시간입니다. 배포를 더 일찍 시작하려면 다른 날짜/시간을 선택해야 합니다.
배포 세부 정보에서 상태는 활성으로 바뀝니다. 배포된 업데이트는 (배포 중)으로 표시됩니다.
업데이트가 현재 진행 중인지 확인하려면 준수 차트를 봅니다.
디바이스가 성공적으로 업데이트되면 규정 준수 차트 및 배포 세부 정보가 동일하게 반영되도록 업데이트된 것을 볼 수 있습니다.