버그 추적을 위한 오픈소스 도구 Bugsink 설치 및 사용 가이드

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

앱 개발

대상자

• 개발자 (중간 수준 이상, Docker 및 MySQL 사용 경험 필요)
• 난이도 : 중간 (Docker 설정, 환경 변수 구성, Sentry SDK 통합 필요)

핵심 요약

• Bugsink 설치: Docker와 MySQL을 사용해 Sliplane 플랫폼에서 인스턴스 생성
• 환경 변수 구성: SECRET_KEY, DATABASE_URL, CREATE_SUPERUSER, BASE_URL 등 필수 설정
• Sentry SDK 통합: DSN과 authToken을 통해 앱에 오류 수집 기능 추가

섹션별 세부 요약

1. Bugsink 인스턴스 생성

• Sliplane 계정 생성 후 "Bugsink" 프로젝트 생성
• MySQL 서버 배포: 기본 서버 타입 선택, 데이터베이스 이름을 bugsink로 설정
• 환경 변수 설정: DATABASE_URL에 MySQL 연결 정보 입력, CREATE_SUPERUSER로 관리자 계정 생성

2. Bugsink 앱 배포

• Docker 이미지 선택: 공식 bugsink 이미지 사용, 버전 고정 권장
• 환경 변수 입력: SECRET_KEY는 50자 이상의 대소문자/숫자 조합, BASE_URL은 Sliplane 앱 설정에서 확인
• 배포 완료 후: "Public Domain" 주소로 앱 접속 후 관리자 계정 로그인

3. 앱과의 연동 (Sentry SDK)

• Team 및 Project 생성: Bugsink에서 팀/프로젝트 생성 후 설치 지시서 확인
• DSN 구성: org, project, authToken, url 설정 (url은 https://[sliplane 도메인])
• Sentry SDK 통합: 선택한 프레임워크에 맞춰 SDK 설치, DSN과 release 버전 설정

결론

• Bugsink 설치 시 버전 고정(pinned version)을 권장해 의도치 않은 업데이트 방지
• BASE_URL 및 authToken은 반드시 실제 값으로 대체
• 테스트를 위해 throw new Error('Test')와 같은 코드 삽입 후 오류 수집 확인