image-package
Important
Azure Sphere(레거시) 설명서입니다. Azure Sphere(레거시)는 2027년 9월 27일에 사용 중지되며 사용자는 이 시간까지 Azure Sphere(통합)로 마이그레이션해야 합니다. TOC 위에 있는 버전 선택기를 사용하여 Azure Sphere(통합) 설명서를 볼 수 있습니다.
디스크의 Azure Sphere 이미지를 관리합니다.
| 연산 | 설명 |
|---|---|
| pack-application | 이미지 패키지를 만듭니다. |
| pack-board-config | 보드 구성 이미지 패키지를 만듭니다. |
| show | 이미지 패키지에 대한 세부 정보를 표시합니다. |
pack-application
컴파일되고 연결된 이미지 및 app_manifest.json 파일에서 실행 파일 애플리케이션을 만듭니다.
RTApps(실시간 지원 애플리케이션)는 원시 이진 파일이 아닌 ELF 또는 AXF 파일로 빌드됩니다. RTApp을 패키징하기 전에 ApplicationType이 "RealTimeCapable"로 설정되고 EntryPoint가 애플리케이션 디렉터리의 루트에 있어야 하는 ELF 또는 AXF 파일의 이름으로 설정되도록 애플리케이션 매니페스트 파일을 편집합니다.
팁
이 명령은 Visual Studio Code 또는 Visual Studio를 사용하여 고급 애플리케이션 또는 실시간 지원 애플리케이션 을 빌드할 때 실행됩니다.
- 빌드 프로세스는 매개 변수에 지정된
--package-directory입력 디렉터리인 approot<앱 이름> 디렉터리를 만듭니다. - 애플리케이션 매니페스트 파일은 매개 변수에
--application-manifest제공됩니다. - 상위 수준 애플리케이션의 경우 애플리케이션 런타임 버전이 매개 변수에
--target-api-set제공됩니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --목적지 | 이미지 패키지 경로 | 출력 이미지 패키지의 경로 및 파일 이름을 지정합니다. |
| --package-directory | approot_folder 경로 | Azure Sphere 이미지 파일의 시스템 루트로 사용되는 입력 디렉터리를 식별합니다. 애플리케이션에 대한 app_manifest.json 파일은 이 디렉터리에 있어야 합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -a, --application-manifest | 문자열 | 애플리케이션 매니페스트 파일의 경로를 지정합니다. JSON 파일 또는 app_manifest.json 포함하는 디렉터리일 수 있습니다. 상대 경로 또는 절대 경로를 제공할 수 있습니다. |
| --hardware-definitions | 문자열 | JSON(하드웨어 정의) 파일이 포함된 디렉터리에 대한 선택적 공간 구분 경로 목록을 지정합니다. 파일의 값은 app_manifest.json 주변 장치 이름을 기본 값에 매핑하는 데 사용됩니다. 상대 또는 절대 경로를 제공할 수 있습니다. 자세한 내용은 하드웨어 정의를 참조하세요. |
| --target-api-set | 문자열 | 컴파일 중에 사용되는 대상 API 집합의 이름을 지정합니다. 앱 매니페스트에 지정되지 않은 경우 상위 수준 앱에 필요합니다. RTApps에는 필요하지 않습니다. |
| --target-definition-filename | 문자열 | app_manifest.json 주변 장치 이름을 매핑하는 데 사용되는 하드웨어 대상 정의 파일의 이름을 지정합니다. 애플리케이션에서 하드웨어 정의를 사용하는 경우 제공해야 합니다. |
| -x, --executables | executable1,executable2 ... | 이미지 패키지에서 실행 파일로 표시할 하나 이상의 파일에 대한 경로를 지정합니다. app_manifest 파일에 나열된 EntryPoint는 항상 실행 파일로 표시되므로 다른 실행 파일이 있는 경우에만 -x 플래그가 필요합니다. 기본적으로 파일은 이미지로 패키지될 때 실행될 수 없습니다. 하위 경로는 실행 파일의 경로를 기준으로 합니다. 경로는 Windows 파일 이름 구문(backslashes) 또는 Linux 파일 이름 구문(슬래시)을 사용할 수 있습니다. 공백, 쉼표 및 세미콜론은 허용되지 않습니다. 각 실행 파일에 대해 -x를 지정하거나 한 번만 사용하고 공백을 개입하지 않고 쉼표로 구분된 여러 경로를 제공할 수 있습니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --debug | 로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 --debug 플래그를 사용해서 생성된 출력을 제공하십시오. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 출력됩니다.table 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조 하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제는 JMESPath 자습서 및 Azure CLI 쿼리 명령 출력을 참조하세요. |
| --verbose | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 --debug를 사용합니다. |
참고 항목
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.
예시
azsphere image-package pack-application --package-directory C:\AppSamples\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\approotHelloWorld_HighLevelApp --destination myimage.imagepackage
pack-board-config
보드 구성 이미지 패키지를 만듭니다. 미리 설정된 보드 구성 이미지를 사용하거나 사용자 지정 구성 이미지를 제공할 수 있습니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --목적지 | 문자열 | 결과 이미지 패키지의 출력 파일 이름 경로를 지정합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --board-config-file | Path | 보드 구성 이미지의 경로를 식별합니다. 이 매개 변수가 포함된 --preset 경우 사용하지 않아야 합니다. 두 매개 변수는 함께 사용할 수 없습니다. |
| -n, --name | 문자열 | 만든 파일의 메타데이터에 이미지 패키지 이름을 설정합니다. 제공되지 않으면 제공된 보드 구성에 따라 새 이름이 생성되고 고유성을 위해 구성 요소 ID의 일부가 통합됩니다. |
| -p, --preset | 문자열 | 적용할 미리 설정된 보드 구성 이미지의 ID를 제공합니다. 미리 설정된 패키지의 ID를 입력하거나 사용자 지정 보드 구성 이미지에 대한 매개 변수를 사용하여 보드 구성 파일의 --board-config-file 경로를 제공합니다. ID는 열거형 값이며 현재 단일 값으로 고정되어 있습니다 lan-enc28j60-isu0-int5. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --debug | 로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 --debug 플래그를 사용해서 생성된 출력을 제공하십시오. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 출력됩니다.table 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조 하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제는 JMESPath 자습서 및 Azure CLI 쿼리 명령 출력을 참조하세요. |
| --verbose | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 --debug를 사용합니다. |
참고 항목
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.
예시
azsphere image-package pack-board-config --preset lan-enc28j60-isu0-int5 --destination board2.imagepackage
show
이미지 패키지에 대한 정보를 표시합니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -f, --image-package | 문자열 | 이미지 패키지에 대한 경로를 지정합니다. 상대 또는 절대 경로를 제공할 수 있습니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --debug | 로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 --debug 플래그를 사용해서 생성된 출력을 제공하십시오. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 출력됩니다.table 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조 하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제는 JMESPath 자습서 및 Azure CLI 쿼리 명령 출력을 참조하세요. |
| --verbose | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 --debug를 사용합니다. |
참고 항목
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.
예제
azsphere image-package show --image-package C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage
Image package metadata:
Section: Identity
Image Type: Application
Component ID: 99d419ef-296d-43b0-ade1-809efe3a7aba
Image ID: d788fdd1-28eb-4477-9818-a4734289f2f1
Section: Signature
Signing Type: ECDsa256
Cert: a8d5cc6958f48710140d7a26160fc1cfc31f5df0
Section: Debug
Image Name: QuickStart-AzureSphereBlink1
Built On (UTC): 09/07/2020 13:18:52
Built On (Local): 09/07/2020 14:18:52
Section: Temporary Image
Remove image at boot: False
Under development: True
Section: ABI Depends
Depends on: ApplicationRuntime, version 5