다음을 통해 공유

배포 만들기

  • 아티클

Important

Azure Sphere(레거시) 설명서입니다. Azure Sphere(레거시)는 2027년 9월 27일에 사용 중지되며 사용자는 이 시간까지 Azure Sphere(통합)로 마이그레이션해야 합니다. TOC 위에 있는 버전 선택기를 사용하여 Azure Sphere(통합) 설명서를 볼 수 있습니다.

클라우드에서 애플리케이션을 배포하려면 Azure Sphere 테넌트에 애플리케이션 이미지를 업로드하고 Azure Sphere 디바이스에 이미지를 배포하는 배포를 만듭니다. 배포를 만들려면 Azure Sphere에 로그인해야 하며 관리자 역할이 있어야 합니다. 또한 디바이스는 클라우드 배포를 받을 준비가 되어 있어야 합니다.

참고 항목

배포의 각 구성 요소에는 고유한 GUID가 있어야 합니다. Azure Sphere 샘플에서 애플리케이션을 기반으로 하는 경우 배포를 만들기 전에 애플리케이션에 대한 고유한 GUID를 만들어 충돌을 방지해야 합니다.

디바이스 준비

디바이스가 클라우드에서 애플리케이션을 수신하려면 먼저 제품이 있어야 하고 디바이스 그룹에 속해야 하며 AppDevelopment 기능을 설치할 수 없습니다.

디바이스용 제품을 아직 만들지 않은 경우 배포를 만들려면 이 작업을 수행해야 합니다. 제품을 만들려면 다음을 수행합니다.

azsphere product create --name <product-name>

제품 이름을> DW100과 같은 제품 이름으로 대체<합니다. 이 명령에 대한 자세한 내용은 azsphere product를 참조하세요.

배포는 디바이스 그룹을 대상으로 하므로, 디바이스가 배포된 애플리케이션을 수신할 수 있도록 하려면 클라우드 업데이트를 사용하는 디바이스 그룹에 디바이스를 할당해야 합니다. 기본적으로 각 제품에는 프로덕션, 필드 테스트, 개발, 필드 테스트 OS 평가 및 프로덕션 OS 평가의 5개 디바이스 그룹이 있습니다. 이러한 디바이스 그룹 중 하나를 사용하거나 직접 만들 수 있습니다. 디바이스 그룹이 클라우드 업데이트를 허용하는지 여부를 확인하려면 azsphere device-group show를 사용합니다.

또한 디바이스는 클라우드 로드에 대비해야 합니다. 즉, appDevelopment 기능이 없습니다. 공장에서 배송되는 디바이스에는 이 기능이 없습니다. 그러나 애플리케이션 개발에 디바이스를 사용했다면 아마 azsphere device enable-development 명령을 사용하여 이 기능이 추가되었을 것입니다(SDK의 이전 미리 보기 릴리스에서는 azsphere device prep-debug라고도 함).

기능을 제거하려면 azsphere device enable-cloud-test를 사용합니다.

azsphere device enable-cloud-test --device-group <device-group-ID> or '<product-name>/<device-group-name>'

매개 변수는 --device-group 디바이스 그룹을 식별합니다. 디바이스 그룹 ID는 모든 제품에서 디바이스 그룹을 고유하게 식별하는 GUID를 제공합니다. 또는 제품 이름/<device-group-name 형식으로 <제품 이름> 및 디바이스 그룹 이름> 쌍을 사용할 수 있습니다. 이 이름 쌍은 특정 제품에 대한 디바이스 그룹을 고유하게 식별합니다. 자세한 내용은 배포 만들기를 참조 하세요.

디바이스 그룹에 대한 배포 만들기

배포는 애플리케이션과 보드 구성을 모두 포함할 수 있으며 배포를 만들 때 둘 다 동일한 방식으로 처리됩니다. 배포는 디바이스 그룹 내의 모든 디바이스에 배포할 이미지 세트입니다. 각 배포는 특정 제품 내의 특정 디바이스 그룹에 연결됩니다. 배포를 만들 때 제품 이름 및 디바이스 그룹 이름(다음 예제와 같이) 또는 디바이스 그룹 ID를 포함해야 합니다.

배포를 만들려면 다음을 수행합니다.

  1. 이미지 패키지를 업로드합니다.

    azsphere image add --image <path-to-image>  --regional-data-boundary <value>

  2. 디바이스 그룹에 대한 새 배포를 만듭니다.

    azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>

    또는

    azsphere device-group deployment create '<product-name>/<device-group-name>' --images <image-ID>

여러 값을 --images 제공하려면 공백으로 구분된 값 목록을 입력합니다.

매개 변수는 --device-group 디바이스 그룹을 식별합니다. 디바이스 그룹 ID는 모든 제품에서 디바이스 그룹을 고유하게 식별하는 GUID를 제공합니다. 또는 제품 이름/<device-group-name 형식으로 <제품 이름> 및 디바이스 그룹 이름> 쌍을 사용할 수 있습니다. 이 이름 쌍은 특정 제품에 대한 디바이스 그룹을 고유하게 식별합니다.

매개 변수는 --images 애플리케이션에 대한 이미지 패키지 파일의 이미지 ID를 제공합니다. 이미지가 현재 테넌트에 업로드됩니다.

매개 변수는 --regional-data-boundary 이 이미지의 지역 데이터 경계를 지정합니다. 허용되는 값은 EU와 None입니다. 기본값은 None입니다. 값을 지정하지 않으면 기본값이 사용됩니다.

예시:

azsphere image add --image my-app.imagepackage --regional-data-boundary "None"

azsphere device-group deployment create --device-group "DW100/Field Test" --images e3769536-dc4b-48d9-afd4-22ed321ba4bc

유효한 배포에 대한 규칙

유효하려면 배포가 다음 규칙을 따라야 합니다.

  • 배포의 총 크기는 1MiB 미만이어야 합니다.
  • 배포에는 둘 이상의 보드 구성 파일이 있을 수 있습니다.

배포 업데이트

배포를 업데이트하려면 이전 섹션에서 설명한 대로 azsphere image add 및 azsphere device-group deployment create 명령을 다시 사용하고 업데이트된 애플리케이션 파일의 경로를 지정합니다.