DEPLOY IT · 기술 인사이트

vLLM GPU 메모리 설정: 문맥 길이와 동시 요청을 함께 정하는 법

GPU를 고르기 전에 요청의 크기부터 정하세요

사내 LLM을 배포할 때는 모델이 GPU에 올라가는지와 업무 요청을 감당하는지를 따로 확인해야 합니다. 입력 문서 길이, 답변 길이, 동시에 들어올 요청의 범위를 먼저 정하면 메모리 부족과 대기 시간을 평가할 기준이 생깁니다.

vLLM의 메모리 설정을 이해할 때는 모델 가중치, 실행에 필요한 공간, 문맥 정보를 보관하는 KV 캐시를 나눠 생각하면 편합니다. 모델 이름이나 파라미터 수만으로 특정 GPU의 처리량을 확정할 수는 없습니다.

모델 가중치·실행 공간과 KV 캐시를 나누고 문맥 길이·동시 요청을 함께 검토하는 흐름
모델 적재 성공 다음에는 실제 요청 조건을 확인합니다. (설명용 개념도)

세 가지 설정은 서로 다른 질문에 답합니다

--max-model-len은 입력과 출력을 합친 요청 길이의 상한입니다. 긴 문서 요약을 평가한다면 문서만 채우지 말고 답변에 필요한 토큰 여유도 남겨야 합니다.

--max-num-seqs는 한 번의 처리 반복에서 다룰 시퀀스 수를 제한합니다. 이 숫자를 그대로 동시 사용자 수나 초당 처리량으로 읽으면 안 됩니다.

--gpu-memory-utilization은 해당 vLLM 인스턴스가 사용할 GPU 메모리 비율을 정합니다. KV 캐시 크기를 직접 지정하는 --kv-cache-memory-bytes를 설정하면 이 비율 대신 명시한 캐시 예산이 적용되므로, 두 값을 독립된 추가 용량처럼 합산하지 마세요.

이 정의는 2026년 10월 27일 확인한 vLLM 최신 엔진 인자 문서 기준입니다. 실제 배포에서는 설치한 버전의 문서와 도움말을 함께 보관해 지원 인자를 대조하세요.

문맥 길이 상한, 반복별 시퀀스 상한, 엔진 메모리 예산을 구분한 설정 안내
길이·처리 수·메모리 예산은 각각 기록합니다. (설명용 개념도)

지원 조건과 모델 라이선스를 별도로 확인하세요

새 Ubuntu VM에서는 먼저 관리자가 승인한 GPU 연결 또는 패스스루, 드라이버 상태, 디스크 여유, 모델 다운로드 경로를 확인하세요. vLLM의 GPU 설치 문서에서 장치별 지원 조건을 확인하고 새 Python 환경이나 버전이 고정된 컨테이너로 실행 환경을 분리하는 것이 출발점입니다.

이는 공식 GPU 설치 문서를 바탕으로 한 도입 점검 순서입니다. Ubuntu라는 운영체제 이름만으로 모든 GPU·드라이버·배포 파일 조합이 지원된다고 판단할 수는 없습니다.

모델 측 확인 예로 Qwen3-8B 공식 모델 카드는 Apache-2.0 라이선스와 vLLM 배포 안내를 제공합니다. Qwen3는 2025년 4월 29일 발표된 모델군이며, 여기서는 기존 공개 모델의 검토 예로 다룹니다.

도입할 정확한 가중치 저장소의 LICENSE와 고지·재배포 조건을 보관하세요. 다른 모델이나 제삼자가 만든 양자화 파일에도 같은 조건이 적용된다고 추정하지 말고, 엔진 지원 여부와 모델 이용 조건을 각각 확인해야 합니다.

한국어 업무는 품질과 지연을 함께 평가하세요

권장 평가안은 짧은 질의, 긴 문서 요약, 표의 숫자 추출, 근거가 없어 답변을 보류해야 하는 질문을 구분하는 것입니다. 문서 길이와 요청 수를 단계적으로 늘리되 모델 버전·정밀도·출력 상한을 함께 기록하세요.

운영자는 첫 토큰까지의 시간, 전체 응답 시간, 오류와 메모리 부족 여부를 살펴보고, 업무 검토자는 숫자·날짜·출처 누락과 임의 추정을 확인합니다. 빠른 답변이라도 원문 금액을 틀리면 해당 업무에 적합하다고 보기 어렵습니다.

통과 기준은 평가 전에 업무 담당자와 정하세요. 이 글은 평가 설계 제안이며 GPU 실측, 한국어 정확도 검증, 운영 부하 시험을 수행한 결과가 아닙니다.

문서 요약·표 추출·답변 보류를 구분하고 품질과 지연을 함께 평가하는 흐름
같은 요청 묶음을 사용해야 설정 변경 전후를 비교할 수 있습니다. (설명용 개념도)

신규 설치본과 업데이트본에 복구 경로를 남기세요

신규 설치용 전체 패키지에는 실행 환경 버전, 모델 리비전, 라이선스, 설정 예시와 시작·종료 절차를 묶는 것을 권합니다. IP·FQDN·노드·사이트별 값은 공통 설정 한곳에서 관리하고, 자격증명은 별도 비밀 저장소나 사용자 입력으로 다루세요.

기존 환경 업데이트는 변경 파일과 의존성 차이를 분리해 제공하고, 기존 모델·설정·사용자 수정 사항을 덮어쓰기 전에 복구 가능한 백업을 만드세요. 새 버전을 격리된 환경에서 평가한 뒤 전환하고, 문제가 생기면 보관한 이전 실행본과 설정으로 돌아가는 절차를 연습합니다.

중앙 로그에는 모델·엔진 버전, 설정 변경, 지연·오류와 복구 결과를 남기되 비밀값과 민감한 원문은 기록하지 않는 정책을 정하세요. 백업 파일 존재 확인과 별도 환경에서 다시 기동해 보는 복구 확인은 구분해야 합니다.

신규 설치 준비와 업데이트 보존 및 이전 실행본 복구 절차
설치 패키지와 변경 패키지는 같은 복구 기준으로 관리합니다. (설명용 개념도)

DeployIT 제품에 적용할 때의 범위

DeployIT 공개 홈페이지는 AI FORGE를 GPU 교육·실습 플랫폼으로 소개합니다. 이 글의 평가 순서는 GPU 실습 환경의 모델 검토 항목으로 참고할 수 있지만, AI FORGE의 특정 vLLM 버전 연동이나 성능을 검증했다는 의미는 아닙니다.

PIVOT은 공개 소개상 Proxmox 통합 운영 포털입니다. VM·인프라 운영과 LLM 응답 품질 평가는 담당 범위를 구분하고, 실제 모델 서빙 연동과 지원 조건은 도입 환경별로 확인해야 합니다.

자주 묻는 질문

문맥 길이를 줄이면 GPU 메모리 사용량도 바로 줄어드나요?

그렇게 단정할 수 없습니다. vLLM은 지정한 메모리 예산 안에서 캐시를 구성하므로 길이 상한과 예약 메모리, 실제 요청 처리 상태를 함께 확인하세요.

모델이 기동되면 한국어 업무에 바로 투입해도 되나요?

기동은 실행 경로를 확인한 단계입니다. 실제 업무 문서로 정확도·지연·오류·답변 보류 기준을 통과하는지 따로 평가해야 합니다.

공식 근거와 도입 문의

GPU 실습 환경과 인프라 구성 범위는 제품 소개와 DeployIT 도입 상담에서 확인할 수 있습니다.