Python 개발 가이드라인
GitLab은 reStructuredText 마크업 렌더링을 위해 Python을 필요로 합니다. Python 3이 필요합니다.
설치
시스템에 Python을 설치하는 여러 가지 방법이 있습니다. 프로덕션에서 사용하는 것과 동일한 버전을 사용하려면 pyenv를 사용하는 것이 좋습니다. 이는 루비 세계의 rbenv와 유사한 방식으로 작동합니다.
macOS
macOS에서 pyenv를 설치하려면 Homebrew를 사용할 수 있습니다:
brew install pyenv
Windows
pyenv는 공식적으로 Windows를 지원하지 않으며 Windows Subsystem for Linux 외부의 Windows에서 작동하지 않습니다. Windows 사용자는 pyenv-win을 사용할 수 있습니다.
Windows에서 pyenv-win을 설치하려면 다음 PowerShell 명령을 실행합니다:
Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"
pyenv-win에 대해 더 알아보기.
Linux
Linux에서 pyenv를 설치하려면 아래 명령을 실행할 수 있습니다:
curl "https://pyenv.run" | bash
또는 시스템 패키지로 pyenv를 사용할 수도 있습니다.
pyenv 전제 조건에 대해 더 읽어보세요.
Shell 통합
Pyenv 설치는 Bash에 필요한 변경 사항을 추가합니다. 다른 쉘을 사용하는 경우 해당 쉘에 필요한 추가 단계를 확인하세요.
Fish의 경우 Fisher에 대한 플러그인을 설치할 수 있습니다:
fisher add fisherman/pyenv
또는 Oh My Fish의 경우:
omf install pyenv
의존성 관리
GitLab에는 직접 Python 스크립트가 포함되어 있지 않지만, reStructuredText 마크업을 렌더링하기 위해 Python에 의존하기 때문에 주요 프로젝트 수준에서 의존성을 추적하여 개발 환경에서 실행할 수 있어야 합니다.
최근에는 Gemfile 및 Bundler 프로젝트에 대한 Python 버전의 동등물로 Pipfile과 Pipenv가 소개되었습니다.
의존성을 나열한 Pipfile이 이제 루트 폴더에 있습니다. 이를 설치하려면 다음을 실행하세요:
pipenv install
이 명령을 실행하면 필요한 Python 버전 및 pip 의존성이 모두 설치됩니다.
사용 방법
Pipenv 환경에서 Python 코드를 실행하려면 먼저 애플리케이션의 의존성에 기반한 virtualenv를 시작해야 합니다. Pipenv를 사용하면 다음과 같이 간단히 실행할 수 있습니다:
pipenv shell
그 명령을 실행한 후에 GitLab을 동일한 쉘에서 실행할 수 있으며, 이는 pipenv install 명령으로 설치된 Python 및 의존성을 사용합니다.
도움말