"SonarQube is under maintenance" 메시지

문제 요약

SonarQube Community 도커 이미지를 사용 중이며, 서버 접속 시 "SonarQube is under maintenance" 메시지가 반복적으로 표시되고 있습니다. VSCode SonarQube 확장도 설치되어 있지만, 연결을 시도해도 동일한 메시지가 나옵니다.

원인

이 메시지는 SonarQube 서버가 현재 "유지보수 모드(maintenance mode)"에 있다는 의미로, 주로 데이터베이스(DB) 마이그레이션 또는 업그레이드가 필요할 때 나타납니다. SonarQube의 버전을 업그레이드했거나, DB가 새로 세팅된 경우에 자주 발생합니다^[1][2].

해결 방법

1. 데이터베이스 업그레이드 수행

• 웹브라우저에서 SonarQube 서버 주소 뒤에 /setup을 붙여 접속합니다.
  • 예시: http://<sonarqube-server>:9000/setup
• "Upgrade" 또는 "DB 업그레이드" 버튼이 나타나면 클릭합니다.
• 업그레이드가 정상적으로 완료되면 SonarQube가 maintenance mode에서 벗어나 정상적으로 동작합니다^[1:1][2:1].

2. 업그레이드 진행 중 오류 발생 시

• 만약 /setup에서 에러가 발생한다면, 도커 컨테이너의 로그(sonarqube와 DB 컨테이너 모두)를 확인해야 합니다.
• 로그에서 마이그레이션 실패 원인을 찾아 조치해야 하며, DB 백업이 있다면 복구 후 재시도할 수 있습니다^[2:2].

3. 기타 점검 사항

• SonarQube와 DB 컨테이너가 모두 정상적으로 실행 중인지 확인합니다.
• DB 연결 정보(환경변수, 네트워크 등)가 올바른지 점검합니다.
• 도커 이미지와 볼륨이 올바르게 마운트되어 있는지 확인합니다.

VSCode 확장과의 관계

• VSCode의 SonarQube 확장은 서버가 정상적으로 동작할 때만 제대로 연결됩니다.
• 서버가 maintenance mode에 있으면 확장도 정상적으로 기능하지 않습니다^[3][4][5].
• 서버가 정상화된 후, VSCode 확장에서 다시 연결을 시도하면 됩니다.

요약

• "SonarQube is under maintenance" 메시지는 DB 업그레이드가 필요함을 의미합니다.
• SonarQube 서버 주소에 /setup을 붙여 접속해서 DB 업그레이드를 진행하세요.
• 업그레이드 후에도 문제가 지속된다면, 도커 로그를 확인해 추가적인 에러를 점검해야 합니다.
• 서버가 정상화되면 VSCode 확장도 정상적으로 연동됩니다^[1:2][2:3].

"Make sure you have a DB backup available. Go to http://localhost:9000/setup (if you have hosted it specifically, then it should be {URL_of_your_sonarqube}/setup). There will be a button to upgrade DB, click on that and you should be fine." ^[1:3]

추가로 궁금한 점이나 로그 분석이 필요하다면, 구체적인 에러 메시지나 로그 내용을 추가로 제공해주시면 더 도움을 드릴 수 있습니다.

⁂

1. https://community.sonarsource.com/t/sonarqube-is-under-maintenance/79698 ↩︎ ↩︎ ↩︎ ↩︎
2. https://github.com/marcelbirkner/docker-ci-tool-stack/issues/59 ↩︎ ↩︎ ↩︎ ↩︎
3. https://docs.sonarsource.com/sonarqube-for-ide/vs-code/using/fixing-issues/ ↩︎
4. https://www.sonarsource.com/learn/sq-ide-extension-for-vscode/ ↩︎
5. https://www.sonarsource.com/learn/sq-ide-plug-in-for-vscode/ ↩︎