SonarQube と MySQL 5.5 (MariaDB)： CentOS 7 でのセットアップとトラブルシューティング
CentOS 7 における SonarQube のセットアップ：MySQL 5.5 (MariaDB) での失敗と解決策
このチュートリアルでは、CentOS 7 に SonarQube をインストールして MySQL 5.5 (MariaDB) を使用する際に発生する起動エラーと、その解決策について説明します。
エラー内容
SonarQube の起動時に以下のエラーが発生することがあります。
Unsupported mysql version: 5.5. Minimal supported version is 5.6.
このエラーは、SonarQube が MySQL 5.6 以降のみをサポートしており、5.5 では動作しないことを示しています。
解決策
この問題を解決するには、以下の 2 つの方法があります。
MySQL 5.6 以降にアップグレードする
SonarQube を動作させるには、MySQL 5.6 以降が必要です。そのため、既存の MySQL 5.5 を 5.6 以降にアップグレードする必要があります。
アップグレード手順
MySQL 5.5 を 5.6 以降にアップグレードするには、以下の手順に従ってください。
- MySQL 公式リポジトリを追加します。
sudo yum install https://repo.mysql.com/yum/mysql-rep.rpm
- MySQL 5.6 をインストールします。
sudo yum install mysql-server
- MySQL サービスを起動します。
sudo systemctl start mysqld
- MySQL セキュリティスクリプトを実行して、初期設定を行います。
sudo mysql_secure_installation
- SonarQube を再起動します。
sudo systemctl restart sonar
SonarQube 設定ファイルを変更して MySQL バージョンを偽装する
MySQL 5.6 以降へのアップグレードが難しい場合は、SonarQube 設定ファイルを変更して MySQL バージョンを偽装することができます。これは、非推奨の方法であり、将来的な SonarQube のアップグレード時に問題が発生する可能性があることに注意してください。
設定ファイルの変更手順
- SonarQube 設定ファイルを開きます。
sudo nano /opt/sonarqube/conf/sonar.properties
sonar.jdbc.urlプロパティの値を以下のように変更します。
sonar.jdbc.url=jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&useSSL=false
sudo systemctl restart sonar
注意事項
- 上記の方法は、あくまでも 臨時的な解決策 です。将来的には、MySQL 5.6 以降にアップグレードすることを強く推奨します。
- SonarQube 設定ファイルを変更する場合は、必ずバックアップを取ってから行ってください。
- MySQL 5.5 を使用し続ける場合、SonarQube で予期せぬ動作が発生する可能性があることに注意してください。
SonarQube を CentOS 7 に MySQL 5.5 (MariaDB) でインストールする場合、MySQL 5.6 以降にアップグレードすることが最善の方法です。アップグレードが難しい場合は、SonarQube 設定ファイルを変更して MySQL バージョンを偽装することができますが、これは非推奨の方法であり、将来的な問題を引き起こす可能性があることに注意する必要があります。
Create a MySQL database for SonarQube
sudo mysql -u root -p
mysql> CREATE DATABASE sonar CHARACTER SET utf8 COLLATE utf8_general_ci;
mysql> CREATE USER 'sonar'@'localhost' IDENTIFIED BY 'sonar';
mysql> GRANT ALL PRIVILEGES ON sonar.* TO 'sonar'@'localhost';
mysql> FLUSH PRIVILEGES;
mysql> exit;
Download and extract SonarQube
wget https://binaries.sonarsource.com/distribution/sonarqube/sonarqube-9.1.0.zip
unzip sonarQube-9.1.0.zip
mv sonarQube-9.1.0 sonar
Edit the SonarQube configuration file
nano sonar/conf/sonar.properties
Find the following lines and change the values as needed:
sonar.jdbc.url=jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&useSSL=false
sonar.jdbc.username=sonar
sonar.jdbc.password=sonar
Start SonarQube
./sonar/bin/linux-x86_64/sonar.sh start
SonarQube should be available at http://localhost:9000. You can log in using the username admin and the password you set in the configuration file.
Additional notes:
- Make sure you have Java 8 installed.
- You may need to adjust the firewall settings to allow SonarQube to access the internet.
I hope this helps!
CentOS 7 における SonarQube のセットアップ：MySQL 5.5 (MariaDB) でのその他の解決策
MySQL 5.7 を使用して互換性モードを有効にする
MySQL 5.7 は、MySQL 5.6 との互換性モードを備えています。このモードを有効にすることで、SonarQube は MySQL 5.5 を 5.6 として認識し、正常に動作する可能性があります。
sudo yum install mysql-server-5.7
- MySQL 設定ファイルを編集します。
sudo nano /etc/my.cnf
- 以下の行を追加します。
[mysqld]
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_AUTO_CREATE_USER
sudo systemctl restart mysqld
sudo systemctl restart sonar
Docker を使用して SonarQube を実行すると、オペレーティングシステムのバージョンや MySQL のバージョンに関係なく、SonarQube を簡単にインストールして実行することができます。
Docker を使用して SonarQube を実行する手順
- Docker をインストールします。
sudo yum install docker
- SonarQube Docker イメージをプルします。
docker pull sonarqube:latest
docker run -d -p 9000:9000 -v /path/to/data:/opt/sonarqube/data sonarqube:latest
- Web ブラウザで http://localhost:9000 にアクセスして、SonarQube にアクセスします。
SonarQube 6.7 以前は、MySQL 5.5 をサポートしています。ただし、SonarQube 6.7 はすでにサポート終了しており、セキュリティ上の脆弱性がある可能性があることに注意してください。
SonarQube 6.7 以前をインストールする手順
- SonarQube 6.7 以前のバイナリをダウンロードします。
wget https://binaries.sonarsource.com/distribution/sonarqube/sonarqube-6.7.10.zip
unzip sonarQube-6.7.10.zip
mv sonarQube-6.7.10 sonar
nano sonar/conf/sonar.properties
sonar.jdbc.url=jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&useSSL=false
sonar.jdbc.username=sonar
sonar.jdbc.password=sonar
./sonar/bin/linux-x86_64/sonar.sh start
- Docker を使用して SonarQube を実行する場合は、SonarQube の公式ドキュメントにある指示に従ってください。
- SonarQube 6.7 以前を使用する場合は、セキュリティ上の脆弱性がある可能性があることに注意してください。
mysql jdbc sonarqube
