클래식 CLI에서 Azure Sphere CLI로 마이그레이션
Important
Azure Sphere(레거시) 설명서입니다. Azure Sphere(레거시)는 2027년 9월 27일에 사용 중지되며 사용자는 이 시간까지 Azure Sphere(통합)로 마이그레이션해야 합니다. TOC 위에 있는 버전 선택기를 사용하여 Azure Sphere(통합) 설명서를 볼 수 있습니다.
Azure Sphere 클래식 CLI를 계속 사용하는 경우 새 Azure Sphere CLI로 마이그레이션하는 것이 좋습니다. 현재 두 버전의 CLI를 함께 설치하고 사용할 수 있지만, 클래식 CLI는 더 이상 업데이트되거나 유지 관리되지 않으며 나중에 SDK에서 제거됩니다(2022년 말 이후). 이러한 차이점을 숙지하고 2022년 말 이전에 프로세스와 스크립트를 마이그레이션하여 중단을 방지하는 것이 좋습니다.
최신 SDK로 업데이트하려면 Linux 에 Azure Sphere SDK 설치 또는 Windows 용 Azure Sphere SDK 설치를 참조하세요.
Windows에서 Azure Sphere CLI를 사용하려면 PowerShell 또는 표준 Windows 명령 프롬프트를 사용합니다. Linux의 경우 명령 셸을 사용하세요. 자세한 내용은 Azure Sphere CLI 실행을 참조하세요.
Windows의 경우 사용 중지된 사용자 지정 Azure Sphere 클래식 개발자 명령 프롬프트(Azure Sphere의 시작 메뉴에서 바로 가기 사용 가능)는 Azure Sphere 클래식 CLI에서만 사용할 수 있습니다. 자세한 내용은 Azure Sphere 클래식 CLI 실행을 참조하세요.
주요 차이점
Azure Sphere 클래식 CLI에서는 여러 매개 변수를 사용하여 각 개체 형식을 식별할 수 있습니다. Azure Sphere CLI에서 단일 매개 변수를 사용하여 각 개체 형식을 식별합니다. 즉, 이름 또는 ID를 사용하여 매개 변수 값을 지정할 수 있습니다. 이는 ,
--tenant,--product및--device-group매개 변수에--device대해 구현되었습니다.Object type Azure Sphere CLI Azure Sphere 클래식 CLI(사용 중지) 디바이스 --device--deviceid,--deviceip또는--devicelocation디바이스 그룹 --device-group--devicegroupid또는--devicegroupnameProduct --product--productid또는--productname테넌트 --tenant--tenantid명령에 대한 짧은 형식은 클래식 버전에서 지원됩니다. Azure Sphere CLI에서는 탭 완성 또는 대화형 기능을 사용하여 사용 가능한 명령 목록을 보는 것이 좋습니다. 예를 들어 클래식 CLI에서는 명령을
azsphere device enable-developmentazsphere dev edv사용할 수 있지만 새 Azure Sphere CLI에서는 자동 완성을 사용하여 명령을 빠르게 입력azsphere device enable-development할 수 있습니다.일부 명령은 단일 매개 변수에 대해 여러 값을 허용합니다. Azure Sphere CLI에서는 단일 매개 변수와 공백으로 구분된 값 목록을 제공할 수 있으며 Azure Sphere 클래식 CLI에서는 값 목록이 쉼표로 구분됩니다. 예시:
azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2새 CLI에서는 테넌트를 만들 때 기본 테넌트가 자동으로 선택되지 않습니다. azsphere tenant select 명령을 실행하여 PC의 현재 사용자에 사용할 기본 테넌트를 선택해야 합니다. 이는 디바이스 클레임과 같이 실행 취소할 수 없는 일회성 작업을 수행할 때 기본 테넌트가 올바른 테넌트인지 확인하기 위한 것입니다.
스크립트를 사용하는 경우 매개 변수를 사용하여 기본 테넌트 선택
--tenant <tenant ID or tenant name>다음을 사용하여 스크립트 시작 시 기본 테넌트 설정:
azsphere tenant select --tenant <tenant ID or tenant name>명령을 실행할 때 기본 테넌트를 덮어쓰거나 필요한 테넌트를 지정할 수도 있습니다. 예시:
azsphere get-support-data --destination logs.zip --tenant <tenant ID or tenant name>-
매개 변수는
--device-group디바이스 그룹을 식별합니다. 디바이스 그룹 ID는 모든 제품에서 디바이스 그룹을 고유하게 식별하는 GUID를 제공합니다. 또는 제품 이름/<device-group-name 형식으로 <제품 이름> 및 디바이스 그룹 이름> 쌍을 사용할 수 있습니다. 이 이름 쌍은 특정 제품에 대한 디바이스 그룹을 고유하게 식별합니다. 다음 명령은 클래식 CLI의 복합 명령이었습니다. 즉, 한 명령이 여러 작업을 수행했습니다. 새 CLI에서 두 명령을 실행해야 합니다.
클래식 CLI 에서 azsphere device-group deployment create 명령은 이미지 패키지를 업로드하고 새 배포를 만들었습니다.
새 CLI에서 다음을 수행해야 합니다.
- azsphere image add를 사용하여 Azure Sphere 테넌트에 이미지 패키지를 업로드합니다.
- azsphere device-group deployment create를 사용하여 업로드된 이미지에 대한 디바이스 그룹에 대한 새 배포를 만듭니다.
클래식 CLI 에서 azsphere device capability download --select command downloaded and temporarily selected device capability configuration for the attached device.
새 CLI에서 다음을 수행해야 합니다.
- azsphere 디바이스 기능 다운로드를 사용하여 기능 파일을 다운로드합니다.
- azsphere device capability select를 사용하여 기능을 선택합니다.
클래식 CLI 에서 azsphere 디바이스 기능 다운로드 -- 다운로드한 명령을 적용 하고 연결된 디바이스에 대한 디바이스 기능 구성을 적용합니다.
새 CLI에서 다음을 수행해야 합니다.
- azsphere 디바이스 기능 다운로드를 사용하여 기능 파일을 다운로드합니다.
- azsphere 디바이스 기능 업데이트를 사용하여 기능을 적용합니다.
클래식 CLI
-o에서 또는--output매개 변수는 파일을 저장할 경로 및 파일 이름을 지정하는 데 사용됩니다. 새 Azure Sphere CLI에서는 입력 및 출력 경로를 지정하는 것과 같은--destination컨텍스트별 매개 변수가 사용됩니다.클래식 CLI
-d에서 azsphere device app start 명령에서 또는--debug매개 변수를 사용하여 디버그 모드에서 애플리케이션을 시작합니다. 새 Azure Sphere CLI--debug-mode에서 매개 변수는 디버그 모드에서 애플리케이션을 시작하는 데 사용되며--debug, 매개 변수는 모든 디버그 로그를 표시하기 위해 로깅 세부 정보를 높이기 위해 전역 매개 변수로 사용됩니다.클래식 CLI에서는 출력 형식을 제어할 수 없습니다. Azure Sphere CLI
-o에서 매개 변수는--outputCLI 출력의 형식을 지정할 출력 형식을 지정하는 데 사용됩니다.릴리스 21.02부터 명시적 버전 번호가 Azure Sphere CLI 제품 이름에서 제거되었습니다. 이 변경은 제품의 다른 버전을 참조하는 혼동을 제거합니다.
- 이제 Azure Sphere CLI v2 이상을 "Azure Sphere CLI"라고 합니다.
- 이전 Azure Sphere CLI 버전(CLI v1 이하)을 이제 "Azure Sphere 클래식 CLI"라고 합니다.
스크립트를 사용하는 경우 위에서 설명한 차이점으로 인해 새 Azure Sphere CLI와 호환되지 않을 수 있습니다. 스크립트가 새 CLI에서 올바르게 실행되도록 필수 업데이트를 만듭니다.