蓝易云cdn:sonarqube在cr服务器上如何重启

SonarQube 在CR服务器上的重启方法 🔧

在日常运维中，SonarQube 可能因配置变更、插件更新、内存溢出等原因需要执行<font color="red">重启操作</font>。以下是在CR（云服务器）环境下，针对不同部署方式的完整重启方案。

📌 重启前必做：状态确认

在执行重启之前，务必先确认当前 SonarQube 的<font color="red">运行状态</font>，避免盲目操作：

systemctl status sonarqube

这条命令会返回 SonarQube 服务当前的运行状态，包括是否处于 active（运行中）、inactive（已停止）或 failed（异常退出）。只有确认了当前状态，才能选择正确的重启策略。

🔄 重启方式对照表

一、systemd 方式重启（最常见）🖥️

大多数 CR 服务器上，SonarQube 以 systemd 服务形式运行，执行以下命令即可：

sudo systemctl restart sonarqube

这条命令的作用是先向 SonarQube 进程发送停止信号，等待其安全关闭后再重新启动。sudo 表示以管理员权限执行，因为<font color="red">服务管理操作需要 root 权限</font>。

如果需要分步操作（先停后起），可以拆分为：

sudo systemctl stop sonarqube
sudo systemctl start sonarqube

stop 命令会优雅地终止服务进程，start 命令则根据 systemd 配置文件中定义的参数重新拉起服务。分步操作的好处是可以在两步之间检查日志或修改配置。

确认重启是否成功：

sudo systemctl status sonarqube

返回结果中出现 Active: active (running) 字样即代表服务已正常运行。

二、手动安装方式重启 📁

如果 SonarQube 是通过<font color="red">解压安装包</font>方式部署的，使用自带的启停脚本：

cd /opt/sonarqube/bin/linux-x86-64/
./sonar.sh restart

第一行命令切换到 SonarQube 安装目录下的可执行脚本路径。linux-x86-64 是针对 64 位 Linux 系统的目录名，如果是其他架构需相应调整。第二行 ./sonar.sh restart 调用 SonarQube 自带的管理脚本执行重启，该脚本内部会依次完成停止和启动两个动作。

查看实时日志确认启动状态：

tail -f /opt/sonarqube/logs/sonar.log

tail -f 命令会持续输出日志文件的最新内容。当日志中出现 SonarQube is operational 这行信息时，说明<font color="red">重启已完成且服务可用</font>。

三、Docker 容器方式重启 🐳

容器化部署环境下的重启命令：

docker restart sonarqube

此命令向名为 sonarqube 的容器发送重启指令。Docker 会先发送 SIGTERM 信号给容器主进程，等待默认 10 秒后如果进程仍未退出，则发送 SIGKILL 强制终止，随后重新创建并启动容器。

如果使用 Docker Compose 编排：

docker-compose restart sonarqube

功能与上条命令类似，区别在于它会读取 docker-compose.yml 配置文件中的服务定义来执行操作，适合多容器协同部署的场景。

⚠️ 重启故障排查流程

graph TD
    A[执行重启命令] --> B{服务是否启动成功?}
    B -->|是| C[访问 9000 端口验证页面]
    C --> D{页面是否正常?}
    D -->|是| E[✅ 重启完成]
    D -->|否| F[检查 web.log 日志]
    B -->|否| G[检查 sonar.log 日志]
    G --> H{是否内存不足?}
    H -->|是| I[调整 JVM 参数 sonar.properties]
    H -->|否| J{是否端口冲突?}
    J -->|是| K[释放 9000 端口或修改配置]
    J -->|否| L[检查数据库连接与权限]
    I --> A
    K --> A
    L --> A
    F --> G

💡 实用排查命令速查

检查端口占用情况：

ss -tlnp | grep 9000

此命令列出所有监听中的 TCP 端口，并筛选 9000 端口（SonarQube 默认端口）。如果有其他进程占用了该端口，SonarQube 将无法启动。

检查 JVM 内存配置：

grep "sonar.web.javaOpts" /opt/sonarqube/conf/sonar.properties

该命令从配置文件中提取 Web 服务的 JVM 参数。建议<font color="red">堆内存至少设置为 -Xmx512m</font>，生产环境推荐 2G 以上，否则容易因 OOM 导致服务崩溃。

总结来说，CR 服务器上重启 SonarQube 的核心就是根据部署方式选择对应命令，重启后务必通过日志和端口两个维度确认服务状态。遇到启动失败时，优先排查<font color="red">内存、端口、数据库连接</font>这三个最常见的故障点即可 ✅