Poetry에서 uv로의 전환: CI/CD 파이프라인 최적화 및 효율성 극대화

핵심 기술

이 글은 Python 패키지 관리 도구인 Poetry에서 uv로의 성공적인 전환 경험을 공유하며, CI/CD 파이프라인에서 빌드 시간 단축, Docker 이미지 크기 감소, 그리고 빌드 재현성 향상이라는 구체적인 이점을 제시합니다.

기술적 세부사항

• Poetry에서 uv로 전환: 네 번째 프로젝트를 Poetry(또는 일반 pip)에서 uv로 성공적으로 마이그레이션했습니다.
• CI 이미지 최적화:
  • Poetry: CI 이미지 크기 264MB, 빌드 시간 2:17-2:26
  • uv: CI 이미지 크기 235MB, 빌드 시간 1:30-1:50
• 이미지 크기 증가 요인: Python 애플리케이션의 ~30MB 추가 크기는 주로 많은 종속성 때문이며, uv 자체도 44MB로 작지 않지만 Python 환경보다 훨씬 효율적입니다.
• 빌드 시간 단축: 대부분의 빌드 시간은 Ansible 컬렉션 설치에 소요되지만, Python 스택 설치 시간이 Poetry/pip 대비 현저히 줄어들었습니다.
• uv 사용 방식: uv를 직접 사용하거나 (uv sync), uv export를 통해 requirements.txt로 내보내는 두 가지 방식을 시도했습니다. 직접 사용하는 방식이 훨씬 빠르고 편리합니다.
• with uv 방식의 이점: uv sync만으로 venv 생성 없이 의존성 동기화가 가능하며, python3-pip 패키지를 생략하여 이미지 크기 절감에 기여합니다.
• 마이그레이션 도구: uvx migrate-to-uv 명령어를 사용하여 pyproject.toml 변환의 인지 부하를 줄였습니다.
• Poetry 사용 시 문제점:
  1. 1.6-2.0 버전에서 호환성 문제가 발생하여 pyproject.toml의 다양한 버전 지원이 어려웠습니다.
  2. 재현 가능한 이미지 빌드 시, Poetry가 설치된 패키지의 파일 권한 비트(예: 0754 vs 0757)에 임의적인 변화를 유발했습니다.
  3. poetry export 기능이 별도 패키지로 분리되어 사용 편의성이 저하되었습니다.
• 재현성: Poetry 사용 시 발생하는 캐시 관련 무작위성 없이, uv sync --no-cache를 통해 일관된 빌드를 달성했습니다.

개발 임팩트

• CI/CD 파이프라인의 전반적인 빌드 속도 향상 및 이미지 크기 감소를 통해 리소스 효율성을 높일 수 있습니다.
• 더욱 일관되고 재현 가능한 빌드 환경을 구축할 수 있습니다.
• 패키지 관리 및 의존성 해결 과정의 복잡성을 줄여 개발 생산성을 향상시킵니다.

커뮤니티 반응

작성자는 Poetry의 빠른 변화와 호환성 문제, 재현성 이슈를 경험하며 uv로의 전환을 결정했습니다. 특히, poetry export 기능의 접근성 저하도 이탈의 주요 원인이었습니다. uv의 간결성과 효율성에 만족감을 표현하고 있습니다.