GitLab은 reStructuredText 마크업 렌더링을 위한 의존성으로 Python을 필요로 합니다. Python 3이 필요합니다.

설치#

시스템에 Python을 설치하는 방법은 여러 가지가 있습니다. 프로덕션에서 사용하는 것과 동일한 버전을 사용할 수 있도록, pyenv를 사용하는 것을 권장합니다. 이는 Ruby 세계의 대응 도구인 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 사전 요구 사항에서 확인할 수 있습니다.

셸 통합#

Pyenv 설치 시 Bash에 필요한 변경 사항이 추가됩니다. 다른 셸을 사용하는 경우, 해당 셸에 필요한 추가 단계가 있는지 확인하세요.

Fish의 경우, Fisher용 플러그인을 설치할 수 있습니다:

fisher add fisherman/pyenv

또는 Oh My Fish의 경우:

omf install pyenv

의존성 관리#

GitLab은 Python 스크립트를 직접 포함하고 있지 않지만, reStructuredText 마크업 렌더링을 위해 Python에 의존하므로, 개발 머신에서 실행할 수 있도록 메인 프로젝트 수준에서 의존성을 추적해야 합니다.

최근에는 Python에도 Gemfile 및 Bundler 프로젝트에 상응하는 도구가 도입되었습니다: Pipfile 및 Pipenv.

의존성을 포함한 Pipfile이 이제 루트 폴더에 존재합니다. 의존성을 설치하려면 다음을 실행하세요:

pipenv install

이 명령을 실행하면 필요한 Python 버전과 pip 의존성이 모두 설치됩니다.

사용 방법#

Pipenv 환경에서 Python 코드를 실행하려면, 먼저 애플리케이션의 의존성을 기반으로 virtualenv를 시작해야 합니다. Pipenv를 사용하면 다음 명령만으로 간단하게 실행할 수 있습니다:

pipenv shell

이 명령을 실행한 후, 동일한 셸에서 GitLab을 실행하면 pipenv install 명령으로 설치된 Python과 의존성을 사용합니다.