Jenkins 入门教程之二 Jenkins 与 SVN 搭建 CI-CD 环境

发表于 2019-01-23 更新于 2019-07-21 阅读次数：评论数：本文字数： 1.4k 阅读时长 ≈ 1 分钟

前言

本教程实战演示基于 SVN + Jenkins + Maven + JDK + Docker 搭建 CI/CD 环境，其中 SVN 基于 Debian 镜像手动安装，而 Jenkins、Maven、JDK 则基于 Tomcat 镜像手动安装。如果仅为了快速体验使用 Jenkins 的功能，可以直接 Pull Jenkins 官方的 Docker 镜像，然后创建并启动 Docker 容器来体验 Jenkins 相关功能，此时可忽略下面教程中的大部分操作步骤。

Docker 环境安装与配置

站内教程：Docker 介绍与安装

基于 Docker 搭建 SVN 服务器

站内教程：通过 Apache、Subversion 搭建 SVN 服务器，实现使用 HTTP/SVN 协议访问 SVN 仓库

# 拉取Debian镜像
# docker pull debian

# 创建并启动容器，80是Apache端口，3690是Subversion端口，/var/lib/svn是所有SVN仓库的父目录
# docker run -it -p 9126:80 -p 4690:3690 --name svn-httpd \
         -v /container/svn-server:/var/lib/svn \
         -d debian

# 连接容器
# docker exec -it svn-httpd /bin/bash

# 修改系统时间
# ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

# 参考上面给出的本站教程，使用Apache、Subversion搭建SVN服务器

# 断开容器连接，不停止运行容器
# ctrl + p + q

# 最后如果Subversion容器能正常工作，建议执行commit操作生成Docker备份镜像
# docker commit -a "clay@gmail.com" -m "commit jenkins-svn-httpd image" svn-httpd clay/jenkins-svn-httpd:1.0

基于 Docker 搭建 Tomcat 服务器

# 拉取Tomcat8的镜像
# docker pull tomcat:8

# 创建并启动容器
# docker run -p 8888:8080 --name tomcat8 \
         -v /container/tomcat8/logs:/usr/local/tomcat/logs \
         -d tomcat:8

# 连接容器
# docker exec -it tomcat8 /bin/bash

# 更新系统并安装常用软件，Docker官方的Tomcat镜像默认安装了Open-JDK、Tomcat Native、APR，具体安装细节可以参考官方镜像的Dockerfile文件
# apt-get -y update
# apt-get -y upgrade
# apt-get -y install git vim htop telnet net-tools

# 修改系统时间
# ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

# 配置Tomcat8的管理用户，编辑Tomcat8对应的配置文件，在<tomcat-users>标签内添加以下内容
# vim /usr/local/tomcat/conf/tomcat-users.xml
<tomcat-users>
  <role rolename="admin-gui"/>
  <role rolename="admin-script"/>
  <role rolename="manager-gui"/>
  <role rolename="manager-script"/>
  <role rolename="manager-jmx"/>
  <role rolename="manager-status"/>
  <user username="admin" password="123456" roles="admin-gui,admin-script,manager-gui,manager-script,manager-jmx,manager-status"/>
</tomcat-users>

# 关于Tomcat配置管理用户，不同版本的Tomcat配置方法有差异，上面仅演示Tomcat8版本的配置方法。
# 由于Tomcat8默认启用了网段限制，默认只有127网段局域网的机器才拥有有访问权限，如果是其他网段登陆，如172，10网段会报403错误，因此需要按照下面的方法修改对应的context.xml配置文件。
# 出于安全考虑，在生产环境中建议启用默认的网段限制，即只允许在本地访问Tomcat服务器的管理页面。

# 编辑manager项目下的META-INF/context.xml配置文件，将<Valve>标签的内容替换为以下文本
# vim /usr/local/tomcat/webapps/manager/META-INF/context.xml
<Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="\d+\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />

# 编辑host-manager项目下的META-INF/context.xml配置文件，将<Valve>标签的内容替换为以下文本
# vim /usr/local/tomcat/webapps/host-manager/META-INF/context.xml
<Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="\d+\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />

# 断开容器连接
# exit

# 重启容器使配置生效
# docker restart tomcat8

# 通过浏览器访问Tomcat的管理页面，测试是否配置成功

# 最后如果Tomcat容器能正常工作，建议执行commit操作生成Docker备份镜像
# docker commit -a "clay@gmail.com" -m "commit jenkins-server image" tomcat8 clay/jenkins-server:1.0

Tomcat 容器内安装与配置 Oracle JDK、Maven

# 提示：这里安装的Oracle JDK、Maven，在后面Jenkins的全局工具配置中会用到

# 连接容器
# docker exec -it tomcat8 /bin/bash

# 下载Oracle JDK8
# wget -P /usr/local --no-cookies --no-check-certificate --header "Cookie: gpw_e24=http%3a%2F%2Fwww.oracle.com%2Ftechnetwork%2Fjava%2Fjavase%2Fdownloads%2Fjdk8-downloads-2133151.html; oraclelicense=accept-securebackup-cookie;" "https://download.oracle.com/otn-pub/java/jdk/8u201-b09/42970487e3af4f5aa5bca3f542482c60/jdk1.8.0_201-linux-x64.tar.gz"

# 解压Oracle JDK8
# tar -xvf /usr/local/jdk1.8.0_201-linux-x64.tar.gz

# 下载Maven
# wget -P /usr/local/ http://mirrors.shu.edu.cn/apache/maven/maven-3/3.6.0/binaries/apache-maven-3.6.0-bin.tar.gz

# 解压Maven
# tar -xvf /usr/local/apache-maven-3.6.0-bin.tar.gz

# 删除下载文件
# rm /usr/local/jdk1.8.0_201-linux-x64.tar.gz
# rm /usr/local/apache-maven-3.6.0-bin.tar.gz

# 创建Java命令的软链接，如果安装了Open-JDK，会覆盖Open-JDK相关命令
# ln -s -f /usr/local/jdk1.8.0_201/bin/java /usr/bin/java
# ln -s -f /usr/local/jdk1.8.0_201/bin/javac /usr/bin/javac

# 配置JDK、Maven的环境变量，在配置文件末尾追加以下内容即可
# 注意，在/etc/profile配置文件中添加环境变量后，重启Docker容器后环境变量会失效，建议在DockerFile中添加环境变量，然后通过DockerFile构建得到Docker镜像
# vim /etc/profile

JAVA_HOME=/usr/local/jdk1.8.0_201
JRE_HOME=/usr/local/jdk1.8.0_201/jre
CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$JRE_HOME/lib
PATH=$PATH:$JAVA_HOME/bin:$JRE_HOME/bin
export JAVA_HOME JRE_HOME CLASSPATH PATH

MAVEN_HOME=/usr/local/apache-maven-3.6.0
PATH=$PATH:$MAVEN_HOME/bin
export MAVEN_HOME PATH

# 使环境变量生效
# source /etc/profile

# 验证环境变量是否生效
# mvn -version
# java -version
# javac -version

# 最后如果上面的配置都生效了，建议执行commit操作生成Docker备份镜像
# docker commit -a "clay@gmail.com" -m "commit jenkins-server image" tomcat8 clay/jenkins-server:1.1

Tomcat 容器内安装 Jenkins

Jenkins 本质是一个 Java 开发的 Web 项目，官方发布方式有 War 文件、Native 包、安装程序、Docker 镜像，Jenkins 官方下载页面。

# 连接容器
# docker exec -it tomcat8 /bin/bash

# 下载War文件到Tomcat的webapps目录
# wget -P /usr/local/tomcat/webapps https://mirrors.tuna.tsinghua.edu.cn/jenkins/war-stable/2.150.2/jenkins.war

# 编辑server.xml配置文件，修改Tomcat URI地址的编码解码字符集为UTF-8
# vim /usr/local/tomcat/conf/server.xml
<Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" URIEncoding="UTF-8"/>

# 断开容器连接
# exit

# 重启容器
# docker restart tomcat8

# 浏览器访问以下地址测试Jenkins是否启动成功，首次访问Jenkins的管理页面，会提示进行解锁操作
http://127.0.0.1:8888/jenkins

# 如果Jenkins启动失败，可以通过输入以下地址查看Jenkins的日志信息或者查看Tomcat的日志信息来定位问题
http://localhost:8888/jenkins/log/all

# 提示：Jenkins默认的数据目录是：/root/.jenkins

解锁 Jenkins

jenkins-install-unlock

# 连接容器
# docker exec -it tomcat8 /bin/bash

# 查看Jenkins自动生成的管理密码，并将管理密码填写到Jenkins的解锁页面中，这里的管理密码同时也是admin账号的登录密码
# cat /root/.jenkins/secrets/initialAdminPassword

安装 Jenkins 插件

解锁后会跳转到 “自定义 Jenkins” 页面，页面中选择哪种方式来安装插件都不会对后续操作有太大影响；因为有需要的插件可以在后续有针对性地安装，本文选择 “安装推荐的插件”。

jenkins-install-plugin
jenkins-install-plugin2

创建 Jenkins 管理员用户

根据页面提示创建管理员用户，表单填写完后点击”Save and Continue” 按钮保存设置，这里的管理员用户区别于 Jenkins 自动创建的 admin 用户。

jenkins-install-create-admin

配置 Jenkins 实例

一般使用默认的 Jenkins URL 即可。

jenkins-install-instance-config

登录 Jenkins 管理后台

浏览器输入 Jenkins 管理后台的登录地址，填写上面创建的管理员或者 admin 账号和密码即可登录。如果登录后的页面只显示空白页面，可以尝试重启 Tomcat 服务器再访问 URL：http://127.0.0.1:8888/jenkins/login

jenkins-install-login

Jenkins 支持中文界面

Manage Jenkins –> Manage Plugins –> Available –> 搜索关键字”Local” –> 选中 Local 插件进行安装，建议安装完之后手动重启 Tomcat 服务器。

jenkins-local-language
jenkins-local-language2

Jenkins 开启用户注册功能

Manage Jenkins –> Configure Global Security –> 勾选”Allow users to sign up” –> 点击”Save” 按钮保存设置。如果是处于学习或者测试阶段，还可以勾选 “Anyone can do anything”，这样更方便测试 Jenkins 的功能。出于安全考虑，生产环境下记得取消勾选此项。

jenkins-allow-register
jenkins-allow-register2

Jenkins 全局工具配置

Manage Jenkins –> Global Tool Configuration –> 指定 Maven 的配置文件路径、JDK 的安装路径、Maven 的安装路径 –> 点击”Save” 按钮保存设置。不要选择自动安装，因为上面已经手动安装并配置好 Maven、Oracle JDK。
jenkins-global-config
jenkins-global-config2
jenkins-global-config3