Tandoor Recipes는 유지 관리되는 BigBearCasaOS 스토어에서 계속 제공되며, 현재 패키지는 이전 2024년 튜토리얼 상태가 아니라 업스트림 Tandoor 컨테이너를 사용합니다. 현재 BigBear에는 ghcr.io/tandoorrecipes/recipes를 사용하는 Tandoor 2.6.9가 등록되어 있습니다.
안정적으로 배포하려면 Postgres 데이터베이스와 미디어/구성 데이터를 보호하고, 실제 시크릿 키와 허용 호스트를 설정하세요. Tandoor 데이터베이스 마이그레이션은 간단히 다운그레이드할 수 없으므로 업그레이드하기 전에 업스트림 릴리스 노트를 확인해야 합니다.
현재 BigBear 패키지 사용
유지 관리되는 BigBearCasaOS 앱 스토어에는 현재 Tandoor 패키지가 등록되어 있으며, 2024년 영상만 참고하는 것보다 더 신뢰할 수 있는 정보원입니다.
Tandoor는 공식적으로 Docker Compose를 권장합니다
현재 Tandoor Docker 가이드에서는 Docker/Compose를 공식적으로 유지 관리되고 정기적으로 테스트되는 설치 방법이라고 설명합니다.
데이터베이스 보호
프로덕션 환경의 Tandoor는 권장 Compose 스택에서 PostgreSQL을 사용합니다. 데이터베이스 볼륨을 영구 저장소에 보관하고 업그레이드 전에 백업하세요.
레시피 미디어 보호
레시피 이미지와 업로드된 미디어는 데이터의 일부입니다. CasaOS 매니페스트가 영구 미디어/정적 경로를 매핑하는지 확인하세요. 데이터가 일시적인 컨테이너 파일 시스템 안에만 저장되어서는 안 됩니다.
강력한 시크릿 설정
업스트림에서는 SECRET_KEY, POSTGRES_PASSWORD, ALLOWED_HOSTS와 같은 값을 요구합니다. 동영상 튜토리얼의 예시 비밀번호를 그대로 사용하지 마세요.
Tandoor 2에서 컨테이너 구성이 변경되었습니다
Tandoor 2에는 웹 컨테이너 내부에 nginx가 포함되어 있으며 내부적으로 포트 80을 노출합니다. 따라서 Tandoor 1의 gunicorn/미디어 구성을 설명하는 이전 튜토리얼은 혼동을 줄 수 있습니다.
먼저 백업한 후 업데이트
업스트림에서 안내하는 현재 업데이트 절차는 다음과 같습니다.
docker compose down
docker compose pull
docker compose up -d단, 먼저 릴리스 노트를 확인하세요. Tandoor는 마이그레이션이 적용된 후 지원되는 데이터베이스 다운그레이드 경로가 없다고 경고합니다.
원격 가족 접속에는 HTTPS 사용
레시피에 LAN 외부에서 접근해야 한다면 원시 애플리케이션 포트를 포워딩하는 대신, 인증된 HTTPS 또는 비공개 원격 액세스 방식으로 Tandoor를 보호하세요.
Docker 배포 가이드는 CasaOS의 사용자 지정/커뮤니티 앱에도 적용됩니다.
레시피를 가져오기 전에 첫 실행을 확인하세요
처음 실행할 때 데이터베이스 마이그레이션이 완료될 때까지 기다리고, UI가 나타나지 않으면 웹 컨테이너와 Postgres 로그를 확인하세요. 마이그레이션이 진행 중인 동안 컨테이너를 반복해서 다시 만들지 마세요.
전용 호스트 포트 사용
Tandoor 2는 웹 컨테이너에 포함된 nginx를 통해 HTTP를 제공합니다. CasaOS나 다른 앱이 선택한 호스트 포트를 이미 사용 중이라면 Tandoor의 내부 포트를 수정하지 말고 호스트 측 매핑만 변경하세요.
두 번째 복구 경로로 레시피 내보내기
데이터베이스 백업이 기본 복구 방법이지만, 정기적으로 레시피를 내보내면 애플리케이션 데이터베이스가 손상된 경우 콘텐츠를 복구할 수 있는 또 다른 방법이 됩니다. 내보낸 파일은 동일한 컨테이너 스택 외부에 보관하세요.
자주 묻는 질문
Tandoor는 아직 BigBearCasaOS에 있나요?
예. 현재 저장소에는 Tandoor 2.6.9가 등록되어 있습니다.
Tandoor는 어떤 데이터베이스를 사용해야 하나요?
공식 Compose 설정에서는 PostgreSQL을 사용합니다.
새 이미지를 가져와서 업데이트할 수 있나요?
예. 하지만 먼저 백업하고 릴리스 노트를 확인하세요. 데이터베이스 마이그레이션은 되돌릴 수 없을 수 있습니다.
리버스 프록시가 필요한가요?
LAN에서만 사용할 때는 필요하지 않지만, 원격 액세스에는 HTTPS와 프록시 사용을 권장합니다.
