> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/making-changes/update-device-configuration.md).

# 장치 구성 업데이트

장치 설정, 서비스 버전, 추론 엔진, CA 인증서 및 추가 서비스를 관리합니다.

### 배포 구성하기

Deployment Manager의 Configuration 페이지에서 디바이스에서 실행 중인 서비스를 관리할 수 있습니다. 이 가이드에서는 주요 구성 옵션을 간략히 설명합니다. 수정 사항을 저장하려면 "구성 저장"을 클릭하고, 저장하지 않은 변경 사항을 버리려면 "재설정"을 클릭하세요.

디바이스 매니페스트를 [실행하는 디바이스는](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/device-manifests.md) 매니페스트에서 구성을 가져오므로 "구성" 및 "서비스" 탭이 표시되지 않습니다.

#### 디바이스 설정

디바이스 이름을 변경하거나 시간대를 업데이트할 수 있습니다. 디바이스 이름은 Deployment Manager 사용자 인터페이스에 표시하기 위한 용도로만 사용되며 어떤 통합도 중단하지 않습니다. 시간대는 디바이스의 시계를 설정하며, 로그, 이벤트 및 유지보수 시간대에 사용됩니다. 배포가 이루어지는 실제 위치로 설정하세요.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-5b850a8b6b8208f35daaf63f53ca2d546de5ee9a%2Fenterprise-device-settings.png?alt=media" alt="Device Settings panel with device name, timezone, and maintenance window"><figcaption></figcaption></figure>

#### 업데이트 / 성능 설정

각 서비스의 탭에서 서비스 버전을 구성할 수 있습니다. 서비스 카드나 탭에서 "업데이트"를 클릭하면 대상 버전, 예상 다운로드 용량 및 디스크 공간, 유지보수 일정을 확인할 수 있습니다. 업데이트에 필요한 공간이 디스크에 부족할 수 있으면 버튼에 "그래도 업데이트"가 표시됩니다. 확인하면 업데이트가 저장되거나 기존의 저장되지 않은 수정 사항에 추가됩니다. 새 버전을 다운로드하는 동안에는 현재 버전이 계속 실행됩니다. 디바이스 이름 옆의 칩에 진행 상황(예: "Inference 업데이트 중 · 42%") 또는 "업데이트 실패"가 표시되고, "활동" 탭에서 다운로드 실패 원인을 확인할 수 있습니다.

**버전 표시:**

* **"업데이트 가능"** - 새 버전이 있음
* **"업데이트 예약됨"** - 유지보수 시간대까지 업데이트 대기 중
* **"다운로드 중", "재시작 중" 또는 "업데이트 실패"** - 설치 진행 상황 또는 실패
* **"업데이트 보류 중"** - 실행 중인 버전과 구성된 버전이 다름. 이 상태가 지속되면 서비스 로그를 확인하세요.

서비스에 자체 이미지(예: 기본 HMI 대신 사용자 지정 HMI)를 사용하는 디바이스에서는 버전이 읽기 전용으로 표시됩니다. 버전 표시, "업데이트" 버튼 및 자동 업데이트는 적용되지 않습니다. 기본 버전은 다른 이미지를 기준으로 하기 때문입니다.

**자동 업데이트** - 서비스 카드에서 "자동 업데이트"를 켜거나 해당 탭에서 "자동 업데이트"를 켜면 Workspace의 기본 구성에 설정된 버전으로 서비스를 유지할 수 있습니다. PLC Relay, OPC UA Server 및 RTSP Simulator는 대신 Roboflow와 함께 제공된 버전을 사용합니다. 업데이트는 [유지보수 시간대](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/setting-up/setup-maintenance-windows.md)에 적용됩니다. "디바이스 설정"의 "최신 Roboflow Core"를 켜면 Inference와 Redis가 함께 자동 업데이트됩니다. 유지보수 시간대가 아닐 때 구성 변경 사항을 저장하면 배포에 영향을 주는 변경 사항은 다음 시간대까지 대기열에 추가됩니다.

여러 디바이스의 Inference 버전을 한 번에 설정하려면 디바이스 목록에서 해당 디바이스를 선택하고 "Inference 버전 설정"을 클릭하세요. 결과에는 각 디바이스의 상태가 저장됨, 대기열에 추가됨(유지보수 시간대까지 대기), 실패 또는 건너뜀으로 표시됩니다. 저장됨은 Roboflow가 버전을 기록했다는 뜻이지, 디바이스에 설치되었다는 뜻은 아닙니다. 각 디바이스의 다른 구성 수정 사항은 유지됩니다.

**Inference 엔진** - Inference 서비스에서 사용할 런타임을 제어합니다. 네 가지 모드 중 하나를 선택하세요:

* **Auto** (권장) - Inference Models 런타임과 모델별 기본 설정을 사용합니다.
* **ONNX** - 디바이스에서 사용할 수 있는 제공자를 사용해 ONNX Runtime을 실행합니다.
* **TRT** - TensorRT 실행 제공자를 사용해 ONNX Runtime을 실행하도록 강제합니다. 처음 실행할 때 모델을 컴파일하는 데 몇 분 정도 걸릴 수 있습니다. Offline Mode가 꺼져 있으면 TensorRT 엔진 캐싱이 활성화됩니다.
* **CPU** - CPU만 사용해 추론하도록 강제합니다. GPU 관련 문제를 디버깅할 때 유용합니다.

"성능"에서 "RTSP 스트림 캡처"를 사용해 Inference 서비스가 모든 RTSP 카메라에 연결하는 방식을 설정하세요. 자동 전송 방식을 사용하려면 "기본값", 손실이 발생하는 네트워크에서 더 안정적으로 캡처하려면 "TCP", 지연 시간을 줄이려면 "UDP", 또는 FFmpeg 옵션을 직접 지정하려면 "사용자 지정"을 선택하세요. 형식은 `key;value|key;value` 입니다. "TCP"를 사용할 때는 "프로브 크기"(바이트)와 "분석 시간"(마이크로초)을 조정하세요. 값이 클수록 스트림을 더 잘 감지하지만 시작이 지연됩니다.

**오프라인 모드** - 이 토글을 켜면 Inference 서비스가 Roboflow에 연결하지 않습니다. 그러면 디바이스는 로컬 캐시에 있는 Workflows와 모델만 실행하므로 게시된 Workflow 변경 사항과 새 모델 버전이 추론에 반영되지 않습니다. 변경 사항은 Inference 서비스가 다시 시작될 때 적용됩니다. 이 모드가 켜져 있으면 디바이스 목록과 디바이스 페이지에 "오프라인 모드" 칩이 표시되고, Workflow 게시 확인 화면에는 업데이트를 받지 못할 디바이스가 표시됩니다.

디바이스가 오프라인 사용을 위해 보관하는 Workflows를 확인하려면 디바이스의 "스트림" 탭을 열고 "Workflows"까지 스크롤하세요. 어떤 스트림에서도 사용하지 않는 Workflow를 디바이스에 보관하려면 "Workflow 추가"를 클릭하고 해당 Workflow를 선택한 다음 "저장"을 클릭하세요. 디바이스가 최신 게시 버전과 식별 가능한 모델을 다운로드해 고정을 해제할 때까지 보관합니다. 런타임에 선택하는 모델은 오프라인에서 사용하려면 미리 캐시에 저장되어 있어야 합니다.

연결을 끊기 전에 [디바이스를 오프라인 작동에 대비해 준비하세요](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/setting-up/prepare-a-device-for-offline-operation.md). 자세한 캐시, TensorRT, 재시작 및 복구 확인 방법은 [오프라인 모드 준비 절차](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/offline-mode.md#web-app) 를 따르세요.

**멀티프로세싱** - 이 토글을 켜면 각 스트림의 Workflow가 별도 프로세스에서 실행됩니다. 여러 Workflow를 동시에 실행할 때 처리량을 높일 수 있습니다. 각 프로세스가 자체 모델을 로드하므로 메모리 사용량이 늘어납니다. 새 디바이스에서는 기본적으로 켜져 있습니다. 이 토글을 사용하면 추론 컨테이너가 호스트의 IPC 네임스페이스를 공유합니다. 디바이스에 새 구성이 적용되면 이 설정 변경으로 Inference 서비스가 다시 시작됩니다.

#### Python 구성

Inference 서비스에서 사용자 지정 Python 코드를 실행하려면 Configuration 탭 하단의 "Python 구성"을 펼치고 다음을 수정하세요. `config.py`입니다. 해당 `setup()` 함수는 서비스가 시작될 때 한 번 실행되고, `on_prediction(predictions, frame)` 는 각 예측 후에 실행되며, `pipeline_parameters` 는 Inference Pipeline에 추가 설정을 전달합니다. Python 구문이 올바르지 않으면 저장할 수 없습니다. 변경 사항을 저장하면 추론 서비스가 다시 시작됩니다.

***

#### CA 인증서

기기의 "네트워킹" 탭에서 "CA 인증서"를 통해 신뢰할 수 있는 CA 인증서를 관리하세요. 사용자 지정 또는 내부 인증서를 사용하는 서비스(예: 기업 프록시 또는 비공개 레지스트리)와 통신할 때 유용합니다.

"인증서 추가"를 클릭하고 "인증서 이름"과 "PEM 콘텐츠"를 입력한 다음 "구성 저장"을 클릭하세요. 인증서를 삭제하려면 휴지통 아이콘을 클릭하세요. 인증서 이름에는 문자, 숫자, 마침표, 하이픈, 밑줄만 사용할 수 있으며 마침표로 시작할 수 없습니다. 기기는 호스트와 모든 서비스에 인증서를 설치하므로, 인증서 변경 사항을 저장하면 모든 서비스가 다시 시작됩니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-b52d9c82bc0b8ad590e170c7a10862d4df6ca318%2Fdevice-ca-certificates.png?alt=media" alt="CA Certificates section on the Networking tab with a certificate name, PEM content, and Add Certificate"><figcaption></figcaption></figure>

***

#### 추가 서비스

Roboflow에서는 사전 구성된 추가 서비스를 기기에 추가할 수도 있습니다. 각 서비스에는 자체 구성 옵션이 있으며, 추가를 시도하면 필요한 정보를 입력하라는 메시지가 표시됩니다.

* [이벤트 저장소](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/services/event-store.md) 기기에 추론 이벤트를 저장합니다.
* [OPC UA 서버](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/services/opc-ua-server.md) 데이터를 OPC UA 태그로 게시합니다.
* [PLC 릴레이](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/services/plc-relay.md) PLC 태그를 읽고 씁니다.
* [RTSP 시뮬레이터](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/services/rtsp-simulator.md) 테스트 카메라로 동영상 파일을 스트리밍합니다.
* 기본 HMI UI입니다.

서비스 카드 아래의 "서비스 추가"를 클릭해 서비스를 추가하세요. 서비스를 추가하면 구성이 즉시 저장됩니다. 서비스를 삭제하려면 해당 카드 헤더의 휴지통 아이콘을 클릭하세요. 삭제는 다른 구성 수정과 마찬가지로 보류 상태로 처리됩니다. "구성 저장"을 클릭하면 저장되며, 유지 관리 시간까지 미룰 수 있습니다. 그전에는 "재설정"으로 취소할 수 있습니다. 서비스를 삭제하면 해당 서비스를 사용하는 Workflows 또는 통합이 중단됩니다. RFDM은 별도의 관리자 컨테이너 없이 스트림을 관리합니다.

자체 컨테이너를 실행하려면 "서비스 추가"에서 "사용자 지정 서비스"를 선택하고 서비스 이름, 컨테이너 이미지, 태그를 입력하세요. "고급 옵션"을 열어 포트, 볼륨 마운트, 명령, 재시작 정책, 종속성, 런타임 또는 환경 변수를 설정한 다음 "서비스 추가"를 클릭하세요. 볼륨 마운트는 다음 형식으로 작성합니다. `host_path:container_path`읽기 전용으로 마운트하려면 `:ro` 를 추가하세요. 각 컨테이너 경로는 한 번만 마운트할 수 있습니다.

기기가 저장된 변경 사항을 적용할 때는 설정이 변경된 서비스와 이에 종속된 서비스만 다시 시작합니다.

기기의 모든 서비스를 다시 시작하려면 기기의 옵션 메뉴나 기기 목록의 해당 행 메뉴에서 "서비스 다시 시작"을 클릭하세요. 서비스가 다시 시작되는 동안 스트림과 추론이 중단됩니다. 구성을 변경한 뒤 60초 동안은 대화상자에 재시작하기 전에 기다리라는 메시지가 표시됩니다. 기기가 TensorRT 엔진을 컴파일하는 중에 다시 시작하면 컴파일 결과가 폐기됩니다. 기기 전체를 다시 시작하려면 기기의 옵션 메뉴에서 "기기 재부팅"을 클릭하세요. 부팅이 완료될 때까지 기기를 사용할 수 없습니다.

저장된 서비스 하나를 다시 시작하려면 해당 탭을 열고 "서비스 다시 시작"을 클릭하세요. 서비스가 잠시 중단되며, 해당 서비스를 사용하는 스트림도 중단됩니다. 대화상자에 서비스가 준비된 시점이나 재시작 실패 또는 시간 초과 여부가 표시됩니다. 실패한 경우 "재시작 재시도"를 클릭하세요. 먼저 변경 사항을 저장하거나 취소하세요. 이 버튼은 서비스 재시작을 지원하는 Deployment Manager 버전이 설치된 기기에만 표시되며, 관리자 서비스에는 표시되지 않습니다.

***

#### 폴더 기기 구성

폴더에 기기 구성 패치를 저장하면 해당 폴더에 새로 추가되는 기기에 공유 설정이 적용됩니다. 폴더에 추가된 기기는 작업 공간 기본 구성으로 시작합니다. 그런 다음 최상위 폴더부터 각 상위 폴더의 패치가 차례로 적용되고, 마지막으로 해당 폴더 자체의 패치가 적용됩니다. 하위 폴더에서 설정한 키는 상위 폴더의 동일한 키를 대체합니다. 기기 자체에 저장된 설정은 계속 우선 적용됩니다.

패치를 수정하려면 Projects 페이지에서 폴더 메뉴를 열고 "기기 구성"을 클릭하거나, Edge Devices 목록에서 폴더 헤더의 "기기 구성"을 클릭하세요. 대화상자에는 폴더의 새 기기에 적용되는 각 설정과 해당 값의 출처(예: "작업 공간" 또는 상위 폴더 이름)가 표시됩니다. 이 폴더에서 설정을 재정의하려면 해당 설정을 선택하고 값을 입력하세요. 환경 변수와 같은 상속된 텍스트 설정을 지우려면 "제거"를 클릭하세요. 다른 설정에는 "제거"가 없습니다. 대신 새 값으로 재정의하세요. 목록에 없는 설정을 추가하려면 "구성 경로"(예: `services.inference.environment_variables.NAME`)와 "값"을 입력한 다음 "키 추가"를 클릭하세요. "저장"을 클릭해 패치를 저장하거나 "패치 지우기"를 클릭해 폴더 자체의 패치를 제거하세요. 수정하려면 "기기 관리" 권한과 폴더에 대한 "읽기 및 쓰기" 액세스 권한이 필요합니다. 기기를 볼 수 있는 다른 사용자는 패치를 읽기만 할 수 있습니다. 자체 패치가 있는 폴더에는 "기기 구성" 배지가 표시됩니다.
