Azure IoT Operations 배포를 최신 버전으로 업그레이드하는 방법을 알아봅니다.
필수 구성 요소
- 활성 구독이 있는 Azure 계정. 계정이 없는 경우 체험 계정을 만들 수 있습니다.
- Azure CLI 버전 2.53.0 이상.
az --version
을 사용하여 버전을 확인하고 필요한 경우az upgrade
를 사용하여 업데이트합니다. 자세한 내용은 Azure CLI 시작을 참조하세요.
업그레이드 지원 이해
Azure IoT Operations 릴리스 버전은 미리 보기 버전 또는 GA(일반 공급)일 수 있으며, Azure IoT Operations 버전 문서에서 최신 버전을 찾을 수 있습니다. Azure IoT Operations CLI 확장 버전은 Azure IoT Operations 버전에 연결되어 있으므로 업그레이드를 수행하기 위해 올바른 CLI 확장 버전이 설치되어 있는지 확인해야 합니다.
Azure IoT Operations는 다음과 같은 업그레이드 시나리오를 지원합니다.
- 기존 Azure IoT 작업 인스턴스를 동일한 부 버전의 패치 또는 다음 부 버전으로 업그레이드할 수 있습니다.
- 버전 간에는 다운그레이드할 수 없습니다. 이전 버전으로 이동하려면 Azure IoT 작업을 제거하고 원하는 버전을 다시 설치합니다.
- 미리 보기 버전에서 GA 버전으로 업그레이드할 수 없습니다. Azure IoT 작업을 제거하고 새 버전을 다시 설치해야 합니다.
- GA 버전에서 미리 보기 버전으로 업그레이드할 수 없습니다. 미리 보기 버전을 설치하는 방법에 대한 자세한 내용은 미리 보기 버전으로 업그레이드를 참조하세요.
비고
Azure IoT Operations는 실시간 업그레이드를 지원하지 않습니다. 업그레이드 프로세스 중에 약간의 가동 중지 시간이 발생합니다.
업그레이드
Azure IoT 작업은 새로운 GA 버전이 릴리스됨에 따라 인스턴스를 업그레이드하는 것을 지원합니다. Azure IoT Operations 인스턴스가 업그레이드에 적합한 경우 Azure Portal 또는 Azure CLI를 사용하여 업그레이드를 수행할 수 있습니다.
최신 버전의 Azure IoT Operations가 미리 보기 상태인 경우 미리 보기 버전으로 업그레이드를 참조하세요.
Azure IoT 작업 배포가 업그레이드 대상인 경우 Azure Portal에 업그레이드 옵션이 표시됩니다. 업그레이드 옵션이 보이지 않으면 배포 버전이 최신 상태입니다.
Azure Portal에서 Azure IoT 작업 인스턴스로 이동합니다.
인스턴스의 개요 페이지에서 업그레이드를 선택합니다.
Azure IoT 작업의 최신 버전을 가져오려면 Azure IoT 작업 CLI 확장의 최신 버전을 사용해야 합니다. 필수 구성 요소의 일부로 확장을 업데이트하지 않은 경우 지금 업데이트합니다.
az extension add --upgrade --name azure-iot-ops
또는 배포를 최신 버전이 아닌 최신 버전으로 업그레이드하려는 경우 CLI 확장 버전을 IoT Operations 버전에서 원하는 Azure IoT 작업 버전과 연결된 버전으로 설정합니다.
az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>
포털은 구독, 리소스 그룹 및 인스턴스 세부 정보가 미리 입력된 인스턴스를 업그레이드하기 위한 Azure CLI 명령을 제공합니다. CLI 명령 옆에 있는 복사 아이콘을 선택합니다.
복사된
az iot ops upgrade
명령을 실행합니다.업그레이드 명령이 성공적으로 완료되면 인스턴스를 새로 고쳐 변경 내용을 확인합니다.
인스턴스 개요 페이지에 표시되는 버전 값은 Azure IoT 작업 인스턴스의 버전을 반영합니다. 그러나 필요한 Arc 확장에 사용 가능한 업그레이드가 있는 경우 업그레이드하라는 메시지가 표시될 수 있습니다. 인스턴스 개요 페이지에서 업그레이드 옵션이 사라지면 아무 것도 변경된 것처럼 보이지 않더라도 업그레이드가 성공한 것으로 볼 수 있습니다. Azure Portal의 Arc 지원 클러스터의 확장 페이지에서 Azure IoT Operation 배포에 대한 Arc 확장 버전을 확인할 수 있습니다.
미리 보기 버전으로 업그레이드
Azure IoT Operations의 최신 버전이 미리 보기로 표시되는 경우도 있습니다. Azure IoT Operations 버전을 확인하여 최신 버전을 확인합니다. 미리 보기 릴리스 중에 버전 업그레이드가 차단되며 Azure IoT 작업을 제거하고 미리 보기 버전을 다시 설치해야 합니다.
Azure CLI를 사용하여 미리 보기 버전만 설치할 수 있습니다.
기존 Azure IoT Operations 인스턴스가 있는 경우 새 배포를 수행하려면 Azure IoT Operations를 제거 해야 합니다.
--allow-preview
플래그를 사용하여 최신 버전의 Azure IoT Operations CLI 확장을 추가합니다.az extension add --upgrade --name azure-iot-ops --allow-preview
최신 버전이 아닌 특정 버전의 Azure IoT Operations로 업그레이드하려면 az iot ops get-versions
실행 하거나 참조하여 원하는 Azure IoT Operations 버전과 연결된 CLI 확장 버전을 찾을 수 있습니다. 버전 번호를 가져와서 다음 명령을 실행하여 해당 버전으로 업그레이드합니다.
az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>
MQTT 브로커 업그레이드 고려 사항
배포 업그레이드 중에 데이터 손실이 없고 가용성이 높다는 것을 보장하기 위해 MQTT 브로커는 MQTT 브로커 Pod 전체에 롤링 업데이트를 구현합니다. 상태 관리자 Pod는 MQTT 브로커 Pod에 대한 증분 업그레이드 프로세스를 조정하여 다음을 보장합니다.
- 활성 클라이언트 연결은 중단 없이 유지됩니다.
- 모든 전송 중인 메시지는 유지됩니다.
- 디스크에 저장된 데이터는 버전 간에 올바르게 마이그레이션됩니다.
업그레이드 프로세스 중에 오류가 발생하면 상태 관리자 Pod는 자동으로 업그레이드 프로세스를 다시 시작하면서 데이터 또는 연결이 손실되지 않도록 합니다.
롤링 업데이트는 MQTT 브로커가 둘 이상의 백 엔드 복제본과 함께 배포된 경우에만 발생할 수 있습니다. MQTT broker 업그레이드는 단일 복제본 배포에 지원되지 않습니다. Azure IoT Operations를 배포할 때 az iot ops create 명령에 --broker-backend-rf
매개 변수를 사용하여 만들 백 엔드 복제본 수를 지정합니다.
지원되는 버전
Microsoft는 언제나 최신 버전 및 이전의 두 가지 부 버전으로 구성된 세 가지 일반 공급(GA) 버전의 Azure IoT Operations를 동시에 지원합니다.
현재는 두 가지 부 버전만 사용할 수 있습니다. Azure 지원 은 현재 다음 버전에 사용할 수 있습니다.
중요합니다
이전 부 버전은 보안 패치를 받지 않습니다. 항상 최신 버전으로 업그레이드하여 최신 보안 업데이트 및 기능이 있는지 확인합니다.
현재 버전을 확인하려면 Azure Portal에서 Azure IoT Operations 인스턴스에 대한 개요 페이지를 참조하거나 Azure IoT Operations CLI az iot ops instance show 명령을 사용합니다.