다음을 통해 공유


공개 미리 보기에서 공개 미리 보기 새로 고침으로 디바이스 및 그룹 마이그레이션

IoT Hub용 디바이스 업데이트 서비스가 새 버전을 릴리스하면 최신 기능 및 보안 향상을 위해 디바이스를 업데이트해야 합니다. 이 문서에서는 공개 미리 보기 릴리스 에서 현재 PPR(공개 미리 보기 새로 고침) 릴리스로 마이그레이션하는 방법에 대한 정보를 제공합니다. 또한 이 문서에서는 이러한 릴리스의 그룹 및 UX 동작에 대해서도 설명합니다. 공개 미리 보기 릴리스를 사용하는 디바이스, 그룹 및 배포가 없는 경우 이 페이지를 무시할 수 있습니다.

성공적으로 마이그레이션하려면 디바이스에서 실행되는 DU 에이전트를 업그레이드해야 합니다. 또한 업데이트를 배포하고 관리하기 위해 새 디바이스 그룹을 만들어야 합니다. PPR 릴리스의 주요 변경 사항이 있으므로 오류를 방지하기 위해 지침을 면밀히 따르는 것이 좋습니다.

디바이스 업데이트 에이전트 업데이트

공개 미리 보기 새로 고침 릴리스의 경우 아래에 설명된 대로 디바이스 업데이트 에이전트를 수동으로 업데이트해야 합니다. 공개 미리 보기 및 PPR 릴리스의 주요 변경으로 인해 디바이스 업데이트 배포를 통해 에이전트를 업데이트할 수 없습니다.

  1. 이전 에이전트(버전 0.7.0/0.6.0) 및 2022년 02월 3일 이전에 만든 그룹을 사용하여 디바이스를 보려면 배너를 통해 액세스할 수 있는 공개 미리 보기 포털로 이동합니다.

    배너 스크린샷

  2. Azure Portal에서 새 IoT/IoT Edge 디바이스를 만듭니다. 나중에 디바이스 보기에서 디바이스에 대한 기본 연결 문자열을 복사합니다. 자세한 내용은 IoT Hub에 디바이스 추가 섹션을 참조하세요.

  3. 그런 다음 디바이스에 SSH를 실행하고 이전 디바이스 업데이트 에이전트를 제거합니다.

    sudo apt remove deviceupdate-agent 
    sudo apt remove adu-agent 
    
  4. 이전 구성 파일 제거

    sudo rm -f /etc/adu/adu-conf.txt 
    
  5. 새 에이전트 설치

    sudo apt-get install deviceupdate-agent 
    

    또는 GitHub 에서 .deb 자산을 가져와서 에이전트를 설치할 수 있습니다.

    sudo apt install <file>.deb
    

    이전 에이전트 및 구성 파일을 제거하지 않고 디바이스 업데이트 에이전트를 업그레이드하려고 하면 아래와 같은 오류가 발생합니다.

    업데이트 오류의 스크린샷.

  6. 아래 명령을 실행하여 구성 파일에 IoT 디바이스의 디바이스(또는 디바이스 업데이트를 사용하여 디바이스를 프로비전한 방법에 따라 모듈) 기본 연결 문자열을 입력합니다.

    sudo nano /etc/adu/du-config.json
    
  7. 구성 파일에 모델, 제조업체, 에이전트 이름, 연결 유형 및 기타 세부 정보 추가

  8. 공개 미리 보기 포털에서 이전 IoT/IoT Edge 디바이스를 삭제합니다.

비고

DU 배포를 통해 에이전트를 업데이트하려고 하면 디바이스 업데이트에서 디바이스를 더 이상 관리할 수 없게 됩니다. 디바이스 업데이트에서 관리하려면 디바이스를 다시 프로비전해야 합니다.

그룹을 공개 미리 보기 새로 고침 버전으로 이전하기

  1. 디바이스에서 디바이스 업데이트 에이전트 버전 0.6.0 또는 0.7.0을 사용하는 경우 위의 단계에 따라 최신 에이전트 버전 0.8.0으로 업그레이드합니다.

  2. 배너를 탐색하여 공개 미리 보기 포털에서 기존 그룹을 삭제합니다.

  3. 업데이트된 디바이스의 디바이스 쌍에 그룹 태그를 추가합니다. 자세한 내용은 디바이스에 태그 추가 섹션을 참조하세요 .

  4. '그룹 추가'로 이동하고 드롭다운 목록에서 해당 그룹 태그를 선택하여 PPR 포털에서 그룹을 다시 만듭니다.

  5. 퍼블릭 미리 보기 포털의 그룹이 삭제되지 않은 경우 이름이 같은 그룹을 PPR 포털에서 만들 수 없습니다.

릴리스 간 그룹 및 배포 동작

  • 공개 미리 보기 새로 고침 릴리스 포털에서 만든 그룹은 최신 디바이스 업데이트 에이전트(0.8.0)를 사용하여 디바이스를 추가하는 것만 허용합니다. 이전 에이전트가 있는 디바이스(0.7.0/0.6.0)는 이러한 그룹에 추가할 수 없습니다.

  • 최신 에이전트를 사용하는 모든 새 디바이스는 '그룹 및 배포' 탭의 기본 DeviceClass 그룹에 자동으로 추가됩니다. 그룹 태그가 디바이스 속성에 추가되면 해당 태그에 대한 그룹이 있는 경우 디바이스가 해당 그룹에 추가됩니다.

  • 최신 에이전트를 사용하는 디바이스의 경우 그룹 태그가 디바이스 속성에 추가되었지만 해당 그룹이 아직 만들어지지 않은 경우 디바이스는 '그룹 및 배포' 탭에 표시되지 않습니다.

  • 이전 에이전트를 사용하는 디바이스는 그룹 태그가 추가되지 않은 경우 이전 포털에서 그룹화되지 않은 상태로 표시됩니다.

다음 단계

디바이스 업데이트 에이전트 구성 파일 이해하기

IoT Hub용 디바이스 업데이트의 간단한 데모를 위해 다음 자습서를 사용할 수 있습니다.