릴리스 주기

릴리스 주기 (Release Cycle)

LiteLLM 프록시는 다음과 같은 릴리스 주기를 가져요.

  • 1.x.x-dev.N (nightly): CI/CD를 통과한 릴리스(수동 검토 없음). PyPI에 1.x.x.devN으로 배포돼요.
  • 1.x.x-rc.N (release candidate): CI/CD와 수동 검토 + 성능 테스트(진행 중, 곧 구현 예정) + 초기 테스터가 이슈를 제출할 수 있는 7일 창을 통과한 릴리스. PyPI에 1.x.xrcN으로 배포돼요.
  • 1.x.x (stable): 위의 모든 것을 통과한 rc가 2차 수동 테스트를 거친 뒤 stable로 승격된 릴리스예요.

프로덕션에서는 최신 stable 1.x.x 릴리스에 고정(pin)하는 것을 권장해요.

1.84.0부터 버전 관리가 바뀌었어요.

-stable과 -nightly 접미사가 사라졌어요. Stable 릴리스는 이제 일반 PEP 440 / SemVer 2.0(예: 1.84.0) 형태이고, 주간 예약 릴리스는 MINOR 컴포넌트를 올리며, PATCH는 핫픽스 전용으로 남겨져요. Docker는 같은 이미지를 가리키는 bare(1.84.0)와 v 접두사(v1.84.0) 태그를 모두 배포하고, PyPI는 bare PEP 440 형태(1.84.0, 절대 v1.84.0 아님)를 사용해요. 예전 이름(v1.83.x-stable 등)으로 배포된 릴리스는 영구히 유지돼요.

이전 → 새 이름 매핑 전체는 LiteLLM 릴리스 버전 관리가 바뀌고 있어요를 참고하세요.

릴리스 노트는 여기에서 확인할 수 있어요.

주간 일정

매주 같은 루프가 하나의 버전 라인에 대해 반복돼요. 첫 nightly(dev) 빌드(보통 화요일)가 다음 마이너 버전(예: 1.86.0)을 열고, 그 베이스가 stable로 배포될 때까지 모든 빌드를 타고 올라가요. 두 번째 nightly가 주중(보통 목요일)에 이어져요. 토요일에는 릴리스 후보(1.86.0rc1)가 잘라져서 초기 테스터와 QA를 위한 약 1주일 창에 들어가요. 다음 주 후반(금요일이나 토요일)에는 지난주 rc가 접미사를 뗀 채 stable로 승격돼요(1.85.0rc1 → 1.85.0). 수정사항이 백포팅되지 않는 한 그 rc와 동일해요. 그래서 매 토요일은 이중 역할을 해요. 이번 주 rc가 잘려 나가는 동시에 지난주 rc가 stable이 되는 거죠.

요일 배포되는 것
화요일 첫 nightly dev 빌드; 다음 마이너(1.86.0.dev1)를 엶
목요일 두 번째 nightly dev 빌드, 누적(1.86.0.dev2)
토요일 새 rc 절단(1.86.0rc1); 지난주 rc가 stable로 승격됨
다음 화요일 다음 라인의 첫 nightly가 열림(1.87.0.dev1); 루프 반복

토요일 rc가 QA를 통과하지 못하면 승격되지 않아요. 수정이 배치되고 후속 rc가 잘라질 수 있으며, 일정은 거기서 이어져요.

FAQ

LiteLLM stable 릴리스의 릴리스 일정이 있나요?

Stable 릴리스는 매주(보통 일요일) 나와요. 예약된 stable마다 MINOR 버전이 올라가요: 1.84.0 → 1.85.0 → 1.86.0.

'minor' 범프와 'patch' 범프의 차이는 무엇인가요?

1.84.0부터(버전 관리 블로그 참고):

  • 'minor' 범프: 정기 주간 예약 stable 릴리스(1.84.0 → 1.85.0). 정상 주기이며 새 하위 호환 기능이나 DB 테이블을 포함할 수 있어요.
  • 'patch' 범프: 현재 stable에 대한 핫픽스 전용(1.84.0 → 1.84.1).
  • 'major' 범프: 하위 호환성을 깨뜨리는 변경(1.x.x → 2.x.x).

Enterprise 지원

지원 모델 변경, 2026년 5월 18일

LiteLLM이 성장하면서 현재의 프로페셔널 지원 모델은 우리 규모에 맞지 않게 되었어요. 고객이 언제 지원과 변경을 기대할 수 있는지에 대한 명확하고 예측 가능한 커뮤니케이션을 중심으로 한 새 모델로 전환 중이에요. 아래에 설명된 모델은 폐기 예정이며, 다음 몇 주 안에 확정되는 대로 새 시스템에 대한 세부 사항을 공유할게요.

  • Stable 릴리스는 매주 나와요. 새 버전이 나오면 이전 버전에 대한 지원은 더 이상 제공하지 않아요.
  • MAJOR 변경이 있으면(세마버 관례에 따라, 예: 1.x.x → 2.x.x) 이전 stable 이미지에 대해 최대 90일간 지원을 제공할 수 있어요.

출처: 문서

더 알아보기 (Learn more)

  • 릴리스 버전 관리 변경 블로그(Cleaner Release Versions) 읽어보기
  • GitHub 릴리스 페이지에서 각 버전 변경 사항 확인하기