IoT Edge 모듈의 Azure Blob Storage를 디바이스에 배포

아티클
04/11/2024

적용 대상: IoT Edge 1.5 IoT Edge 1.4

Important

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

IoT Edge 디바이스에 모듈을 배포하는 여러 가지 방법이 있는데, 모든 방법이 IoT Edge 모듈의 Azure Blob Storage에서 작동합니다. 가장 간단한 두 가지 방법은 Azure Portal 또는 Visual Studio Code 템플릿을 사용하는 것입니다.

필수 조건

Azure 구독의 IoT Hub
IoT Edge 디바이스.

IoT Edge 디바이스를 설정하지 않은 경우 Azure 가상 머신에서 만들 수 있습니다. 빠른 시작 문서 중 하나에 있는 단계에 따라 가상 Linux 디바이스를 만들거나 가상 Windows 디바이스를 만듭니다.
Visual Studio Code
Azure IoT Edge 확장 Visual Studio Code용 Azure IoT Edge 도구 확장은 유지 관리 모드에 있습니다.
Visual Studio Code에서 배포하는 경우 Azure IoT Hub 확장입니다.

Azure Portal에서 배포

Azure Portal에서는 배포 매니페스트를 만들고 IoT Edge 디바이스에 배포를 푸시하는 방법을 안내합니다.

디바이스 선택

Azure Portal에 로그인하고 IoT Hub로 이동합니다.
장치 관리 메뉴 아래에서 디바이스를 선택합니다.
목록에서 대상 IoT Edge 디바이스를 선택합니다.
모듈 설정을 선택합니다.

배포 매니페스트 구성

배포 매니페스트는 배포할 모듈, 모듈 간의 데이터 흐름 및 모듈 쌍의 desired 속성을 설명하는 JSON 문서입니다. Azure Portal에는 배포 매니페스트를 만들 수 있도록 안내하는 마법사가 있습니다. 마법사는 모듈, 경로 및 검토 + 만들기 탭으로 구성된 세 단계를 제공합니다.

모듈 추가

페이지의 IoT Edge 모듈 섹션에서 추가 드롭다운을 선택하고 IoT Edge 모듈을 선택하면 IoT Edge 모듈 추가 페이지가 표시됩니다.
설정 탭에서 모듈의 이름을 입력한 다음, 컨테이너 이미지 URI를 지정합니다.
- IoT Edge 모듈 이름: azureblobstorageoniotedge
- 이미지 URI: mcr.microsoft.com/azure-blob-storage:latest
이 절차에 설명된 대로 모듈 설정, 컨테이너 만들기 옵션 및 모듈 쌍 설정 탭에서 값을 지정할 때까지 추가를 선택하지 마세요.

Important

Azure IoT Edge는 모듈을 호출할 때 대/소문자를 구분하며, Storage SDK도 기본적으로 소문자로 설정됩니다. 이름을 소문자로 변경하면 IoT Edge 모듈의 Azure Blob Storage에 대한 연결이 중단되지 않도록 하는 데 도움이 됩니다.
컨테이너 만들기 옵션 탭을 엽니다.

디바이스에 스토리지 계정 정보와 스토리지 탑재를 제공하려면 다음 JSON을 복사하여 입력란에 붙여넣습니다.

{
  "Env":[
    "LOCAL_STORAGE_ACCOUNT_NAME=<local storage account name>",
    "LOCAL_STORAGE_ACCOUNT_KEY=<local storage account key>"
  ],
  "HostConfig":{
    "Binds":[
        "<mount>"
    ],
    "PortBindings":{
      "11002/tcp":[{"HostPort":"11002"}]
    }
  }
}

IoT Edge 모듈 추가 페이지의 컨테이너 만들기 옵션 탭을 보여 주는 스크린샷.

다음 정보를 사용하여 컨테이너 만들기 옵션에 복사한 JSON을 업데이트합니다.
- <local storage account name>을 기억하기 쉬운 이름으로 바꿉니다. 계정 이름은 3~24자여야 하고 소문자와 숫자만 사용해야 합니다. 공백이 없습니다.
- <local storage account key>를 64바이트 base64 키로 바꿉니다. GeneratePlus 같은 도구를 사용하여 키를 생성할 수 있습니다. 이러한 자격 증명을 사용하여 다른 모듈에서 Blob Storage에 액세스합니다.
- 컨테이너 운영 체제에 따라 <mount>를 대체합니다. Blob 모듈이 데이터를 저장하는 IoT Edge 디바이스의 기존 디렉터리에 대한 절대 경로 또는 볼륨 이름을 제공합니다. 스토리지 탑재는 사용자가 제공한 디바이스의 위치를 모듈에서 설정된 위치로 매핑합니다.
Linux 컨테이너의 경우 형식은 <스토리지 경로 또는 볼륨>:/blobroot입니다. 예시:
- 볼륨 탑재 사용: my-volume:/blobroot
- 바인드 탑재 사용: /srv/containerdata:/blobroot. 컨테이너 사용자에게 디렉터리 액세스 권한을 부여하는 단계를 수행해야 합니다.
Important
- IoT Edge 모듈의 Blob Storage에서 특정 위치를 가리키는 스토리지 탑재 값의 후반부를 변경하지 마세요. Linux 컨테이너의 경우 스토리지 탑재는 항상 :/blobroot로 끝나야 합니다.
- IoT Edge는 모듈 컨테이너에 연결된 볼륨을 제거하지 않습니다. 이 동작은 업그레이드 시나리오와 같은 컨테이너 인스턴스 간에 데이터를 유지할 수 있도록 의도적으로 수행됩니다. 그러나 이러한 볼륨을 사용하지 않은 상태로 두면 디스크 공간 소모 및 후속 시스템 오류가 발생할 수 있습니다. 시나리오에서 docker 볼륨을 사용하는 경우, 특히 프로덕션 시나리오의 경우 docker volume prune 및 docker volume rm과 같은 docker 도구를 사용하여 사용하지 않는 볼륨을 제거하는 것이 좋습니다.

모듈 쌍 설정 탭에서 다음 JSON을 복사하여 입력란에 붙여넣습니다.

{
  "deviceAutoDeleteProperties": {
    "deleteOn": <true, false>,
    "deleteAfterMinutes": <timeToLiveInMinutes>,
    "retainWhileUploading": <true,false>
  },
  "deviceToCloudUploadProperties": {
    "uploadOn": <true, false>,
    "uploadOrder": "<NewestFirst, OldestFirst>",
    "cloudStorageConnectionString": "DefaultEndpointsProtocol=https;AccountName=<your Azure Storage Account Name>;AccountKey=<your Azure Storage Account Key>; EndpointSuffix=<your end point suffix>",
    "storageContainersForUpload": {
      "<source container name1>": {
        "target": "<your-target-container-name>"
      }
    },
    "deleteAfterUpload": <true,false>
  }
}

자리 표시자에 나와 있는 대로 적절한 값을 사용하여 각 속성을 구성합니다. IoT Edge 시뮬레이터를 사용하는 경우 deviceToCloudUploadProperties 및 deviceAutoDeleteProperties에 설명된 대로 해당 속성에 대한 관련 환경 변수로 값을 설정합니다.

팁

target 컨테이너의 이름에는 명명 제한이 있습니다. 예를 들어, $ 접두사 사용은 지원되지 않습니다. 모든 제한 사항을 보려면 컨테이너 이름을 확인합니다.

참고 항목

컨테이너 대상이 이름이 할당되지 않았거나 storageContainersForUpload 내에서 null인 경우 대상에 기본 이름이 할당됩니다. 컨테이너에 대한 업로드를 중지하려면 storageContainersForUpload에서 완전히 제거해야 합니다. 자세한 내용은 IoT Edge에서 Azure Blob Storage를 사용하여 에지에 데이터 저장의 deviceToCloudUploadProperties 섹션을 참조하세요.

모듈이 배포된 후 deviceToCloudUploadProperties 및 deviceAutoDeleteProperties를 구성하는 방법에 대한 자세한 내용은 모듈 쌍 편집을 참조하세요. desired 속성에 대한 자세한 내용은 desired 속성 정의 또는 업데이트를 참조하세요.
추가를 선택합니다.
다음: 경로를 선택하여 경로 섹션으로 이동합니다.

경로 지정

기본 경로를 유지하고 다음: 검토 + 만들기를 선택하여 검토 섹션으로 이동합니다.

배포 검토

검토 섹션에서는 이전 두 개의 섹션에서 선택한 항목에 따라 생성된 JSON 배포 매니페스트를 보여줍니다. 추가하지 않고 선언된 $edgeAgent 및 $edgeHub라는 두 개의 모듈도 있습니다. 이 두 개의 모듈은 IoT Edge 런타임을 구성하며 모든 배포에서 필수 기본값입니다.

배포 정보를 검토한 다음 만들기를 선택합니다.

배포 확인

배포를 만든 후 IoT 허브의 디바이스 페이지로 돌아갑니다.

해당 세부 정보를 열려면 배포할 대상으로 지정한 IoT Edge 디바이스를 선택합니다.
디바이스 세부 정보에서 Blob Storage 모듈이 배포에 지정됨 및 디바이스에서 보고됨 모두로 나열되어 있는지를 확인합니다.

디바이스에서 모듈이 시작된 후 IoT Hub에 다시 보고되는 데 몇 분 정도 걸릴 수 있습니다. 업데이트된 상태를 보려면 페이지를 새로 고칩니다.

Visual Studio Code에서 배포

Azure IoT Edge는 Visual Studio Code에 에지 솔루션 개발을 도와주는 템플릿을 제공합니다. 다음 단계에 따라 Blob Storage 모듈을 사용하여 새 IoT Edge 솔루션을 만들고, 배포 매니페스트를 구성합니다.

Important

Azure IoT Edge Visual Studio Code 확장은 유지 관리 모드에 있습니다.

뷰>명령 팔레트를 선택합니다.

명령 팔레트에서 Azure IoT Edge: 새로운 IoT Edge 솔루션 명령을 입력하고 실행합니다.

새로운 IoT Edge 솔루션을 실행하는 방법을 보여 주는 스크린샷.

명령 팔레트의 프롬프트에 따라 솔루션을 만듭니다.

필드	값
폴더 선택	Visual Studio Code에 대한 개발 머신에서 위치를 선택하여 솔루션 파일을 만듭니다.
솔루션 이름 제공	솔루션에 대한 설명이 포함된 이름을 입력하거나 기본값 EdgeSolution을 적용합니다.
모듈 템플릿 선택	기존 모듈(전체 이미지 URL 입력)을 선택합니다.
모듈 이름 제공	모듈에 대한 이름을 모두 소문자로 입력합니다(예: azureblobstorageoniotedge). IoT Edge 모듈에서 Azure Blob Storage에 사용할 이름은 반드시 소문자로 사용해야 합니다. IoT Edge는 모듈을 참조할 때 대/소문자를 구분하며 Storage SDK는 기본적으로 소문자로 설정됩니다.
모듈의 Docker 이미지 제공	이미지 URI를 mcr.microsoft.com/azure-blob-storage:latest로 입력합니다.

Visual Studio Code는 입력한 정보를 사용하여 IoT Edge 솔루션을 만든 다음, 새 창에서 로드합니다. 솔루션 템플릿은 Blob Storage 모듈 이미지를 포함하는 배포 매니페스트 템플릿을 만들지만, 모듈의 만들기 옵션을 구성해야 합니다.

새 솔루션 작업 영역에서 deployment.template.json을 열고 모듈 섹션을 찾습니다. 다음 구성을 변경합니다.

다음 코드를 복사하여 Blob Storage 모듈의 createOptions 필드에 붙여넣습니다.


```json
"Env":[
 "LOCAL_STORAGE_ACCOUNT_NAME=<local storage account name>",
 "LOCAL_STORAGE_ACCOUNT_KEY=<local storage account key>"
],
"HostConfig":{
  "Binds": ["<mount>"],
  "PortBindings":{
    "11002/tcp": [{"HostPort":"11002"}]
  }
}

Visual Studio Code에서 모듈 createOptions를 업데이트하는 방법을 보여 주는 스크린샷.

<local storage account name>을 기억하기 쉬운 이름으로 바꿉니다. 계정 이름은 3~24자여야 하고 소문자와 숫자만 사용해야 합니다. 공백이 없습니다.
<local storage account key>를 64바이트 base64 키로 바꿉니다. GeneratePlus 같은 도구를 사용하여 키를 생성할 수 있습니다. 이러한 자격 증명을 사용하여 다른 모듈에서 Blob Storage에 액세스합니다.
컨테이너 운영 체제에 따라 <mount>를 대체합니다. IoT Edge 디바이스에서 Blob 모듈이 데이터를 저장할 볼륨 이름 또는 디렉터리 절대 경로를 제공합니다. 스토리지 탑재는 사용자가 제공한 디바이스의 위치를 모듈에서 설정된 위치로 매핑합니다.

Linux 컨테이너의 경우 형식은 <스토리지 경로 또는 볼륨>:/blobroot입니다. 예시:
- 볼륨 탑재 사용: my-volume:/blobroot
- 바인드 탑재 사용: /srv/containerdata:/blobroot. 컨테이너 사용자에게 디렉터리 액세스 권한을 부여하는 단계를 수행해야 합니다.
Important
- IoT Edge 모듈의 Blob Storage에서 특정 위치를 가리키는 스토리지 탑재 값의 후반부를 변경하지 마세요. Linux 컨테이너의 경우 스토리지 탑재는 항상 :/blobroot로 끝나야 합니다.
- IoT Edge는 모듈 컨테이너에 연결된 볼륨을 제거하지 않습니다. 이 동작은 업그레이드 시나리오와 같은 컨테이너 인스턴스 간에 데이터를 유지할 수 있도록 의도적으로 수행됩니다. 그러나 이러한 볼륨을 사용하지 않은 상태로 두면 디스크 공간 소모 및 후속 시스템 오류가 발생할 수 있습니다. 시나리오에서 docker 볼륨을 사용하는 경우, 특히 프로덕션 시나리오의 경우 docker volume prune 및 docker volume rm과 같은 docker 도구를 사용하여 사용하지 않는 볼륨을 제거하는 것이 좋습니다.

deployment.template.json 파일에 다음 JSON을 추가하여 모듈의 deviceToCloudUploadProperties 및 deviceAutoDeleteProperties를 구성합니다. 적절한 값을 사용하여 각 속성을 구성하고 파일을 저장합니다. IoT Edge 시뮬레이터를 사용하는 경우 deviceToCloudUploadProperties 및 deviceAutoDeleteProperties 설명 섹션에 나와 있는 해당 속성에 대한 관련 환경 변수로 값을 설정합니다.

"<your azureblobstorageoniotedge module name>":{
  "properties.desired": {
    "deviceAutoDeleteProperties": {
      "deleteOn": <true, false>,
      "deleteAfterMinutes": <timeToLiveInMinutes>,
      "retainWhileUploading": <true, false>
    },
    "deviceToCloudUploadProperties": {
      "uploadOn": <true, false>,
      "uploadOrder": "<NewestFirst, OldestFirst>",
      "cloudStorageConnectionString": "DefaultEndpointsProtocol=https;AccountName=<your Azure Storage Account Name>;AccountKey=<your Azure Storage Account Key>;EndpointSuffix=<your end point suffix>",
      "storageContainersForUpload": {
        "<source container name1>": {
          "target": "<target container name1>"
        }
      },
      "deleteAfterUpload": <true, false>
    }
  }
}

Visual Studio Code에서 azureblobstorageoniotedge에 대해 원하는 속성을 설정하는 방법을 보여 주는 스크린샷.

모듈이 배포된 후 deviceToCloudUploadProperties 및 deviceAutoDeleteProperties를 구성하는 방법에 대한 자세한 내용은 모듈 쌍 편집을 참조하세요. 컨테이너 생성 옵션, 다시 시작 정책 및 원하는 상태에 대한 자세한 내용은 EdgeAgent desired 속성을 참조하세요.

deployment.template.json 파일을 저장합니다.
deployment.template.json을 마우스 오른쪽 단추로 클릭하고 IoT Edge 배포 매니페스트 생성을 선택합니다.
Visual Studio Code는 deployment.template.json에 제공된 정보를 사용하여 새로운 배포 매니페스트 파일을 만듭니다. 솔루션 작업 영역의 새 config 폴더에 배포 매니페스트가 만들어집니다. 이 파일이 생겼으면 Visual Studio Code에서 Azure IoT Edge 모듈 배포 또는 Azure CLI 2.0을 사용하여 Azure IoT Edge 모듈 배포의 단계를 수행할 수 있습니다.

여러 모듈 인스턴스 배포

IoT Edge 모듈에 Azure Blob Storage의 여러 인스턴스를 배포하려는 경우 다른 스토리지 경로를 제공하고 모듈이 바인딩되는 HostPort 값을 변경해야 합니다. Blob Storage 모듈은 항상 컨테이너에서 11002 포트를 공개하지만, 호스트에서 모듈이 바인딩될 포트를 선언할 수도 있습니다.

컨테이너 만들기 옵션(Azure Portal) 또는 createOptions 필드(Visual Studio Code의 deployment.template.json 파일)을 편집하여 HostPort 값을 변경합니다.

"PortBindings":{
  "11002/tcp": [{"HostPort":"<port number>"}]
}

추가 Blob Storage 모듈에 연결할 때 업데이트된 호스트 포트를 가리키도록 엔드포인트를 변경합니다.

프록시 지원 구성

조직에서 프록시 서버를 사용하는 경우 edgeAgent 및 edgeHub 런타임 모듈에 프록시 지원을 구성해야 합니다. 이 프로세스에는 다음 두 작업이 포함됩니다.

디바이스에서 런타임 디먼 및 IoT Edge 에이전트를 구성합니다.
배포 매니페스트 JSON 파일의 모듈에 대한 HTTPS_PROXY 환경 변수를 설정합니다.

이 프로세스는 프록시 서버를 통해 통신하도록 IoT Edge 디바이스 구성에 나와 있습니다.

또한 Blob Storage 모듈에는 매니페스트 배포 파일의 HTTPS_PROXY 설정도 필요합니다. 배포 매니페스트 파일을 직접 편집하거나 Azure Portal을 사용할 수 있습니다.

Azure Portal에서 IoT Hub로 이동하고 디바이스 관리 메뉴에서 디바이스를 선택합니다.
구성할 모듈이 있는 디바이스를 선택합니다.
모듈 설정을 선택합니다.
페이지의 IoT Edge 모듈 섹션에서 Blob Storage 모듈을 선택합니다.
IoT Edge 모듈 업데이트 페이지에서 환경 변수 탭을 선택합니다.
이름에 HTTPS_PROXY를, 값에 프록시 URL을 추가합니다.
업데이트를 선택한 다음, 검토 + 만들기를 선택합니다.
배포 매니페스트의 모듈에 프록시가 추가되었는지 확인하고 만들기를 선택합니다.
디바이스 세부 정보 페이지에서 모듈을 선택하고 IoT Edge 모듈 세부 정보 페이지 하단의 환경 변수 탭을 선택하여 설정을 확인합니다.

다음 단계

IoT Edge 기반 Azure Blob Storage에 대해 자세히 알아보세요.

배포 매니페스트의 작동 방식 및 생성 방법에 대한 자세한 내용은 IoT Edge 모듈을 사용, 구성 및 다시 사용하는 방법에 대한 이해를 참조하세요.

다음을 통해 공유