Framework项目持续集成及集合SonarQube - 前言

本文主要记录在windows平台部署 jenkins 服务和 sonar 服务,然后实现持续集成和代码质量管理的一套服务。

jenkins是一款开源的提供友好操作界面的持续集成交付工具,主要用于持续构建、测试、发布软件项目。且能通过邮件、钉钉等通知最终构建结果,支持常用版本控制工具GIT/SVN。

sonarqube是一款开源的提供友好操作界面的代码质量管理工具。通过插件机制,Sonar 可以集成不同的测试工具,代码分析工具,以及持续集成工具。

而两者结合起来使用,大概步骤就是 代码提交 - sonar质量监控 - jenkins集成部署 - 测试 - 生产使用

jenkins_sonarqube

CI/CD是什么 -- jenkins

CI的英文名称是Continuous Integration,中文翻译为:持续集成。

CD可对应多个英文名称,持续交付Continuous Delivery和持续部署Continuous Deployment

主要是将代码分成几个环境来管理,如 开发环境 - 测试环境 - 生产环境 ,一般来说,在开发人员代码提交后,(尽快的进行代码质量检测 - sonar),马上使用jenkins进行构建、单元测试。根据测试结果判断是否发布测试环境,跑自动化测试流程或者人工测试相关功能,进行回归测试,检查正确性和稳定性等。然后再集成到生产环境 的工作模式。

jenkins

什么是sonarqube?什么是CodeReview?

什么是sonarqube?

Sonar (SonarQube)是一个开源平台,用于管理源代码的质量。 Sonar 不只是一个质量数据报告工具,更是代码质量管理平台。支持多种语言的代码质量管理与检测

SonarQube®是一种自动代码审查工具,用于检测代码中的错误,漏洞和代码异味。可以与jenkins集成,或手动执行,以便在项目分支和拉取请求之间进行连续的代码检查

检测结果存储于数据库,支持多种数据库(新版不再支持mysql),然后通过UI展示出来结果

什么是CodeReview?为什么要这样做?

CodeReview简单来说就是由有经验、对业务熟悉的老前辈进行检查代码,查看代码漏洞的的一种流程。从而提高项目健壮性,减少错误及使代码简洁易懂。

通常情况下,由于项目开发进度太赶,没时间进行代码审查,从而导致出现一些低级错误,这样会导致用户体验很差,进而可能流失客户。而为了提高开发速度及效率,还要保证代码质量,就可以使用sonar来自动检测,然后检测完成后在网页上查看检测结果,再进行修复。虽不能从业务上来保证正确性,但能通过这种途径减少代码上的直接错误。

工具安装

要使用这一套环境,得先安装好JDK,本文记录使用的都是最新版的工具,因此请安装 JDK 11来保证服务可用。且配置好环境变量。

jenkins安装

可从官网 https://www.jenkins.io/download/ 上下载相应的安装包,或war包,对应去操作使用,可能下载会比较慢,文末有提供安装包版本 2.253。

双击运行安装包,安装时会让你进行选择使用端口号,安装完成后,不要着急去访问服务,先将插件源给替换掉,以保证光速下载推荐插件。

更换插件源

配置地址:C:\Windows\System32\config\systemprofile\AppData\Local\Jenkins.jenkins 我的是这个,提供参考

或者修改 hudson.model.UpdateCenter 中的地址

https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

然后修改updates 文件夹中的 default.json 文件

修改后到服务中重启jenkins服务。 或者docker restart jenkins 重新启动服务 修改完,有时候会被重置回去,发现下载插件很慢的时候,就检查下,重新替换吧

jenkins初始化及插件安装

这里就不配图了,毕竟都是简单的操作步骤。

  1. 打开 localhost:端口 地址,复制本地地址到地址栏获取密码并填写

  2. 点击第一个安装推荐插件后,开始安装推荐的插件。这时候你会感受到光速下载插件。

  3. 安装完成后,点击继续,创建一个新的管理员账户

  4. 点击完成,相当于jenkins服务就安装完成了。

msbuild 和 nuget下载

文末有提供相关工具

msbuild工具,下载地址:https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools&rel=16

nuget下载地址:https://www.nuget.org/downloads

插件安装

点击左边Manage Jenkins按钮,在plugin中安装如下插件,除推荐插件外,

  • Publish Over SSH

  • DingTalk

  • SonarQube Scanner

  • push over ssh

  • MSBuild

插件配置

点击左边Manage Jenkins按钮,点击 Configure System

集成sonarqube,配置这里的token,添加时选secret text,需要在下面安装的sonar服务中获取,相关截图如下

sonar_配置

钉钉通知的配置

钉钉_配置

push over ssh的配置,由于windows不支持ssh,可自行安装相关软件来支持,这里使用的是PowerShellServer2020。在文末中有提供

ssh_配置

Extended E-mail Notification 邮件通知配置,自行网上查找jenkins 邮件通知 会有很多的。

点击左边Manage Jenkins按钮,点击 Global Tool Configuration

配置好jdk和git,服务器得准备git环境

jdk和git_配置

再把framework生成 和 扫描插件配置好

msbuild_配置

sonarqube安装

服务器要求只要要2核4G,不然可能会安装不成功。

在SonarQube的下载页面:https://www.sonarqube.org/downloads/,下载需要的版本。下载完成后,解压后可直接使用,**文末有提供安装包和相关需要使用到的工具。**

需要使用到的目录或文件就是

  • bin目录下 对应平台 的StartSonar.bat

  • conf,配置文件

  • extensions\jdbc-driver\oracle 用于放置连接数据库工具

  • logs 日志文件目录,错误时查看错误的地方

  • web UI文件夹目录

数据库创建及处理

先在SqlServer数据中新建对应数据库 Sonar,然后做相应修改

-- 查看排序策略
SELECT name, collation_name  
FROM sys.databases  
WHERE name = N'Sonar';
-- 更改排序策略
ALTER DATABASE Sonar  
COLLATE Chinese_PRC_CS_AS ; 

--***锁 无法更改  查询连接用户 
select spid
from master.dbo.sysprocesses
where dbid=db_id('Sonar')
-- 杀死连接进程
kill 53

-- 排序规则必须区分大小写(CS)和区分重音(AS)。
-- READ_COMMITED_SNAPSHOT 必须在SonarQube数据库上设置。
SELECT is_read_committed_snapshot_on FROM sys.databases WHERE name='Sonar';

ALTER DATABASE Sonar SET READ_COMMITTED_SNAPSHOT ON WITH ROLLBACK IMMEDIATE;

-- 开启了区分大小写后 注意数据库名称等的大小写

上面两个数据库调整是必须的。

官方文档地址:https://docs.sonarqube.org/latest/setup/install-server/

再创建相关的用户,并设置密码。

需要使用到的插件准备

当然这里也需要jdk 11,需要先行安装。

msbuild扫描插件下载地址:https://docs.sonarqube.org/latest/analysis/scan/sonarscanner-for-msbuild/

Microsoft SQL JDBC驱动程序下载地址:https://www.microsoft.com/en-us/download/details.aspx?id=57782 下载完成后,将下载的exe放到extensions\jdbc-driver\oracle下。

配置文件更改

conf下的sonar.properties文件,由于这里使用的sqlserver,因此这里是对SqlServer做的调整,

# 数据库
sonar.jdbc.username=sonar
sonar.jdbc.password=123456
sonar.jdbc.url=jdbc:sqlserver://IP:端口;databaseName=Sonar

# web端口
sonar.web.port=9000

若系统中有多个jdk版本,则修改wrapper.conf

wrapper.java.command=C:\Program Files\Java\jdk-11.0.8\bin\java

然后运行 C:\DevOps\sonarqube-8.4.1.35646\bin\windows-x86-64\StartSonar.bat ,会自动生成数据库表文件,运行成功后,访问http://localhost:9000

可在 administration -- Market 然后搜索Chinese 安装,安装完成后需要重启服务,界面上也会出现重启按钮。

需要将这两个配置打开

sonarconfig1

sonarconfig2

jenkins 集成 sonarqube

在前面的服务启动后,相关配置配置好,新建项目流程

在jenkins服务中,点击 new item,输入一个项目名字,然后选择Freestyle project

相关操作步骤截图

项目描述及构建日志处理

jenkins_project1

配置git服务,及设置每30分钟轮询,当轮询到有新代码提交时就进行构建。

jenkins_project2

设置构建环境,构建前删除,和构建日志输出时间,及构建时,先进行还原项目

jenkins_project3

设置构建扫描,和项目构建环境

jenkins_project4

构建完成后,通过SSH推送到服务器,推送完成后,会执行 Exec command中的命令,一般都是通过某个命令将上传的文件移动覆盖发布的文件。

命令大致就是xcopy /s C:\jenkins\"PowerShell Server 2020"\sftproot\demo_new\* C:\product\Web /Y。前面的是PowerShellServer2020的sftproot安装/上传路径,后面的是发布文件路径

可在高级设置中,设置忽略文件。格式如 **/Web*.config,**/Release/assets/,images/

jenkins_project5

项目截图。

jenkins_project6

这是扫描一个大项目的结果,有一些问题,项目越大,扫描时间也会越长哦

sonar_result

特别说明。如果出现构建失败,提示msbuild找不到项目文件的话,可以尝试把jenkins的配置文件config.xml中的工作路径给修改下,把目录放到外层试试。

我这里改成了这个,就正常工作了。<workspaceDir>C:/DevOps/workspace/${ITEM_FULL_NAME}</workspaceDir>

docker中安装相关服务 yml

由于本项目是framework,在linux中没法生成。所以这个就没做后文了,

拉取相关镜像后,在yml所在文件目录,执行命令启动服务

服务器安装Docker-Compose太慢,可以通过本地安装好后,上传服务器。

Docker-Compose简介安装使用

version: '3'
services: 
  postgres:    
    image: postgres  
    restart: always
    container_name: postgres
    ports:
      - 5432:5432
    volumes:
      - /data/postgres/postgresql/:/var/lib/postgresql
      - /data/postgres/data/:/var/lib/postgresql/data
    environment:
      TZ: Asia/Shanghai    
      POSTGRES_USER: sonar   
      POSTGRES_PASSWORD: sonar
      POSTGRES_DB: sonar
    networks: 
      - sonar-network
  sonar:
    image: sonarqube
    restart: always 
    container_name: sonarqube
    depends_on:
      - postgres
    volumes:
      - /data/sonarqube/extensions:/opt/sonarqube/extensions
      - /data/sonarqube/logs:/opt/sonarqube/logs
      - /data/sonarqube/data:/opt/sonarqube/data
      - /data/sonarqube/conf:/opt/sonarqube/conf
    ports:
      - 9000:9000
    environment:
      SONARQUBE.JDBC.USERNAME: sonar
      SONARQUBE.JDBC.PASSWORD: sonar
      SONARQUBE.JDBC.URL: jdbc:postgresql://postgres:5432/sonar
    networks: 
      - sonar-network
networks:
  sonar-network:
    driver: bridge

配置解释:

version: '3': 表示使用第三代语法来构建 docker-compose.yaml 文件。

services: 用来表示 compose 需要启动的服务,上面的配置文件中服务分别为:sonar、mysql

Image:指定下载镜像版本

container_name: 指定容器名称

environment: 此节点下的信息会当作环境变量传入容器,例如mysql 服务配置了数据库、密码和权限信息。

ports: 表示对外开放的端口

volumes: 加载本地目录下的配置文件到容器目标地址下

restart: always 表示如果服务启动不成功会一直尝试。

depends_on:配置依赖服务,表示需要先启动 depends_on 下面的服务后,再启动本服务。

links:与depends_on相对应,depends_on控制启动顺序,links控制容器连接问题。值为"服务名:别名"或者直接使用服务名

command: 执行内部命令

networks:加入指定网络,用同一个网络。

相关工具包

链接: https://pan.baidu.com/s/13fJS4rDQTmi1fsy1HVrdxQ 提取码: cd41

若对您有帮助的话,可以在下面打赏一下哦~

Copyright © levywang123@gmail.com 2020 all right reserved,powered by Gitbook该文章修订时间: 2020-08-31 14:36:19

results matching ""

    No results matching ""