Toolkit을 사용하는 경우 config/overleaf.rc에 다음을 설정하여 git-bridge를 활성화하세요.
config/overleaf.rc
GIT_BRIDGE_ENABLED=true
2
git-bridge 컨테이너 추가 (Docker-compose 사용자 전용)
사용자 지정 docker-compose.yml을 사용하는 경우 compose 파일에 다음 컨테이너 구성을 추가하세요.
docker-compose.yml (git-bridge service)
git-bridge: restart: always image: ghcr.io/ayaka-notes/overleaf-pro/git-bridge:6.3.0 # tag should match the `sharelatex` container tag volumes: - ~/git_bridge_data:/data/git-bridge container_name: git-bridge expose: - "8000" environment: GIT_BRIDGE_API_BASE_URL: "http://sharelatex:3000/api/v0/" # "http://sharelatex/api/v0/" for version 4.1.6 and earlier GIT_BRIDGE_OAUTH2_SERVER: "http://sharelatex" GIT_BRIDGE_POSTBACK_BASE_URL: "http://git-bridge:8000" GIT_BRIDGE_ROOT_DIR: "/data/git-bridge" user: root command: ["/server-pro-start.sh"]
3
sharelatex 컨테이너 구성 업데이트
또한 sharelatex 컨테이너에 git-bridge 컨테이너를 연결하고 다음 환경 변수를 정의해야 합니다. V1_HISTORY_URL에 특히 주의하세요.
docker-compose.yml (sharelatex service)
sharelatex: links: - git-bridge environment: GIT_BRIDGE_ENABLED: true GIT_BRIDGE_HOST: "git-bridge" GIT_BRIDGE_PORT: "8000" # We use v1 now, if you used to set V1_HISTORY_URL, please update now V1_HISTORY_URL: "http://sharelatex:3100/api"
4
인증
git 클라이언트를 인증할 때 사용자에게는 개인 액세스 토큰(Personal Access Token)이 필요합니다. 사용자는 애플리케이션 UI에서 개인 액세스 토큰을 관리할 수 있습니다(문서 참조).
Git 연동 개인 액세스 토큰
5
모니터링 및 리소스 고려 사항
git-bridge를 활성화한 후에는 호스트 리소스를 모니터링하는 것을 권장합니다. 부하 증가 정도는 다음에 따라 달라집니다.
Git 연동은 사용자가 클론한 각 프로젝트마다 전체 git 저장소를 디스크에 저장합니다. 디스크 공간이 제한적인 경우, 자주 사용하지 않는 저장소를 AWS S3로 옮기는 스왑 작업을 활성화할 수 있습니다. 스왑된 저장소가 다시 필요해지면 디스크로 다시 옮겨집니다. 스왑 작업은 다음 환경 변수로 제어합니다.
이름
설명
GIT_BRIDGE_SWAPSTORE_TYPE
스왑 작업을 활성화하려면 “s3”로 설정합니다.
GIT_BRIDGE_SWAPSTORE_AWS_ACCESS_KEY
AWS 액세스 키
GIT_BRIDGE_SWAPSTORE_AWS_SECRET
AWS 시크릿
GIT_BRIDGE_SWAPSTORE_S3_BUCKET_NAME
압축된 git 저장소가 저장될 버킷
GIT_BRIDGE_SWAPSTORE_AWS_REGION
버킷의 리전
GIT_BRIDGE_SWAPJOB_MIN_PROJECTS
디스크에 최소한으로 유지할 프로젝트 수입니다.
- 기본값: 50
GIT_BRIDGE_SWAPJOB_LOW_GIB
스왑의 하한 임계값입니다. 스왑 작업은 디스크 사용량이 이 값보다 낮아질 때까지 프로젝트를 옮깁니다.
