다음을 통해 공유

클라우드 및 배포 문제 해결

  • 아티클

Important

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

클라우드 및 배포와 관련된 잠재적인 문제의 두 가지 주요 유형은 클라우드 종속 azsphere 명령과 상호 작용하는 문제 및 업데이트되지 않는 디바이스의 문제입니다.

클라우드 CLI 명령 문제 해결

클라우드 종속 azsphere 명령을 사용하는 경우 Azure Sphere Security Service는 CLI(명령줄 인터페이스)를 대신하여 작업을 수행합니다. 개별 테넌트, 사용자 또는 디바이스에 대한 정보를 노출하여 정보 유출의 위험을 방지하기 위해 보안 서비스는 경우에 따라 azsphere 명령이 사용자에게 전달하는 일반적인 오류 메시지를 반환합니다.

이러한 오류를 진단하고 해결하기 위한 몇 가지 일반적인 문제 해결 팁은 다음과 같습니다.

Windows, 특히 개인 Microsoft 계정에서 간헐적인 로그인 오류가 발생하는 경우 로그인 시 옵션을 사용하고 --use-device-code 프롬프트의 지침을 따르세요.

azsphere login --use-device-code

이 옵션은 Windows SDK 버전 20.04 업데이트 2 이상에서 지원됩니다.

클라우드 종속 명령이 실패하는 경우 먼저 명령 자체를 확인합니다.

  • 올바른 매개 변수를 지정했나요?
  • 명령에 디바이스, 디바이스 그룹 또는 기타 항목에 대한 ID가 포함된 경우 올바른 ID라고 확신합니까?
  • 이미 존재하는 디바이스 그룹, 제품 또는 기타 항목을 만들려고 합니까? 제품 이름은 테넌트 내에서 고유해야 합니다. 디바이스 그룹 이름은 제품 내에서 고유해야 하며 대/소문자를 구분하지 않습니다.

다음으로 로그인 ID 및 테넌트 확인:

  • Azure Sphere에 로그인하는 데 사용된 로그인 ID가 유효한가요?
  • 올바른 테넌트에 액세스하고 있나요?
  • 로그인 ID를 변경했나요? 각 ID는 Azure Sphere에 등록되어야 하며 테넌트 내에서 할당된 역할이 있어야 합니다. 예를 들어 전자 메일 주소를 변경하여 로그인을 변경하는 경우 새 ID를 등록할 뿐만 아니라 새 ID에 역할이 할당되었는지도 확인해야 합니다.

디바이스를 확인합니다.

  • 일부 명령은 디바이스가 컴퓨터에 연결되어 있어야 합니다.

마지막으로 테넌트에서 사용자 역할이 작업을 수행할 수 있는 권한을 부여해야 합니다.

  • 명령이 데이터를 기록하는 경우 기여자 또는 관리자여야 합니다. 읽기 권한자는 데이터를 쓸 수 없으므로, 테넌트, 디바이스 그룹 또는 제품을 만들거나 디바이스 기능을 추가 또는 삭제하거나, 이미지 패키지를 업로드하거나, 기타 테넌트 또는 디바이스에 저장된 정보를 변경하는 다른 작업을 수행할 수 없습니다.

사용자 등록 오류

azsphere register-user 명령을 사용하려는 경우 이 명령이 더 이상 사용되지 않으므로 오류 메시지가 표시됩니다. 사용자를 등록하려면 대체 메커니즘을 사용해야 합니다.

디바이스 업데이트 문제 해결

무선 업데이트는 Azure Sphere 보안 모델의 중요한 부분입니다. OS 업데이트와 배포 업데이트 모두에서 문제가 발생할 수 있습니다.

OS 업데이트 문제 해결

디바이스가 OS 업데이트를 받으려면 디바이스를 인터넷에 연결해야 합니다. 디바이스가 오래된 버전의 Azure Sphere OS를 실행하는 것으로 표시되는 경우 네트워크 문제 해결에 설명된 대로 인터넷 연결을 확인합니다.

디바이스가 21.04 이전 OS를 실행하는 경우 디바이스에 로드된 모든 보드 구성 이미지 도 디바이스가 클레임되는 테넌트 클라우드 계정에 로드되어야 합니다.

디바이스에 보드 구성을 테스트용으로 로드하면 초기 이더넷 구성이 가능합니다. 그러나 21.01 이전 OS를 실행하는 디바이스의 경우 해당 보드 구성 이미지가 배포에 포함되지 않은 경우 디바이스에서 업데이트를 수행할 수 없습니다. 이 구성으로 인해 디바이스에서 보드 구성이 제거되고 인터넷 연결이 손실될 수 있기 때문입니다. 디바이스 중 하나에 발생한 경우 디바이스가 클레임되는 테넌트 클라우드 계정에 원래 보드 구성 이미지를 업로드해야 합니다.

배포 업데이트 문제 해결

디바이스에서 배포 업데이트를 받으려면 다음이 모두 true여야 합니다.

  • 인터넷에 연결되어 있어야 합니다. 디바이스가 인터넷에 연결되어 있지 않은 것으로 의심되는 경우 네트워크 문제 해결을 참조 하세요.
  • 애플리케이션 개발 기능이 없어야 합니다.
  • 테넌트에 클레임해야 합니다.
  • 디바이스 그룹에 속해야 합니다.
  • 속한 디바이스 그룹은 배포의 대상이 되어야 합니다.
  • 배포에는 조직에서 또는 조직을 대신하여 만든 애플리케이션 이미지(및 선택적으로 보드 구성 이미지)가 포함되어야 합니다.
  • 디바이스 그룹에 UpdateAll 업데이트 정책이 있어야 합니다.

Azure Sphere는 디바이스당 단일 테넌트를 지원합니다. 즉, 조직에서 디바이스에 배포된 모든 고객 이미지를 제어합니다.

애플리케이션 개발 기능을 제거하면 프로덕션 서명되지 않은 테스트용으로 로드된 이미지가 모두 제거됩니다.

디바이스를 클레임하는 문제

디바이스는 한 번만 클레임 할 수 있습니다. 클레임되면 디바이스는 Azure Sphere 테넌트에 영구적으로 연결됩니다. 테넌트에 디바이스를 클레임할 때 오류가 보고되면 다음 중 하나가 원인일 수 있습니다.