Skip to content

Latest commit

 

History

History
311 lines (219 loc) · 10.2 KB

sonar.md

File metadata and controls

311 lines (219 loc) · 10.2 KB

在CentOS 7中安装SonarQube

SonarQube®是一种自动代码审查工具，可检测代码中的错误，漏洞和代码味道。它可以与您现有的工作流程（例如Jenkins）集成，以实现跨项目分支和请求请求的连续代码检查。在此简短指南中，我们将安装此出色的开源工具，以便您有机会在团队中的代码进行生产之前对其进行检查。通过检测使用的过时软件并实时提出适当的建议，它将有助于简化您的应用程序并提高其安全性。

先决条件

SonarQube基于Java构建，因此我们将确保已安装Java 11。

另一个用户从根目录开始运行弹性搜索，因此运行SonarQubePostgreSQL的要在CentOS 7盒中安装此工具，请遵循以下共享的步骤：

步骤1：更新并安装所需的工具并完成系统设置

在此步骤中，请确保服务器已正确更新，并安装了安装过程中所需的所有工具。我们还将调整SELinux，max_map_count和fs.file-max之类的系统设置。运行以下命令以更新服务器。

sudo yum update sudo yum install vim wget curl -y 将SELinux配置为允许 这可以通过运行以下命令来完成：

sudo setenforce 0 sudo sed -i 's/^SELINUX=enforcing$/SELINUX=permissive/' /etc/selinux/config 调整max_map_count和fs.file-max 从Linux Kernel Documentation开始，此文件包含一个进程可能具有的最大内存映射区域数。内存映射区域直接由mmap，mprotect和madvise用作调用malloc的副作用，并且在加载共享库时也是如此。

要调整设置以符合SonarQube的要求，请打开“ /etc/sysctl.conf ”文件并添加设置，如下所示：

$ sudo vim /etc/sysctl.conf
vm.max_map_count=262144
fs.file-max=65536

创建一个Sonar用户 建议创建一个单独的用户来运行SonarQube。让我们创建一个如下：

sudo useradd sonar

为用户设置密码

sudo passwd sonar

步骤2：在CentOS 7上安装Java 11

SonarQube用Java编写，并且需要安装Java

在CentOS 7上安装Java 11 (略)

步骤3：安装和配置PostgreSQL

在本示例指南中，我们将在SonarQube将驻留的同一服务器上安装PostgreSQL 11服务器。您可以根据需要将其托管在其他服务器上。要在CentOS 7服务器上安装PostgreSQL 11，请按照以下步骤安装并快速运行

添加PostgreSQL Yum存储库 通过运行下面的共享命令，将PostgreSQL Yum Repository添加到您的CentOS 7系统。

sudo yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm

安装PostgreSQL服务器和客户端软件包 添加PostgreSQL Yum存储库后，安装PostgreSQL服务器/客户端软件包：

sudo yum -y install postgresql11-server postgresql11

安装后，初始化数据库并启用自动启动 现在已经安装了数据库软件包，通过运行以下命令来初始化数据库

sudo /usr/pgsql-11/bin/postgresql-11-setup initdb

然后启动并启用服务以在启动时启动

sudo systemctl start postgresql-11
sudo systemctl enable postgresql-11

安装PostgreSQL服务器后，请按照以下步骤进行配置。打开pg_hba.conf文件，将“ peer ”更改为“ trust ”，将“ idnet ”更改为“ md5 ”。

$ sudo vim /var/lib/pgsql/11/data/pg_hba.conf

##Change this
local   all             all                                     peer
IPv4 local connections:
host    all             all             127.0.0.1/32            ident
IPv6 local connections:
host    all             all             ::1/128                 ident
Allow replication connections from localhost, by a user with the replication privilege.
local   replication     all                                     peer
host    replication     all             127.0.0.1/32            ident
host    replication     all             ::1/128                 ident

##To this:
local   all             all                                     trust
IPv4 local connections:
host    all             all             127.0.0.1/32            md5
IPv6 local connections:
host    all             all             ::1/128                 md5

Allow replication connections from localhost, by a user with the replication privilege.

local   replication     all                                     peer
host    replication     all             127.0.0.1/32            md5
host    replication     all             ::1/128                 md5

启用对PostgreSQL的远程访问 如果您的应用程序位于远程位置，那么您将需要允许它如下访问数据库：

编辑文件/var/lib/pgsql/11/data/postgresql.conf并将所有接口的监听地址设置为服务器IP地址或“ * ”。

$ sudo vim /var/lib/pgsql/11/data/postgresql.conf
listen_addresses = '10.38.87.160'

然后将以下内容添加到“ pg_hba.conf”文件中

$ sudo vim /var/lib/pgsql/11/data/pg_hba.conf

Accept from anywhere
host    all             all             0.0.0.0/0            md5
Or accept from trusted subnet
host    all             all             10.38.87.0/24        md5

重新启动PostgreSQL服务

sudo systemctl restart postgresql-11

设置PostgreSQL管理员用户 我们将需要更改admin postgres用户的密码，如下所示：

$ sudo su - postgres
-bash-4.2$
-bash-4.2$: psql 
postgres=# alter user postgres with password 'StrongPassword';
ALTER ROLE
postgres=#

创建SonarQube用户和数据库 接下来，我们将为SonarQube创建一个用户。退出数据库之前，请按照如下所示进行操作。

postgres=# createuser sonar;
postgres=# createdb sonar_db owner sonar;
postgres=# grant all privileges on database sonar_db to sonar;

为Sonar用户设置密码

postgres=# ALTER USER sonar WITH ENCRYPTED password 'StrongPassword';

步骤4：提取并安装SonarQube

下载SonarQube的长期版本，然后安装在我们的服务器中。请按照以下步骤进行操作安装

获取SonarQube LTS版本 您可以访问SonarQube下载页面以查看其各种产品。我们将下载长期版本（LTS）

SonarQube LTS页面 SonarQube下载页面

cd /opt/
sudo wget https://binaries.sonarsource.com/Distribution/sonarqube/sonarqube-7.9.5.zip

然后解压缩文件

sudo unzip sonarqube-7.9.5.zip

之后，将文件夹重命名为sonarqube

sudo mv sonarqube-7.9.5 sonarqube

步骤5：配置SonarQube

将文件提取到/ opt /目录后，就可以配置应用程序了。

打开“ /opt/sonarqube/conf/sonar.properties ”文件，并添加数据库详细信息，如下所示。除此之外，找到共享的行并取消注释。

$ sudo vim /opt/sonarqube/conf/sonar.properties

##Database details
sonar.jdbc.username=sonar
sonar.jdbc.password=StrongPassword
sonar.jdbc.url=jdbc:postgresql://localhost/sonar_db

##How you will access SonarQube Web UI
sonar.web.host=10.38.87.160
sonar.web.port=9000

##Java options
sonar.web.javaOpts=-server -Xms512m -Xmx512m -XX:+HeapDumpOnOutOfMemoryError
sonar.search.javaOpts=-server -Xms512m -Xmx512m -XX:+HeapDumpOnOutOfMemoryError

##Also add the following Elasticsearch storage paths
sonar.path.data=/var/sonarqube/data
sonar.path.temp=/var/sonarqube/temp

将SonarQube文件的所有权授予我们在步骤1中创建的Sonar用户。

sudo chown -R sonar:sonar /opt/sonarqube

如果无法在默认位置找到Java，则必须指定SonarQube的二进制文件才能找到。您可以在“ /opt/sonarqube/conf/wrapper.conf ”文件中指定java的位置。查找“ wrapper.java.command ”行，并将您的Java位置放置在它旁边。

$ sudo vim /opt/sonarqube/conf/wrapper.conf
wrapper.java.command=/usr/local/jdk-11.0.2/bin/java

添加SonarQube SystemD服务文件 最后，我们将确保能够通过Systemd管理SonarQube应用程序，以便像在服务器中的其他服务一样启动和停止它。

$ sudo vim /etc/systemd/system/sonarqube.service
[Unit]
Description=SonarQube service
After=syslog.target network.target

[Service]
Type=forking
ExecStart=/opt/sonarqube/bin/linux-x86-64/sonar.sh start
ExecStop=/opt/sonarqube/bin/linux-x86-64/sonar.sh stop
LimitNOFILE=65536
LimitNPROC=4096
User=sonar
Group=sonar
Restart=on-failure

[Install]
WantedBy=multi-user.target

编辑systemd文件后，我们必须重新加载它们，以便可以读取和加载它们。

sudo systemctl daemon-reload

然后启动并启用服务

sudo systemctl start sonarqube.service
sudo systemctl enable sonarqube.service

检查其状态是否成功启动并正在运行。

sudo systemctl status sonarqube.service

步骤6：更改防火墙规则以允许SonarQube访问

此时，应运行sonarqube服务。如果您无法访问Web界面，请访问位于“ / opt / sonarqube / logs ”中的日志文件，在该文件中您将找到

elasticsearch日志（es.log） Sonar日志（sonar.log） 网络日志（web.log） 访问日志（access.log） 和别的 我们使SonarQube Web能够侦听端口9000，并且应该在防火墙上对此进行允许。继续执行以下共享的操作

sudo firewall-cmd --permanent --add-port=9000/tcp && sudo firewall-cmd --reload

步骤7：访问Web用户界面 我们一直在等待的时间终于出现了。现在，我们准备访问SonarQube界面，并开始评估我们的代码的安全性。要访问该界面，请打开您喜欢的浏览器并将其指向http：// server-ip-or-fqdn：9000。您应该看到与以下页面相似的页面。

步骤8：登入

要登录，只需单击上面共享的“ Log In ”按钮，您将进入与下面共享的页面相似的页面。使用用户名作为“ admin ”，密码作为“ admin ”。

sonarqube登录页面 并且您应该被引导到主要区域，如下图所示

登录页面后的Sonar

现在，我们有了我们的自动代码检查工具，您可以使用它来扫描各种应用程序，然后再将其批准用于生产。它简单，全面，可满足您的组织安全需求。试试看。

thanks Kibet John --2021.3.1