Python 개발 지침

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

GitLab 11.10부로 Python 3가 필요합니다.

설치

시스템에 Python을 설치하는 여러 가지 방법이 있습니다. 운영 환경에서 사용하는 것과 동일한 버전을 사용할 수 있도록, pyenv를 사용하는 것을 권장합니다. 이는 루비 세계의 rbenv와 유사하게 작동합니다.

macOS

macOS에 pyenv를 설치하려면 Homebrew를 사용할 수 있습니다:

brew install pyenv

Windows

pyenv는 공식적으로 Windows를 지원하지 않으며, Windows Subsystem for Linux에서만 사용할 수 있습니다. 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에 의존하므로, 개발 환경에서 해당 스크립트를 실행할 수 있도록 프로젝트 수준에서 의존성을 관리해야 합니다.

최근에는 GemfileBundler 프로젝트의 동등물로 Python에도 PipfilePipenv가 도입되었습니다.

의존성이 포함된 Pipfile이 이제 루트 폴더에 있습니다. 이를 설치하려면 다음을 실행합니다:

pipenv install

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

사용 지침

Pipenv 환경에서 Python 코드를 실행하려면 먼저 응용 프로그램의 의존성을 기반으로 한 virtualenv를 시작해야 합니다. Pipenv를 사용하면 다음과 같이 간단히 실행할 수 있습니다:

pipenv shell

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