installation

Rez 설치 문서 요약

---

1. 설치 스크립트를 이용한 설치

필수 요구 사항:

• Python 3.7 이상(3.7, 3.8, 3.9, 3.10, 3.11 지원)
• Rez 소스 코드:
  • Git으로 리포지토리를 클론하거나, GitHub의 최신 릴리스 페이지에서 다운로드.
  • 다운로드 후 압축 해제 필요.

설치 방법:

1. Rez 소스 코드의 루트 디렉터리에서 다음 명령어 실행:
2. python ./install.py
3. 기본 설치 경로는 /opt/rez이며, 설치 옵션 확인을 위해 install.py -h 실행 가능.

설치 완료 후:

설치 성공 메시지가 출력되며, $PATH에 아래와 같은 경로를 추가해야 Rez를 활성화할 수 있습니다.

/opt/rez/bin/re

주의 사항:

• 설치 경로를 변경하려면 기존 설치를 이동하지 말고 새 위치에 다시 설치해야 합니다.
• 여러 운영 체제에 설치하려면 각 운영 체제별로 별도로 설치해야 합니다.

---

2. pip을 이용한 설치

설치 방법:

pip install rez

제약 사항:

• Rez 명령줄 도구가 rez-env 명령어로 구성된 환경 내부에서는 제대로 작동하지 않을 가능성이 있음.
• Pip 설치는 Rez API만 필요하거나, 명령줄 도구가 필요하지 않을 때 적합.

경고 메시지:

Pip 설치된 Rez 명령줄 도구를 실행하면 아래와 같은 경고가 출력될 수 있습니다:

Pip-based rez installation detected. Please be aware that rez command line tools
are not guaranteed to function correctly in this case.

---

3. 프로덕션에서 pip 설치를 사용하지 않는 이유

Rez는 일반적인 Python 패키지가 아니므로 pip 설치 시 다음과 같은 문제가 발생할 수 있습니다:

• rez-env 명령어로 구성된 환경에서 Rez 명령줄 도구가 제대로 작동하지 않을 가능성이 있음.
• 환경 내부에서 다른 패키지의 도구들이 여전히 표시되지만, 작동이 보장되지 않음.
• 환경 변수(예: PYTHONPATH)의 영향으로 Rez 도구가 비정상적으로 동작하거나 충돌할 가능성이 있음.

해결 방법:install.py 스크립트는 다음과 같은 추가 작업을 수행하여 문제를 방지합니다:

• Rez를 독립 실행형으로 작동하도록 가상 환경(virtualenv)에 설치.
• Rez 도구에 python -E 옵션을 추가해 Python의 환경 변수 영향을 방지.
• Rez 도구를 별도의 디렉터리에 저장하여 다른 도구와 분리.

 

https://rez.readthedocs.io/en/stable/installation.html