Device Update for IoT Hub 리소스 관리

Device Update를 시작하려면 Device Update 계정과 인스턴스를 만든 다음 액세스 제어 역할을 설정해야 합니다.

필수 구성 요소

Azure Portal

IoT Hub S1(표준) 계층 이상을 사용하는 것이 좋습니다.

Azure CLI

• IoT Hub S1(표준) 계층 이상을 사용하는 것이 좋습니다.

• Azure CLI 환경:

  • Azure Cloud Shell에서 Bash 환경을 사용합니다.

    

  • 또는 CLI 참조 명령을 로컬에서 실행하려는 경우 Azure CLI를 설치합니다.

    • az login 명령을 사용하여 Azure에 로그인합니다.

    • az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.

    • 메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 이 문서의 명령에서는 azure-iot 확장을 사용합니다. az extension update --name azure-iot를 실행하여 최신 버전의 확장을 사용하고 있는지 확인합니다.

Device Update 계정 및 인스턴스 만들기

Azure Portal

1. Azure Portal에서 리소스 만들기를 선택하고 "Device Update for IoT Hub"를 검색합니다.

   

2. 만들기>Device Update for IoT Hub를 선택합니다.

3. 기본 탭에서 Device Update 계정에 대한 다음 정보를 제공합니다.

   • 구독: Device Update 계정과 연결할 Azure 구독입니다.
   • 리소스 그룹: 기존 또는 새 리소스 그룹입니다.
   • 이름: 계정의 이름입니다.
   • 위치: 계정이 위치할 Azure 지역입니다. Device Update for IoT Hub를 지원하는 지역에 대한 자세한 내용은 지역별 Azure 제품 페이지를 참조하세요.

   참고

   Device Update 계정이 IoT Hub와 동일한 지역에 있을 필요는 없지만 더 나은 성능을 위해 지리적으로 가깝게 유지하는 것이 좋습니다.

   

4. 필요에 따라 확인란을 선택하여 디바이스 업데이트 관리자 역할을 자신에게 할당할 수 있습니다. 액세스 제어 역할 구성 섹션에 나열된 단계를 사용하여 사용자와 애플리케이션에 적절한 수준의 액세스를 위한 역할 조합을 제공할 수도 있습니다.

   역할을 관리하려면 구독에 소유자 또는 사용자 액세스 관리자 권한이 있어야 합니다.

5. 다음: 인스턴스를 선택합니다.

   Device Update 인스턴스는 단일 IoT Hub에 연결됩니다. 디바이스 업데이트에 사용할 IoT Hub를 선택합니다. IoT Hub를 Device Update 인스턴스에 연결하면 Device Update에 IoT Hub를 사용(레지스트리 쓰기 및 서비스 연결)할 수 있는 권한을 부여하는 새 공유 액세스 정책이 자동으로 만들어집니다. 이 정책은 액세스 권한이 디바이스 업데이트로만 제한되도록 합니다.

6. 인스턴스 탭에서 Device Update 인스턴스에 대한 다음 정보를 제공합니다.

   • 이름: 인스턴스의 이름입니다.
   • IoT Hub 세부 정보: 이 인스턴스에 연결할 IoT Hub를 선택합니다.

   

7. 완료되면 다음: 검토 + 만들기를 선택합니다. 유효성 검사 통과 후에 만들기를 선택합니다.

   

8. 배포가 진행 중임을 알 수 있습니다. 몇 분 안에 배포 상태가 “완료”로 변경됩니다. 그러면 리소스로 이동을 선택합니다.

   

Azure CLI

az iot device-update account create 명령을 사용하여 새 Device Update 계정을 만듭니다.

다음 자리 표시자를 고유의 정보로 바꿉니다.

• <resource_group>: 구독의 기존 리소스 그룹입니다.

• <account_name>: Device Update 계정의 이름입니다.

• <region>: 계정이 위치할 Azure 지역입니다. Device Update for IoT Hub를 지원하는 지역에 대한 자세한 내용은 지역별 Azure 제품 페이지를 참조하세요. 지역이 제공되지 않으면 리소스 그룹의 위치가 사용됩니다.

  참고

  Device Update 계정이 IoT Hub와 동일한 지역에 있을 필요는 없지만 더 나은 성능을 위해 지리적으로 가깝게 유지하는 것이 좋습니다.

az iot device-update account create --resource-group <resource_group> --account <account_name> --location <region>

az iot device-update instance create 명령을 사용하여 Device Update 인스턴스를 만듭니다.

Device Update 인스턴스는 단일 IoT Hub에 연결됩니다. 디바이스 업데이트에 사용할 IoT Hub를 선택합니다. IoT Hub를 Device Update 인스턴스에 연결하면 Device Update에 IoT Hub를 사용(레지스트리 쓰기 및 서비스 연결)할 수 있는 권한을 부여하는 새 공유 액세스 정책이 자동으로 만들어집니다. 이 정책은 액세스 권한이 디바이스 업데이트로만 제한되도록 합니다.

다음 자리 표시자를 고유의 정보로 바꿉니다.

• <account_name>: 이 인스턴스가 연결될 Device Update 계정의 이름입니다.
• <instance_name>: 이 인스턴스의 이름입니다.
• <iothub_id>: 이 인스턴스에 연결될 IoT Hub의 리소스 ID입니다. az iot hub show 명령을 사용하고 ID 값 az iot hub show -n <iothub_name> --query id를 쿼리하여 IoT Hub 리소스 ID를 쿼리할 수 있습니다.

az iot device-update instance create --account <account_name> --instance <instance_name> --iothub-ids <iothub_id>

팁

인스턴스 만들기 프로세스의 일부로 진단 로깅을 구성할 수도 있습니다. 자세한 내용은 디바이스에서 원격으로 진단 로그 수집을 참조하세요.

디바이스 업데이트에 대한 액세스 제어 역할 구성

다른 사용자가 Device Update에 액세스할 수 있도록 하려면 이 리소스에 대한 액세스 권한을 사용자에게 부여해야 합니다. 계정을 생성하는 동안 Device Update 관리자 역할을 자신에게 할당했으며 다른 사용자 또는 애플리케이션에 대한 액세스를 제공할 필요가 없는 경우,이 단계를 건너뛸 수 있습니다.

Azure Portal

1. Device Update 계정의 탐색 메뉴에서 IAM(액세스 제어)를 선택합니다.

   

2. 역할 할당 추가를 선택합니다.

3. 역할 탭의 사용 가능한 옵션에서 Device Update 역할을 선택합니다.

   • 디바이스 업데이트 관리자
   • 디바이스 업데이트 읽기 권한자
   • 디바이스 업데이트 콘텐츠 관리자
   • 디바이스 업데이트 콘텐츠 읽기 권한자
   • 디바이스 업데이트 배포 관리자
   • 디바이스 업데이트 배포 읽기 권한자

   자세한 내용은 Device Update for IoT Hub의 역할 기반 액세스 제어에 대해 알아보기를 참조하세요.

   

4. 다음을 선택합니다.

5. 멤버 탭에서 역할을 할당할 사용자 또는 그룹을 선택합니다.

   

6. 검토 + 할당을 선택합니다.

7. 새 역할 할당을 검토하고 검토 + 할당을 다시 선택합니다.

8. 이제 IoT Hub 내에서 Device Update를 사용할 준비가 되었습니다.

Azure CLI

Device Update에 대한 액세스를 할당하는 데 사용할 수 있는 역할은 다음과 같습니다.

• 디바이스 업데이트 관리자
• 디바이스 업데이트 읽기 권한자
• 디바이스 업데이트 콘텐츠 관리자
• 디바이스 업데이트 콘텐츠 읽기 권한자
• 디바이스 업데이트 배포 관리자
• 디바이스 업데이트 배포 읽기 권한자

자세한 내용은 Device Update for IoT Hub의 역할 기반 액세스 제어에 대해 알아보기를 참조하세요.

az role assignment create 명령을 사용하여 Device Update 계정에 대한 액세스 제어를 구성합니다.

다음 자리 표시자를 고유의 정보로 바꿉니다.

• <role>: 할당하는 Device Update 역할입니다.
• <user_group>: 역할을 할당할 사용자 또는 그룹입니다.
• <account_id>: 사용자 또는 그룹이 액세스할 Device Update 계정의 리소스 ID입니다. az iot device-update account show 명령을 사용하고 ID 값 az iot device-update account show -n <account_name> --query id를 쿼리하여 리소스 ID를 쿼리할 수 있습니다.

az role assignment create --role '<role>' --assignee <user_group> --scope <account_id>

IoT Hub 대한 액세스 제어 역할 구성

IoT Hub 디바이스 업데이트는 IoT Hub 통신하여 배포 및 업데이트를 관리하고 디바이스에 대한 정보를 가져옵니다. 액세스를 사용하도록 설정하려면 azure Device Update 서비스 주체에 IoT Hub 데이터 기여자 역할을 사용하여 액세스 권한을 부여해야 합니다.

Azure Portal

1. Azure Portal Device Update 인스턴스에 연결된 IoT Hub로 이동합니다.
2. 탐색 메뉴에서 Access Control(IAM)를 선택합니다.
3. 추가>역할 할당 추가를 선택합니다.
4. 역할 탭에서 IoT Hub 데이터 기여자를 선택합니다. 다음을 선택합니다.
5. 다음에 대한 액세스 할당에서 사용자, 그룹 또는 서비스 주체를 선택합니다.
6. 멤버 선택을 선택하고 'Azure Device Update'를 검색합니다.
7. 다음검토 + 할당을 선택합니다.>

사용 권한을 올바르게 설정했는지 확인하려면 다음을 수행합니다.

1. Azure Portal Device Update 인스턴스에 연결된 IoT Hub로 이동합니다.
2. 탐색 메뉴에서 Access Control(IAM)를 선택합니다.
3. 액세스 확인을 선택합니다.
4. 사용자, 그룹 또는 서비스 주체를 선택하고 'Azure Device Update'를 검색합니다.
5. Azure Device Update를 클릭한 후 IoT Hub 데이터 기여자 역할이 역할 할당 아래에 나열되어 있는지 확인합니다.

Azure CLI

az role assignment create 명령을 사용하여 Azure Device Update 서비스 주체에 대한 역할 할당을 만듭니다.

resource_id IoT Hub의 리소스 ID로 바꿉니다<.> az iot hub show 명령을 사용하고 ID 값 az iot hub show -n <hub_name> --query id에 대해 쿼리하여 리소스 ID를 검색할 수 있습니다.

az role assignment create --role "IoT Hub Data Contributor" --assignee https://api.adu.microsoft.com/ --scope <resource_id>

계정 또는 인스턴스 보기 및 쿼리

모든 Device Update 계정 및 인스턴스를 보고, 정렬하고, 쿼리할 수 있습니다.

Azure Portal

1. 모든 Device Update 계정을 보려면 Azure Portal을 사용하여 Device Update for IoT Hub 서비스를 검색합니다.

   • 그룹화 드롭다운 메뉴를 사용하여 구독, 리소스 그룹, 위치 및 기타 조건별로 계정을 그룹화합니다.
   • 리소스 그룹, 위치, 태그 및 기타 조건별로 계정 목록을 필터링하려면 필터 추가를 선택합니다.

2. 계정의 모든 인스턴스를 보려면 Azure Portal에서 해당 계정으로 이동합니다. 메뉴의 인스턴스 관리 섹션에서 인스턴스를 선택합니다.

   • 검색 상자를 사용하여 인스턴스를 필터링합니다.

Azure CLI

모든 Device Update 계정을 보려면 az iot device-update account list 명령을 사용합니다.

az iot device-update account list 

계정의 모든 인스턴스를 보려면 az iot device-update instance list 명령을 사용합니다.

az iot device-update instance list --account <account_name>

두 list 명령은 추가 그룹화 및 필터 작업을 지원합니다. --query 인수를 사용하여 태그와 같은 조건을 기반으로 계정 또는 인스턴스를 찾습니다. 예: --query "[?tags.env == 'test']". --output 인수를 사용하여 결과 형식을 지정합니다. 예: --output table

다음 단계

다음 빠른 자습서 중 하나를 사용하여 디바이스를 업데이트해 보세요.

• 시뮬레이트된 IoT Edge 디바이스 업데이트
• Raspberry Pi 업데이트
• Ubuntu Server 18.04 x64 패키지 에이전트 업데이트

디바이스 업데이트 계정 및 인스턴스에 대해 알아봅니다.

Device Update 액세스 제어 역할에 대해 알아보기