Linux中Jenkins的自动部署

水深无声 2022-04-22 15:00 383阅读 0赞

**一、安装**

1、添加yum repos，然后安装

wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat/jenkins.repo
    rpm --import https://pkg.jenkins.io/redhat/jenkins.io.key

注：如果上面两行执行成功、就不用执行下面的命令了

wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/RedHat/jenkins.repo
    rpm --import https://jenkins-ci.org/redhat/jenkins-ci.org.key

注：网络不好就多试几次、rpm没有安装的话、安装一下在执行

yum install jenkins

2、如果未安装java还需安装java

yum install java

3、启动和停止

service jenkins start
    service jenkins stop
    service jenkins restart

**二、可能回会出现的问题**

1、错误一：

Starting jenkins (via systemctl): Job for jenkins.service failed. See ‘systemctl status jenkins.service’ and ‘journalctl -xn’ for details. 
    [FAILED]

出现上面的问题可能是未安装JDK或者是Jenkins的JDK路径配置有错。jenkins配置文件中未正确配置jdk的路径  
查看jenkins配置：/etc/init.d/jenkins

在该配置中找到jdk的配置，jenkins有一个默认的jdk配置，这个配置与个人的jdk配置可能不一样，只需要在该配置下增加自己的jdk配置即可。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70]

2、错误二：

Starting jenkins (via systemctl): Warning: jenkins.service changed on disk. Run ‘systemctl daemon-reload’ to reload units.

使用以下命令解决：systemctl daemon-reload

**三、默认参数修改**

Jenkins的默认端口是8080、默认的Linux用户为jenkins，为了防止端口冲突跟后续jenkins进行文件操作时的一些权限问题、我们将端口号改为9999、默认用户改为root、配置文件位置：/etc/sysconfig/jenkins  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 1]

**四、初始化配置**

1、访问Jenkins:[http://192.168.31.202:9999][http_192.168.31.202_9999]、按提示在对应的文件中复制出administrator的密码  
![在这里插入图片描述][20190114092127681.png]  
选择安装建议的插件。接下来就是安装基本的插件  
2、创建管理员的账号  
3、一些插件的安装、点击“系统管理”–>“插件管理”  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 2]  
在“可选插件”中找到Git、gitlab、Maven Integration plugin、Build pipeline Plugin：没有这个，就没有PipeLine视图、Build Time Out：构建超时插件、Deploy to Container Plugin：部署容器插件、Email Extension Plugin：发送邮件插件、JDK Tool Plugin、PipeLine、Publish over ssh、Timestamper、Workspace Cleanup Plugin

**五、Jenkins凭据配置、全局配置**

1、配置gitLab连接  
在“系统配置”–>“Gitlab”项中配置Gitlab  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 3]  
Connection name：随意填写  
Gitlab host URL：gitLab的ip地址前面加上http如：[http://192.168.31.201][http_192.168.31.201]  
Credentials:点击添加  
类型选择：GitLab API token（如果获取token请看下面）  
点击添加、然后点击“Test Connection”、必须要测试成功在继续往下配置

2、找到API token  
登录gitLab、在个人菜单中点击“Settings”，在左导航连接点击“Access Token”  
Name:随便填  
Expires at:选择过期时间  
Scopes:只需要勾选api就好  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 4]  
点击创建后，得到Token，记得保存一下，因为刷新就没了  
![在这里插入图片描述][20190114092509279.png]  
3、生成ssh-key

ssh-keygen -t rsa -C "root@192.168.31.202" -b 4096 # 生成公钥私钥，注意双引号内是个助记符根据需要修改
    cd /root/.ssh # 进入ssh目录
    git ls-remote -h ssh://git@192.168.31.201/html/tamH5.git HEAD # 连一下git服务器，生成known_hosts文件
    ll # 查看文件

如果没有 known\_hosts 文件之后Jenkins发布时会有如下错误 “Host key verification failed.”  
成功后进入jenkins目录将刚才创建的sshkey复制过来并将所有者指到jenkins账号

cd /var/lib/jenkins # 进入jenkins的home目录
    mkdir .ssh # 创建ssh目录存放sshkey文件，如果存在会报错
    cd .ssh
    cp /root/.ssh/* . # 将root账号下的sshkey文件复制过来，此时如果执行ll看一下这两个文件所有这应该是root
    chgrp jenkins * # 将key文件的组改为jenkins(如果我们前面配置了默认账号是root就不用)
    chown jenkins * # 将key文件的所有者改为jenkins(如果我们前面配置了默认账号是root就不用)

此时pwd再ll应该看到如下内容  
![在这里插入图片描述][20190114092557999.png]  
打开 id\_rsa.pub 将其中内容复制到记事本中，访问gitlab将刚才复制的公钥添加到ssh keys中  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 5]  
4、创建证书  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 6]  
kind：选择 SSH Username with private key  
　　Username：随便输入，之后在创建item是记得住选择那个即可  
　　Priveate key：选择“Enter directly”后输入私钥，记住一定是私钥 （按照上步骤在linux上生成密钥后，会是一对其中带pub后缀的是公钥。id\_rsa私钥、id\_rsa.pub公钥)。在linux执行cat id\_rsa将所有内容copy填入key中  
　　Passphrase：不填，如果填了每次都需要输入密码  
　　填好后点击“ok”保存  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 7]  
5、系统配置–>全局工具配置  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 8]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 9]

**六、创建Maven项目**

1、创建Maven项目  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 10]  
2、配置GitLab、默认选择全局配置(GitLab API token对应的名称)  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 11]  
3、源码管理  
Repository URL：复制gitlab上的shh地址  
Credentials：使用我们之前配置好的sshkey全局凭证  
Branch Specifier (blank for ‘any’)：填写对应版本的库  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 12]  
4、构建触发器：选择如下  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 13]  
5、Build  
这里Build的Root POM文件一定要选对  
/var/lib/jenkins/workspace/sailMavenTest/sail-pc/pom.xml  
/var/lib/jenkins/workspace这个路径是jenkins帮我们下载的项目源码根目录  
sailMavenTest则是我们在jenkins中新建的Maven项目的名称  
剩下的就是代码的路径了，一定要选对你要进行构建的pom文件  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 14]  
下面是Post Steps  
这里选择“Run only if build succeeds or is unstable”、并填写要执行的脚本

#!/bin/bash 
    #copy file and restart tomcat 
    
    export JAVA_HOME=/data/java/jdk1.8.0_161
    export CATALINA_HOME=/opt/jenkins/apache-tomcat-9.0.11
    export CATALINA_BASE=/opt/jenkins/apache-tomcat-9.0.11
    export BUILD_ID=dontKillMe
    
    tomcat_path=/opt/jenkins/apache-tomcat-9.0.11
    project=sail-web
    war_name=sail-web.war 
    war_path=http://192.168.31.202/:9999/jenkins/job/sailMavenTest/ws/targetserver_port=9988
    file_path=/var/lib/jenkins/workspace/sailMavenTest/sail-pc/sail-web/target
    
    $tomcat_path/bin/shutdown.sh 
    
    sleep 5s 
    
    cd $file_path
    
    cp ${war_name} ${tomcat_path}/webapps/sail-web/
    
    cd $tomcat_path/webapps/sail-web/
    
    unzip -o ${war_name}
    
    rm -rf ${war_name}
    
    sleep 5s 
    
    #$tomcat_path/bin/startup.sh
    
    cd $tomcat_path/bin/
    ./startup.sh
    
    echo "server restarted"

构建完成后执行该脚本、停掉tomcat、移动war包到tomcat、覆盖解压、删除war包、启动tomcat  
如此构建完成  
这里需要手动点击一下构建，检查是否能构建成功  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 15]  
可以点击构建的连接查看构建详细信息  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 16]  
如果构建失败，最好点击“控制台输出”查看构建日志，找出错误原因。  
构建成功示例输出  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 17]  
![在这里插入图片描述][20190114093112723.png]  
…

这里我们只能手动构建，如何自动检测代码提交后马上构建，请看下一章。

**七、配置提交代码自动构建**

1、配置Jenkins访问Token跟访问URL  
点击“用户列表”、选择管理员用户  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 18]  
点击“设置”(用户ID保存下来)  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 19]  
添加Token并保存下来(刷新就没了)、  
![在这里插入图片描述][20190114093201837.png]  
在Maven项目的“构建触发器”中找到GitLab webhook URL（保存下来）  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 20]

2、在gitlab中设置回调地址  
gitlab收到代码提交后会向我们配置的地址发送通知  
地址样例  
[http://hzw:11dd9cd1047920336f1fb8ee7bf1b79124@192.168.31.202:9999/project/sailMavenTest][http_hzw_11dd9cd1047920336f1fb8ee7bf1b79124_192.168.31.202_9999_project_sailMavenTest]  
hzw：Jenkins用户ID  
11dd9cd1047920336f1fb8ee7bf1b79124：Jenkins配置的用户的Token  
@192.168.31.202:9999/project/sailMavenTest：Jenkins的GitLab webhook URL  
将url放入gitlab项目的Integrations中(不用输入下面的Secret Token)  
完毕后，在页面测试一下提交是否返回HTTP:200  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 21]  
至此，配置完成。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70]: /images/20220327/15ee37d830334243ad951f4c04dde344.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 1]: /images/20220327/6b7577775f4e46418992b9b4cf641cff.png
[http_192.168.31.202_9999]: http://192.168.31.202:9999
[20190114092127681.png]: /images/20220327/458119f03b4e4e20953b0003c789915b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 2]: /images/20220327/980c182f77024234951ad6ab0c4fbdbb.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 3]: /images/20220327/13b1a0ddc19b46e6acfcf674fb217476.png
[http_192.168.31.201]: http://192.168.31.201
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 4]: /images/20220327/05b2656bd1a249eca8871b9004551b63.png
[20190114092509279.png]: /images/20220327/43d659ec3fed40ffacf340188620e3bc.png
[20190114092557999.png]: /images/20220327/8b576444b5c84bc9accf07fde6d6a5b0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 5]: /images/20220327/90689f28d9fa4259b183adf688f48721.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 6]: /images/20220327/e12cb92e2bdc40fe84b6ff474e6a1aad.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 7]: /images/20220327/faae8ceb70f3461489f798866ea26bee.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 8]: /images/20220327/f1a7d332a04d448dbdfbed152a21040a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 9]: /images/20220327/77ac7bdf92f74a51bb7abbf92ada6124.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 10]: /images/20220327/51c51619b8e044579c73a761640a5097.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 11]: /images/20220327/e4dcfe0aff3b4cbaa323a435bad0eb39.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 12]: /images/20220327/d8c4f83bd3054a3f8ecd21dd4ddd308d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 13]: /images/20220327/fcd320ca21da442c916a1d682484744c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 14]: /images/20220327/de53145b01d84f69b495ee3a6f07fd72.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 15]: /images/20220327/0756129b2cec4a1e942c3328d41f3502.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 16]: /images/20220327/26f280e05d1348b39f81e13f515cdbd6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 17]: /images/20220327/da3a2b9efd4b4189aab99056b991b974.png
[20190114093112723.png]: /images/20220327/2c43ba57a6084009a1b5a24b754758d7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 18]: /images/20220327/679c4fcb43014c438b97db6de6afdd8e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 19]: /images/20220327/4212857d66934f139c08c76954d22e67.png
[20190114093201837.png]: /images/20220327/f9d2dc1100434a2083b7c06b34fba8d0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 20]: /images/20220327/21a20706ca874844b5e4889e07935d2c.png
[http_hzw_11dd9cd1047920336f1fb8ee7bf1b79124_192.168.31.202_9999_project_sailMavenTest]: http://hzw:11dd9cd1047920336f1fb8ee7bf1b79124@192.168.31.202:9999/project/sailMavenTest
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h6dzIzMTI_size_16_color_FFFFFF_t_70 21]: /images/20220327/27d20cfd38544a22be82052d613164a0.png