비디오 구성

관리형 비디오 워커의 제한을 설정하고 자체 호스팅 Inference에서 서버 측 비디오 소스를 구성합니다.

비디오 워커를 실행하는 서버에서 비디오 워커를 구성합니다. 이 설정은 통합 스트림 관리자를 대상으로 하며, 관리형 Serverless Video Streaming API나 로컬 Python InferencePipeline의 제한을 설정하지 않습니다.

참조 보안 구성 마이그레이션 버전 범위에 대해.

관리형 파이프라인 제한

STREAM_MANAGER_MAX_ACTIVE_PIPELINES 기본값은 8 이며, 바쁜 워커와 유휴 워커를 포함한 관리형 파이프라인 전체 프로세스 수의 상한을 정합니다. 유효 상한은 구성된 값과 STREAM_API_PRELOADED_PROCESSES 중 더 큰 값이므로, 사전 로드된 워커 수보다 낮아질 수 없습니다.

변수	기본값	동작
STREAM_MANAGER_MAX_ACTIVE_PIPELINES	8	관리형 파이프라인 프로세스 수를 제한하며, 필요할 경우 사전 로드 수로 상향됩니다.
STREAM_API_PRELOADED_PROCESSES	핵심 라이브러리에서는 0이며, 이미지는 이를 재정의할 수 있습니다.	웜 유휴 워커의 목표 수를 설정합니다.
STREAM_MANAGER_MAX_RAM_MB	설정되지 않음	측정된 및 추정된 RAM 사용량에 따라 새 파이프라인 할당을 선택적으로 거부합니다.

프로세스 상한에 도달하면 관리자는 유휴 워커를 재사용할 수 있지만 다른 프로세스 생성은 거부합니다. 백그라운드 웜 풀도 상한을 준수하며, 바쁜 워커는 목표 유휴 수에 도달하지 않았더라도 하나의 슬롯을 사용합니다.

용량 설정

서버를 시작할 때 환경 파일을 통해 용량 설정을 전달합니다:

STREAM_MANAGER_MAX_ACTIVE_PIPELINES=16
STREAM_API_PRELOADED_PROCESSES=2

inference server start --env-file inference.env

모델과 하드웨어에 맞는 양의 상한을 선택하고, 늘리기 전에 사용하지 않는 파이프라인을 종료하십시오. 이는 프로세스 제한이지, 사용자별 할당량도 아니고, 요청 속도 제한도 아니며, 하드 RAM 또는 GPU 메모리 제한도 아닙니다.

서버 측 비디오 참조

이 섹션의 규칙은 다음의 보류 중인 런타임 강화 빌드에 적용됩니다: 마이그레이션 가이드. 표준 스트림 관리자 및 엔터프라이즈 스트림 요청 스키마는 비디오 백엔드에 도달하기 전에 제공된 미디어 참조를 검증합니다.

지원되는 입력은 다음과 같습니다:

• 정수 카메라 인덱스, 예: 0, 그리고 숫자 CSI 참조, 예: csi://0.

• 절대 경로 또는 명시적 상대 경로, 예: /video.mp4, ./video.mp4, ../video.mp4, 또는 Windows 드라이브 경로.

• 다음을 사용하는 인코딩된 URL: http, https, rtsp, rtsps, rtspt, rtspst, rtmp, rtmps, udp, srt, rtp, tcp, 또는 file.

• 요청 스키마에서 허용하는 지원되는 참조 목록입니다.

선택한 이미지는 해당 전송에 대한 디코더를 제공해야 하며, 경로는 서버 컨테이너 내부에서 읽을 수 있어야 합니다. 이 검증은 카메라 네트워크 대상은 제한하지 않으며, 이미지 URL 제어는 별도의 정책입니다.

기존 참조 업데이트

쓰기 video.mp4 로 ./video.mp4. URL의 공백과 따옴표는 인코딩하고, 다음을 포함하는 로컬 경로는 이름을 바꾸십시오: !, =, 또는 따옴표; 지원되지 않는 스킴과 원시 GStreamer 설명은 기본적으로 거부됩니다.

원시 GStreamer 파이프라인 사용

원시 실행 구문이 필요한 신뢰할 수 있는 워크로드의 경우 다음을 설정합니다:

ALLOW_UNSAFE_GSTREAMER_PIPELINES=True

이렇게 하면 미디어 참조 검증을 우회하고, 설치된 플러그인의 기능을 포함한 원시 파이프라인 해석이 복원됩니다. 지원되는 RTSP 및 RTMP URL은 이 opt-in이 필요하지 않으며, 누락된 GStreamer 플러그인을 설치하지는 않습니다.

클라이언트 측 비디오 소스

이러한 검사는 서버의 스트림 요청 스키마로 전송되는 참조에 적용됩니다. SDK로 로컬에서 연 파일의 이름을 바꾸지는 않으며 VideoFileSource 직접적인 로컬 Python 미디어 사용도 변경하지 않습니다.

참조 Workflows를 사용한 비디오 처리 비디오를 열 위치를 선택하는 데 대한 서버 보안 파이프라인을 관리할 수 있는 주체에 대한