kubectl patch isvc ... 처럼 등장하는 isvc 는 InferenceService 의 축약형(shortName)이다. KServe(구 KFServing)가 제공하는 커스텀 리소스(CRD)로, 학습된 모델을 쿠버네티스 위에 추론 서버로 배포할 때 쓴다. 풀네임은 inferenceservices.serving.kserve.io 이며, kubectl patch isvc my-model 은 kubectl patch inferenceservice my-model 과 같다.
하나의 InferenceService 가 predictor / transformer / explainer 컴포넌트를 묶어 관리하고, 뒤에서 Knative Service·Deployment·Service·Ingress 등을 자동 생성한다.
kubectl api-resources | grep -i inference # shortName 확인
kubectl get isvc -A # 배포된 추론 서비스 목록
kubectl explain isvc.spec # 스펙 구조 설명
모델 스토리지 URI 를 바꾸는 patch 예시:
kubectl patch isvc my-model -n my-ns --type=merge \
-p '{"spec":{"predictor":{"model":{"storageUri":"s3://bucket/model-v2"}}}}'
isvc 가 인식되지 않으면 클러스터에 KServe 가 설치되어 있지 않거나, Kubeflow 구버전이라 serving.kubeflow.org API 그룹을 쓰는 경우다. kubectl api-resources | grep -i inference 로 실제 API 그룹을 확인한다.