docker-compose部署sonarqube及升级教程

1.docker-compose部署sonarqube

1.1创建扩展目录

mkdir -p /data/sonarqube/extensions/plugins

1.2 docker-compose配置文件

vim /data/sonarqube/docker-compose.yml

services:
  sonarqube:
   #image: sonarqube:10.6.0-developer
    image: sonarqube:2025.3.1-developer
    container_name: sonarqube
    ports:
      - "9000:9000"
    volumes:
      - /data/sonarqube/extensions/plugins:/opt/sonarqube/extensions/plugins
        #- /data/sonarqube/data:/data/sonarqube/data
        #- /data/sonarqube/temp:/data/sonarqube/temp
    environment:
      - SONAR_JDBC_URL=jdbc:postgresql://192.168.162.20/sonar?currentSchema=public
      - SONAR_JDBC_USERNAME=sonarqube
      - SONAR_JDBC_PASSWORD=Aa1234
    restart: always

1.3 下载汉化插件

https://github.com/xuhuisheng/sonar-l10n-zh
下载队友汉化插件jar上传到 /data/sonarqube/extensions/plugins

1.4 启动sonarqube

cd /data/sonarqube
docker-compose up -d

2 docker-compose部署的sonarqube升级版本

2.1 升级官方说明

https://docs.sonarsource.com/sonarqube-server/2025.1/server-upgrade-and-maintenance/upgrade/determine-path/
初始版本 目标版本 升级路径 上面的官方链接有说明,有些可以直接升级,有些不行,要操作两次升级
From version To version Upgrade path
9.9 LTA 2025.1 LTA 9.9 LTA > 2025.1 LTA (direct)
8.9 2025.1 LTA 8.9 LTA > 9.9 LTA > 2025.1 LTA (one intermediate step)
2025.1 LTA 2025.3 2025.1 LTA > 2025.3 (direct)
10.6 2025.1 LTA 10.6 > 2025.1 LTA (direct)
10.6 2025.3 10.6 > 2025.1 LTA > 2025.3 (one intermediate step)

2.2 升级举例说明

我原来是10.6.0-developer要升级2025.3.1-developer
需要先升级到2025.1.3-developer再升级到2025.3.1-developer

2.3升级操作

2.3.1 数据库备份

停止服务

cd /data/sonarqube
docker-compose down

postgresql备份数据库sonar

PGPASSWORD=Aa1234 pg_dump -h 192.168.162.20 -U sonarqube -d sonar -F p | gzip > sonar_backup_$(date +%F).sql.gz

还原示例

createdb -h 192.168.162.20 -U sonarqube sonar
PGPASSWORD=Aa1234 psql -h 192.168.162.20 -U sonarqube -d sonar -f sonar_backup.sql

2.3.2 升级到2025.1.3-developer

改docker-compose.yml

image: sonarqube:2025.1.3-developer

启动

cd /data/sonarqube
docker-compose up -d

升级数据库

示例服务器ip 192.168.162.20
访问http://192.168.162.20/setup
按照指引升级数据库,完成后会自动启动
查看日志

docker logs -f sonarqube

2.3.2 最后升级到目标版本2025.3.1-developer

cd /data/sonarqube
docker-compose down

再重复一次上一步的修改版本>>启动>>升级数据库>>正常启动2025.3.1

本机安装包部署升级教程

参考另一篇文章
sonarqube跨大版本升级教程(9.5>9.9.6>10.6)