경고
이 버전의 Torchbox.com Repo는 이제 은퇴했습니다. 아마도 https://github.com/torchbox/torchbox.com을 원할 것입니다.
기존 reame 컨텐츠는 아래에 참조를 위해 보존됩니다.
* * * * * * * * * *
이것은 메인 Torchbox.com 웹 사이트입니다. 이 사이트의 경력 섹션은 Torchbox/Careers에서 찾을 수 있습니다.
이 프로젝트에는 /docs 폴더의 Markdown에 작성된 기술 문서가 포함되어 있습니다. 이것은 무엇보다도 다음과 같습니다.
실행하여 mkdocs 사용하여 볼 수 있습니다.
mkdocs serve문서는 http : // localhost : 8001/에서 제공됩니다.
이 저장소에는 로컬 Docker 컨테이너에서 프로젝트를 실행하기위한 docker-compose 구성과이를 프로비저닝 및 관리하기위한 Fabfile이 포함됩니다.
직물 스크립트를 사용하여 개발에 도움이되는 다른 명령이 많이 있습니다. 그들 모두를 보려면 달리기 :
fab -l지역 환경을 운영하려면 다음이 필요합니다. 지정된 최소 버전은 작동중인 것으로 확인되었습니다. 이전 버전이 이미 설치된 경우 작동 할 수 있지만 보장되지는 않습니다.
Mac OS에서는 이전 버전의 직물이 설치된 경우 이전 버전을 제거한 다음 PIP3로 새 버전을 설치해야 할 수도 있습니다.
pip uninstall fabric
pip3 install fabric pyenv : https://realpython.com/intro-to-pyenv/를 설정하여 다른 Python 버전을 관리 할 수 있습니다.
또한 생산 / 스테이징 환경과 상호 작용하려면 다음과 같이 필요합니다.
Docker Desktop을 사용하는 경우 리소스를 확인하십시오 : 파일 공유 설정은 복제 된 디렉토리를 웹 컨테이너에 장착 할 수 있도록합니다 (빌드 끝에 OCI 런타임 장애를 mounting 하지 않음).
로컬 빌드 시작은 실행을 통해 수행 할 수 있습니다.
git clone [email protected]:torchbox/wagtail-torchbox.git
cd wagtail-torchbox
fab build
fab migrate
fab start 이것은 배경에서 컨테이너를 시작하지만 장고는 아닙니다. 이렇게하려면 fab sh 있는 웹 컨테이너에 연결하고 honcho start .
그런 다음 달리는 컨테이너에 다시 연결하고 ( fab sh ) :
dj createcachetable
dj createsuperuser이 사이트는 호스트 머신에서 사용할 수 있어야합니다. http://127.0.1:8000/
프론트 엔드 또는 백엔드 툴링 만 실행하려면 honcho 실행하는 명령이 docker/Procfile 에 있습니다.
컨테이너를 처음 시작하면 정적 파일이 존재하지 않거나 구식 일 수 있습니다. 이를 해결하려면 npm run build 실행하십시오.
일반적인 명령은 다음과 같습니다.
# Install front-end dependencies.
npm install
# Start the Webpack build in watch mode, without live-reload.
npm run start
# Start the Webpack server build on port 3000 only with live-reload.
npm run build
# Do a one-off Webpack production build.
npm run build:prod프론트 엔드 툴링을 실행하는 두 가지 방법이 있습니다.
FRONTEND=local 로 프로젝트 루트 ( .env.example 참조)에서 .env 파일을 만듭니다. fab start 더 이상 frontend 컨테이너를 시작하지 않습니다. 이제 fab start 실행할 때 Docker는 Frontend Dev 서버에 필요한 포트에 바인딩하려고 시도하지 않으므로 로컬로 실행할 수 있습니다. 모든 툴링은 여전히 컨테이너에서 사용할 수 있습니다. 파이썬 패키지는 웹 컨테이너에서 poetry 사용하여 설치할 수 있습니다.
fab sh
poetry add wagtail-guide
설치된 종속성을 poetry.lock 파일의 방식으로 다시 재설정하려면 :
fab sh
poetry install --no-root
배포하려면 기능 분기를 master 또는 staging 브랜치로 병합하십시오. CI 파이프 라인이 통과되면 해당 Heroku 사이트에 자동으로 배포됩니다.
이것은 Heroku Github 통합을 통해 이루어집니다.