Skip to main content

최신 패키지 설치 방식

Ruoom 플러그인은 Core와 동일한 Python 환경에 설치합니다. 최신 플러그인 저장소를 Core의 plugins 디렉터리에 복사하지 말고 INSTALLED_APPS도 직접 수정하지 마십시오.
  1. Ruoom Code Lab 또는 권한이 있는 비공개 GitHub 릴리스에서 제공된 wheel을 다운로드합니다.
  2. Core가 사용하는 가상 환경을 활성화합니다.
  3. 로컬 wheel 경로를 지정하여 설치합니다.
  4. .envRUOOM_PLUGINS에 설치된 플러그인 식별자를 쉼표로 구분하여 설정합니다.
  5. 마이그레이션, 프로덕션 정적 파일 수집 및 Django 검사를 실행합니다.
  6. 설치된 패키지 또는 RUOOM_PLUGINS를 변경한 후 애플리케이션 프로세스를 다시 시작합니다.
Core가 활성화된 플러그인을 자동으로 등록하므로 일반적인 설치에서는 ruoom/settings.py를 수정하지 않습니다.

패키지 식별자

의존 플러그인을 먼저 설치하십시오. 예:
wheel과 고객용 소스 ZIP은 라이선스가 적용된 아티팩트입니다. Ruoom Code Lab 또는 권한이 있는 비공개 릴리스에서 받은 파일만 설치하십시오. 공개 PyPI에는 배포되지 않습니다.

업그레이드 또는 제거

새 wheel을 --upgrade로 설치한 다음 마이그레이션과 검사를 실행합니다.
플러그인을 제거하기 전에 RUOOM_PLUGINS에서 식별자를 삭제하고 애플리케이션을 다시 시작한 다음 배포 패키지를 제거하십시오. 패키지를 제거해도 데이터베이스 마이그레이션이나 데이터가 자동으로 삭제되지는 않습니다.

예약 1.2.2 예외

예약 1.2.2는 wheel이 아니라 booking-plugin-1.2.2-customer.zip으로 배포됩니다. 레거시 플랫 소스 레이아웃을 유지하므로 위의 복사 없는 패키지 설치 방식이 아직 적용되지 않습니다. 예약 빠른 시작을 따르고 고객용 ZIP을 pip로 설치하지 마십시오.

문제 해결

  • Unknown Ruoom plugin: Core 플러그인 레지스트리에 등록된 식별자를 사용하십시오.
  • UI에 플러그인이 표시되지 않음: manage.py와 동일한 Python 환경에 wheel이 설치되어 있는지, 식별자가 RUOOM_PLUGINS에 있는지, 프로세스를 다시 시작했는지 확인하십시오.
  • ModuleNotFoundError: 올바른 wheel을 다시 설치하고 python -m pip show <distribution-name>으로 확인하십시오.
  • 마이그레이션 오류: 필수 의존 플러그인을 먼저 설치하고 활성화한 다음, Django가 의존 순서를 결정할 수 있도록 python manage.py migrate를 인수 없이 실행하십시오.