대칭 키를 사용하여 IoT Edge for Linux on Window 디바이스 만들기 및 프로비전

아티클
05/06/2024

적용 대상: IoT Edge 1.4

Important

IoT Edge 1.5 LTS 및 IoT Edge 1.4는 지원되는 릴리스입니다. IoT Edge 1.4 LTS는 2024년 11월 12일에 수명이 종료됩니다. 이전 릴리스에 있는 경우 IoT Edge 업데이트를 참조하세요.

이 문서에서는 IoT Edge for Linux on Windows 디바이스를 등록하고 프로비전하기 위한 엔드투엔드 지침을 제공합니다.

IoT 허브에 연결하는 모든 디바이스에는 클라우드-디바이스 또는 디바이스-클라우드 통신을 추적하는 데 사용되는 디바이스 ID가 있습니다. IoT 허브 호스트 이름, 디바이스 ID, 디바이스에서 IoT Hub 인증에 사용하는 정보를 포함하는 연결 정보로 디바이스를 구성합니다.

이 문서의 단계는 단일 디바이스를 IoT 허브에 연결하는 수동 프로비저닝이라는 프로세스를 안내합니다. 수동 프로비저닝을 위해 IoT Edge 디바이스를 인증하는 두 가지 옵션이 있습니다.

대칭 키: IoT Hub에서 새 디바이스 ID를 만드는 경우 서비스에서 두 개의 키를 만듭니다. 디바이스에 키 중 하나를 저장하고 인증 시 IoT Hub 키를 제시합니다.

이 인증 방식을 사용하면 빠르게 시작할 수 있지만 안전하지 않습니다.
X.509 자체 서명: 두 개의 x.509 ID 인증서를 만들어 디바이스에 저장합니다. IoT Hub에서 새 디바이스 ID를 만들 때 두 인증서의 지문을 모두 제공합니다. 디바이스는 IoT Hub에 인증 시 인증서 하나를 제시되고 IoT Hub는 인증서가 지문과 일치하는지 확인합니다.

이 인증 방식은 더 안전하며 프로덕션 시나리오에 권장됩니다.

이 문서에서는 대칭 키를 인증 방법으로 사용하는 방법을 설명합니다. X.509 인증서를 사용하려면 X.509 인증서를 사용하여 IoT Edge for Linux on Windows 디바이스 만들기 및 프로비전을 참조하세요.

참고 항목

설정할 디바이스가 많고 각 디바이스를 수동으로 프로비저닝하지 않으려면 다음 문서 중 하나를 읽고 IoT Hub Device Provisioning Service에서 IoT Edge를 사용하는 방법을 알아보세요.

필수 조건

이 문서에서는 IoT Edge 디바이스를 등록하고 IoT Edge for Linux on Windows를 설치하는 방법을 설명합니다. 이러한 작업에는 작업을 수행하는 데 사용되는 다양한 필수 구성 요소와 유틸리티가 있습니다. 계속하기 전에 모든 필수 구성 요소가 충족되었는지 확인합니다.

디바이스 관리 도구

디바이스를 등록하는 단계에서 Azure Portal, Visual Studio Code 또는 Azure CLI를 사용할 수 있습니다. 각 유틸리티에는 자체 필수 조건이 있거나 설치해야 할 수 있습니다.

Azure 구독의 무료 또는 표준 IoT Hub.

디바이스 요구 사항

다음과 같은 최소 요구 사항을 충족하는 Windows 디바이스:

시스템 요구 사항
- Windows 10¹/11(Pro, Enterprise, IoT Enterprise)
- Windows Server 2019¹/2022
  _{¹ 최신 누적 업데이트가 모두 설치된 Windows 10 및 Windows Server 2019 최소 빌드 17763입니다.}
하드웨어 요구 사항
- 사용 가능한 최소 메모리: 1GB
- 사용 가능한 최소 디스크 공간: 10GB
가상화 지원
- Windows 10에서 Hyper-V를 사용하도록 설정합니다. 자세한 내용은 Hyper-V를 Windows 10에 설치를 참조하세요.
- Windows Server에서 Hyper-V 역할을 설치하고 기본 네트워크 스위치를 만듭니다. 자세한 내용은 Azure IoT Edge for Linux on Windows의 중첩된 가상화를 참조하세요.
- 가상 머신에서 중첩 가상화를 구성합니다. 자세한 내용은 중첩된 가상화를 참조하세요.
네트워킹 지원
- Windows Server에는 기본 스위치가 없습니다. EFLOW를 Windows Server 디바이스에 배포하려면 먼저 가상 스위치를 만들어야 합니다. 자세한 내용은 Windows에서 Linux용 가상 스위치 만들기를 참조하세요.
- Windows 데스크톱 버전에는 EFLOW 설치에 사용할 수 있는 기본 스위치가 있습니다. 필요한 경우 고유한 사용자 지정 가상 스위치를 만들 수 있습니다.

팁

Windows 배포의 Linux용 Azure IoT Edge에서 GPU 가속 Linux 모듈을 사용하려는 경우 고려해야 할 몇 가지 구성 옵션이 있습니다.

GPU 아키텍처에 따라 올바른 드라이버를 설치해야 하며 Windows 참가자 프로그램 빌드에 액세스해야 할 수도 있습니다. 구성 요구 사항을 확인하고 이러한 필수 조건을 충족하려면 Windows의 Linux용 Azure IoT Edge에 대한 GPU 가속을 참조하세요.

지금 시간을 내어 GPU 가속을 위한 필수 구성 요소를 충족시키세요. 설치 중에 GPU 가속을 원하는 경우 설치 프로세스를 다시 시작해야 합니다.

개발자 도구

Azure IoT Edge for Linux on Windows 설치 및 Linux 가상 머신 배포를 위한 대상 디바이스를 준비합니다.

대상 디바이스의 실행 정책을 AllSigned로 설정합니다. 다음 명령을 사용하여 관리자 권한 PowerShell 프롬프트에서 현재 실행 정책을 확인할 수 있습니다.
```
Get-ExecutionPolicy -List
```
local machine의 실행 정책이 AllSigned가 아닌 경우 다음을 사용하여 실행 정책을 설정할 수 있습니다.
```
Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
```

Azure IoT Edge for Linux on Windows PowerShell 모듈에 대한 자세한 내용은 PowerShell 함수 참조를 확인하세요.

디바이스 등록

기본 설정에 따라 Azure Portal, Visual Studio Code 또는 Azure CLI를 사용하여 디바이스를 등록할 수 있습니다.

Azure Portal의 IoT 허브에서 IoT Edge 디바이스는 에지가 사용 설정되지 않은 IoT 디바이스와 별도로 만들어지고 관리됩니다.

Azure Portal에 로그인하고 IoT Hub로 이동합니다.
왼쪽 창의 메뉴에서 디바이스를 선택한 다음, 디바이스 추가를 선택합니다.
디바이스 만들기 페이지에서 다음 정보를 입력합니다.
- 예를 들어 my-edge-device-1(모두 소문자)과 같이 설명이 포함된 디바이스 ID를 만듭니다. 나중에 사용할 것이므로 이 디바이스 ID를 복사합니다.
- IoT Edge 디바이스 확인란을 선택합니다.
- 인증 유형으로 대칭 키를 선택합니다.
- 허브에 새 디바이스를 연결하는 인증 키를 자동으로 생성하려면 기본 설정을 사용합니다.
저장을 선택합니다.

IoT 허브에 나열된 새 디바이스가 표시되어야 합니다.

Visual Studio Code용 Azure IoT 확장을 사용하여 IoT Hub에 대한 작업을 수행할 수 있습니다. Azure IoT 확장 필수 구성 요소를 설치했는지 확인합니다.

Azure IoT Edge 및 Azure IoT Hub 확장이 설치되면 Azure 아이콘이 왼쪽 아이콘 메뉴에 추가됩니다. Azure 아이콘을 선택한 다음 Azure에 로그인을 선택하여 Visual Studio Code를 통해 Azure 계정에 로그인할 수 있습니다.

Visual Studio Code를 사용하여 새 디바이스 등록

새 디바이스를 등록하는 것은 Azure Portal에서 IoT Edge 디바이스를 만드는 것과 비슷합니다. 이 가상 디바이스는 트윈 중 하나인 반면 실제 디바이스는 다른 트윈입니다. Visual Studio Code는 다음 단계를 통해 이를 설정할 수 있습니다.

Visual Studio Code 탐색기 메뉴에서 Azure IoT Hub 섹션을 확장합니다.
Azure IoT Hub 섹션 헤더에서 ...를 클릭합니다. 줄임표가 표시되지 않으면 헤더를 클릭하거나 마우스로 가리킵니다.
IoT Edge 디바이스 만들기를 선택합니다.
열리는 텍스트 상자에서 디바이스 ID(예: my-edge-device-1(모두 소문자))를 입력한 다음 Enter 키를 누릅니다.

Visual Studio Code의 출력 콘솔에서 명령의 결과인 JSON 출력을 볼 수 있습니다. 디바이스 정보에는 사용자가 제공한 deviceId가 포함되며 실제 디바이스를 IoT 허브에 연결하는 데 사용할 수 있는 connectionString을 생성합니다. 출력 콘솔에는 키 및 기타 디바이스 식별 정보도 표시됩니다.

이제 탐색기 메뉴의 Azure IoT Hub>디바이스 섹션에 나열된 디바이스를 볼 수 있습니다.

참고 항목

디바이스가 목록에 없으면 Azure IoT Hub 아래에 제공된 IoT Hub 선택 링크에서 IoT Hub를 선택한 다음 프롬프트를 따라야 할 수 있습니다. 프롬프트에서 먼저 구독을 선택한 다음 IoT Hub를 선택하라는 메시지가 표시됩니다. 이 프로세스를 통해 Visual Studio Code는 IoT Hub(및 그 안의 모든 디바이스)에 대해 알 수 있습니다. Visual Studio Code를 새로 고치면 디바이스가 표시됩니다.

다음 az iot hub device-identity create 명령을 사용하여 IoT 허브에서 새 디바이스 ID를 만듭니다. device_id_here를 새롭고 고유한 디바이스 ID로 바꿉니다(예: my-edge-device-1(모두 소문자)). hub_name_here를 기존 IoT 허브로 바꿉니다.

이 명령에는 세 개의 매개 변수가 포함됩니다.

--device-id 또는 -d: IoT 허브 내에서 고유한 설명 이름을 제공합니다.
--hub-name 또는 -n: IoT 허브의 이름을 제공합니다.

--edge-enabled 또는 --ee: 디바이스가 IoT Edge 디바이스임을 선언합니다.

az iot hub device-identity create --device-id device_id_here --hub-name hub_name_here --edge-enabled

CLI에서 명령에 azure-iot 확장이 필요합니다. 지금 설치하시겠습니까?라고 표시되는 경우, Y를 입력한 다음 Enter 키를 눌러 다운로드를 시작하여 디바이스를 생성합니다.

이제 IoT Hub에 디바이스가 등록되었으므로 다음 단계에서 IoT Edge 런타임의 설치 및 프로비전을 완료하는 데 사용되는 프로비전 정보를 검색할 수 있습니다.

등록된 디바이스 보기 및 프로비전 정보 검색

대칭 키 인증을 사용하는 디바이스에서 IoT Edge 런타임의 설치 및 프로비저닝을 수행하려면 연결 문자열이 필요합니다. 디바이스를 만들 때 IoT Edge 디바이스에 대한 연결 문자열이 만들어집니다. Visual Studio Code 및 Azure CLI의 경우 연결 문자열은 JSON 출력에 있습니다. Azure Portal을 사용하여 디바이스를 만드는 경우 디바이스 자체에서 연결 문자열을 찾을 수 있습니다. IoT Hub에서 디바이스를 선택하면 디바이스 페이지에 Primary connection string으로 나열됩니다.

IoT Hub에 연결되는 에지 지원 디바이스는 IoT Hub의 디바이스 페이지에 나열됩니다. 디바이스가 여러 개인 경우 IoT Edge 디바이스 형식을 선택한 다음 적용을 선택하여 목록을 필터링할 수 있습니다.

디바이스를 설정할 준비가 되면, 물리적 디바이스를 IoT Hub에 있는 해당 ID와 연결하는 연결 문자열이 필요합니다. 대칭 키를 사용하여 인증하는 디바이스에는 포털에 복사할 수 있는 연결 문자열이 있습니다. 포털에서 연결 문자열을 찾으려면:

디바이스 페이지의 목록에서 IoT Edge 디바이스 ID를 선택합니다.
기본 연결 문자열 또는 보조 연결 문자열 중 하나의 값을 복사합니다. 두 키 모두 작동합니다.

IoT Hub의 모든 디바이스를 보려면 az iot hub device-identity list 명령을 사용합니다. hub_name_here를 고유한 IoT 허브 이름으로 바꿉니다.

az iot hub device-identity list --hub-name hub_name_here

IoT Edge 디바이스로 등록된 모든 디바이스에서는 capabilities.iotEdge 속성이 true로 설정됩니다. 디바이스 ID를 포함하여 다른 많은 메타데이터도 JSON 출력으로 표시됩니다.

디바이스를 설정할 준비가 되면, 물리적 디바이스를 IoT Hub에 있는 해당 ID와 연결하는 연결 문자열이 필요합니다. 다음 az iot hub device-identity connection-string show 명령을 사용하여 단일 디바이스에 대한 연결 문자열을 반환합니다. [device_id] 및 [hub_name]를 사용자 고유의 값으로 바꿉니다. device-identity 매개 변수의 값은 대소문자를 구분합니다.

az iot hub device-identity connection-string show --device-id [device_id] --hub-name [hub_name]

콘솔에 다음과 유사한 JSON 출력이 표시되어야 합니다.

{
  "connectionString": "HostName=my-iot-hub.azure-devices.net;DeviceId=my-edge-device-1;SharedAccessKey=saQ52bt6BBUlRfusqWuxPMAx4ysQwWEb5+1eidwzHPY="
}

팁

connection-string show 명령은 Azure IoT 확장 0.9.8 버전에서 도입되었으며 지원 중단된 show-connection-string 명령을 대체합니다. 이 명령을 실행 시 오류가 발생하면 확장 버전이 0.9.8 이상으로 업데이트되었는지 확인합니다. 자세한 내용 및 최신 업데이트는 Azure CLI용 Microsoft Azure IoT 확장을 참조하세요.

디바이스에서 사용할 연결 문자열을 복사하는 경우 연결 문자열 앞뒤의 따옴표를 포함하지 마세요.

IoT Edge 설치

대상 디바이스에 Windows의 Linux용 Azure IoT Edge를 배포합니다.

참고 항목

다음 PowerShell 프로세스에서는 Windows의 Linux용 IoT Edge를 로컬 디바이스에 배포하는 방법을 간략하게 설명합니다. PowerShell을 사용하여 원격 대상 디바이스에 배포하려면 원격 PowerShell을 사용하여 원격 디바이스에 대한 연결을 설정하고 해당 디바이스에서 이러한 명령을 원격으로 실행합니다.

관리자 권한 PowerShell 세션에서 대상 디바이스 아키텍처에 따라 다음 명령을 실행하여 IoT Edge for Linux on Windows를 다운로드합니다.

X64/AMD64

$msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
$ProgressPreference = 'SilentlyContinue'
Invoke-WebRequest "https://aka.ms/AzEFLOWMSI_1_4_LTS_X64" -OutFile $msiPath

ARM64

$msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
$ProgressPreference = 'SilentlyContinue'
Invoke-WebRequest "https://aka.ms/AzEFLOWMSI_1_4_LTS_ARM64" -OutFile $msiPath

IoT Edge for Linux on Windows를 디바이스에 설치합니다.
```
Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"
```
설치 명령에 INSTALLDIR="<FULLY_QUALIFIED_PATH>" 및 VHDXDIR="<FULLY_QUALIFIED_PATH>" 매개 변수를 추가하여 Windows의 Linux 설치 및 VHDX 디렉터리용 사용자 지정 IoT Edge를 지정할 수 있습니다. 예를 들어 D:\EFLOW 폴더를 설치에 사용하고 D:\EFLOW-VHDX를 VHDX에 사용하려는 경우 다음 PowerShell cmdlet을 사용할 수 있습니다.
```
Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn","INSTALLDIR=D:\EFLOW", "VHDXDIR=D:\EFLOW-VHDX"
```
대상 디바이스의 실행 정책이 아직 설정되지 않은 경우 AllSigned로 설정합니다. 현재 실행 정책을 확인하고 실행 정책을 AllSigned로 설정하는 명령에 대한 PowerShell 필수 구성 요소를 확인합니다.
IoT Edge for Linux on Windows 배포를 만듭니다. 배포하면 Linux 가상 머신이 생성되고 IoT Edge 런타임이 자동으로 설치됩니다.
```
Deploy-Eflow
```
팁

기본적으로 Deploy-Eflow 명령은 RAM 1GB, vCPU 코어 1개, 디스크 공간 16GB를 사용하여 Linux 가상 머신을 만듭니다. 그러나 VM에 필요한 리소스는 배포하는 워크로드에 따라 달라집니다. 워크로드를 지원하기에 충분 한 메모리가 없는 VM은 시작되지 않습니다.

Deploy-Eflow 명령의 선택적 매개 변수를 사용하여 가상 컴퓨터의 사용 가능한 리소스를 사용자 지정할 수 있습니다. 이는 EFLOW를 최소 하드웨어 요구 사항이 있는 디바이스에 배포하는 데 필요합니다.

예를 들어 아래 명령에서는 1개 vCPU 코어, 1GB RAM(MB 단위로 표시) 및 2GB 디스크 공간이 있는 가상 머신을 만듭니다.
```
Deploy-Eflow -cpuCount 1 -memoryInMB 1024 -vmDataSize 2
```
사용 가능한 모든 선택적 매개 변수에 대한 자세한 내용은 Windows의 Linux용 IoT Edge용 PowerShell 함수를 참조하세요.
Warning

기본적으로 EFLOW Linux 가상 머신에는 DNS 구성이 없습니다. DHCP를 사용하는 배포에서는 DHCP 서버에서 전파하는 DNS 구성을 가져오려고 시도합니다. 인터넷 연결을 확인하려면 DNS 구성을 확인하세요. 자세한 내용은 AzEFLOW-DNS를 참조하세요.

배포에 GPU를 할당하여 GPU 가속 Linux 모듈을 사용하도록 설정할 수 있습니다. 이러한 기능에 액세스하려면 Windows의 Linux용 Azure IoT Edge용 GPU 가속에 설명된 필수 구성 요소를 설치해야 합니다.

GPU 통과를 사용하려면 gpuName, gpuPassthroughType 및 gpuCount 매개 변수를 Deploy-Eflow 명령에 추가합니다. 사용 가능한 모든 선택적 매개 변수에 대한 자세한 내용은 Windows의 Linux용 IoT Edge용 PowerShell 함수를 참조하세요.

Warning

하드웨어 디바이스 통과를 사용하도록 설정하면 보안 위험이 증가할 수 있습니다. Microsoft는 해당되는 경우 GPU 공급업체의 디바이스 완화 드라이버를 권장합니다. 자세한 내용은 개별 디바이스 할당을 사용하여 그래픽 디바이스 배포를 참조하세요.
'Y'를 입력하여 사용 조건에 동의합니다.
기본 설정에 따라 'O' 또는 'R'을 입력하여 선택적 진단 데이터를 설정하거나 해제합니다.
배포가 완료되면 PowerShell 창에 배포 성공이 보고됩니다.

배포에 성공하면 디바이스를 프로비전할 준비가 된 것입니다.

클라우드 ID를 사용한 디바이스 프로비전

클라우드 ID 및 인증 정보를 사용하여 디바이스를 설정할 준비가 되었습니다.

대칭 키를 사용하여 디바이스를 프로비전하려면 디바이스의 연결 문자열이 필요합니다.

대상 디바이스의 관리자 권한 PowerShell 세션에서 다음 명령을 실행합니다. 자리 표시자 텍스트를 고유한 값으로 바꿉니다.

Provision-EflowVm -provisioningType ManualConnectionString -devConnString "PASTE_DEVICE_CONNECTION_STRING_HERE"

Provision-EflowVM 명령에 대한 자세한 내용은 Windows의 Linux용 IoT Edge용 PowerShell 함수를 참조하세요.

구성 성공 확인

IoT Edge for Linux on Windows가 IoT Edge 디바이스에 성공적으로 설치되고 구성되었는지 확인합니다.

PowerShell 세션에서 다음 명령을 사용하여 IoT Edge for Linux on Windows 가상 머신에 로그인합니다.
```
Connect-EflowVm
```
참고 항목

가상 머신에 SSH로 연결하도록 허용되는 유일한 계정은 가상 머신을 만든 사용자입니다.
로그인하면 다음 Linux 명령을 사용하여 실행되는 IoT Edge 모듈의 목록을 확인할 수 있습니다.
```
sudo iotedge list
```
IoT Edge 서비스 문제를 해결해야 하는 경우 다음 Linux 명령을 사용합니다.
1. 서비스 로그를 검색합니다.
```
sudo iotedge system logs
```
2. check 도구를 사용하여 디바이스의 구성 및 연결 상태를 확인합니다.
```
sudo iotedge check
```
참고 항목

새로 프로비전된 디바이스에서 IoT Edge Hub와 관련된 오류가 표시될 수 있습니다.

× 프로덕션 준비: Edge Hub의 스토리지 디렉터리가 호스트 파일 시스템에 유지되고 있습니다. - 오류

edgeHub 컨테이너의 현재 상태를 확인할 수 없습니다.

IoT Edge Hub 모듈이 실행되고 있지 않으므로 새로 프로비저닝된 디바이스에서 이 오류가 예상됩니다. 오류를 해결하려면 IoT Hub에서 디바이스에 대한 모듈을 설정하고 배포를 만듭니다. 디바이스에 대한 배포를 만들면 IoT Edge Hub 모듈을 포함하여 디바이스에서 모듈이 시작됩니다.

새 IoT Edge 디바이스를 만들면 Azure Portal에 상태 코드 417 -- The device's deployment configuration is not set이 표시됩니다. 이 상태는 정상이며 디바이스가 모듈 배포를 수신할 준비가 되었음을 의미합니다.

IoT Edge for Linux on Windows 제거

디바이스에서 Azure IoT Edge for Linux on Windows 설치를 제거하려면 다음 명령을 사용합니다.

Windows에서 설정 열기
프로그램 추가/제거 선택
Azure IoT Edge 앱 선택
제거 선택

다음 단계

IoT Edge 모듈 배포로 계속 진행하여 모듈을 디바이스에 배포하는 방법을 알아봅니다.
IoT Edge for Linux on Windows 가상 머신에서 인증서를 관리하고 파일을 호스트 OS에서 Linux 가상 머신으로 전송하는 방법을 알아봅니다.
프록시 서버를 통해 통신하도록 IoT Edge 디바이스를 구성하는 방법을 알아봅니다.

대칭 키를 사용하여 IoT Edge for Linux on Window 디바이스 만들기 및 프로비전

필수 조건

디바이스 관리 도구

디바이스 요구 사항

개발자 도구

디바이스 등록

등록된 디바이스 보기 및 프로비전 정보 검색

IoT Edge 설치

클라우드 ID를 사용한 디바이스 프로비전

구성 성공 확인

IoT Edge for Linux on Windows 제거

다음 단계

추가 리소스