배포된 모델의 수명주기 관리하기
배포된 모델의 수명주기 관리하기
Azure OpenAI에서 모델을 배포했다면 그걸 그대로 두고 잊어버려도 된다고 생각하면 안 돼요. 모델은 자동·수동 업데이트 정책이 따로 있고, 수명이 다하면(retirement) 배포가 더 이상 응답하지 않을 수 있기 때문이에요. 이 문서는 배포 모델의 버전 업그레이드 정책을 설정하고, REST API로 버전을 갱신하며, 프로비저닝 배포를 다른 모델로 옮기는 법을 알려줘요.
모델 업데이트
Azure OpenAI 배포는 Standard 배포 유형에서만 자동 모델 업데이트를 지원해요. 프로비저닝 배포 유형은 아래 "프로비저닝 배포에서 모델 관리" 섹션에서 따로 다루게 돼요.
먼저 Azure OpenAI 리소스로 추론·미세조정에 사용할 수 있는 모델 목록을 알아보려면 Models List API를 쓰면 돼요. 모델마다 지원하는 리전이 다르니 배포 전에 지역별 모델 가용성을 함께 확인하는 게 좋아요.
모델 배포 업그레이드 구성
배포의 버전 업그레이드 정책은 포털이나 CLI·API에서 확인할 수 있어요.
| 도구 | 읽기 | 쓰기(Update) |
|---|---|---|
| Azure PowerShell | 가능. VersionUpgradeOption이 $null인지 확인 |
가능 |
| Azure CLI | 가능. 미설정이면 versionUpgradeOption이 null로 보임 |
불가(현재 버전 업그레이드 옵션 변경 불가) |
업그레이드 정책 값에는 다음이 있어요. 이름 그대로 **NoAutoUpgrade**는 배포가 절대 자동 업그레이드되지 않아요. 수명 종료일이 되면 배포가 멈추니, 그 배포를 가리키는 코드를 만료되지 않은 새 모델 배포로 바꿔야 해요.
null 값은 **OnceCurrentVersionExpired**와 동일하게 동작해요. 모델 업그레이드가 지원되는 모델인데 배포 속성에 Version update policy 항목이 안 보인다면 그 값이 현재 null이라는 뜻이에요. 이 값을 한 번이라도 명시적으로 바꾸면 스튜디오 속성 페이지와 REST API 양쪽에서 해당 속성이 보이게 돼요.
PowerShell로 값을 바꾸는 예시:
# VersionUpgradeOption은 null일 수 있어요. 확인하는 방법 중 하나:
$null -eq $deployment.Properties.VersionUpgradeOption
# Step 3: VersionUpgradeOption 업데이트
$deployment.Properties.VersionUpgradeOption = "NoAutoUpgrade"
API로 모델 배포·업데이트하기
REST로 배포를 생성·업데이트할 수 있어요. 컨트롤 플레인(management) 엔드포인트를 쓰면 돼요:
curl -X PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resource-group-temp/providers/Microsoft.CognitiveServices/accounts/docs-openai-test-001/deployments/gpt-35-turbo?api-version=2025-06-01 \
-H "Content-Type: application/json" \
프로비저닝 배포 유형에서 모델 관리
프로비저닝 배포는 자동 업데이트가 안 되므로, 모델 버전을 올리거나 다른 모델 계열로 옮겨야 할 때 **제자리 마이그레이션(in-place migration)**을 써요. Foundry 포털에서 Deployments 화면의 배포 이름을 선택해 대상 모델 버전 업데이트 마이그레이션을 진행할 수 있어요.