[패키지 버전 관리] requirements.txt

프로젝트를 만들고 나서, 배포하기 전에 requirements.txt 에 프로젝트에 사용했던 패키지들의 목록과 버전을 적는다.

 

◆ requirements.txt 파일의 사용 목적

1. 프로젝트 의존성 관리
   • 프로젝트에서 사용하는 Python 패키지들의 목록과 정확한 버전을 기록하여 관리할 수 있다.
   • 이를 통해 나중에 동일한 환경을 쉽게 재현할 수 있다.

협업과 배포의 편의성

• 다른 개발자나 운영 환경에서 동일한 패키지를 설치할 때, requirements.txt 파일만 있으면 아래 명령어로 일괄 설치가 가능하다.

pip install -r requirements.txt

• 즉, 환경 설정 시간을 단축하고 오류 발생 가능성을 줄여 준다.

1. 버전 충돌 방지
   • 특정 패키지 버전을 명시함으로써, 중요한 패키지의 호환성 문제를 예방할 수 있다.
   • 예를 들어, FastAPI 0.89버전 이상을 명시하면 호환되는 버전으로 자동 조절된다.

 

그런데, 간혹가다 위의 명령어로 하게 되면 버전명이 file로 뜨는 문제들이 생긴다. 물론, 이 txt 파일을 다운 받아 설치하면 당연히 설치도 제대로 안 된다.

 

따라서, 앞으로 패키지==버전 의 형태로 저장하기 위해서는 아래의 명령어로 입력하면 된다.

pip list --format=freeze > requirements.txt

 

패키지명과 버전만 깔끔하게 정리된 것을 확인할 수 있다.

설치할 때는 똑같이

pip install -r requirements.txt