LBW's Wiki Pages

# Jenkins安装与配置

# 在Centos上安装Jenkins

下面介绍在Centos系统下安装jenkins的步骤

首先需要安装Java

yum install java

然后把Jenkins库添加到yum中，Jenkins将从这里下载安装

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

安装过程完成后，用以下命令启动Jenkins

systemctl start jenkins

用以下命令查看Jenkins启动状态

systemctl status jenkins

如果想开机自动启动jenkins，可以执行以下命令

systemctl enable jenkins

Jenkins默认使用端口8080。可以通过访问 http://localhost:8080 来访问Jenkins。

Jenkins的配置文件存放在 /etc/sysconfig/jenkins，如果需要修改配置，可通过修改此文件完成。

首次启动后，需要使用初始密钥，并且建议安装建议的插件。

# 在 Jenkins 中配置 JDK，Maven 和 Docker

  • 对于Java应用来说，需要使用 JDK 包。同时还需要Maven 工具进行构建，于是需要在 Jenkins 中配置 JDK，Maven。
  • 对于应用的发布，部署等，使用 Docker 容器化是一个好的方案，因此需要在 Jenkins 中配置 Docker。

三者都是在 Manage Jenkins -> Global Tool Configuration 中进行配置。

配置 Docker 需要提前装好 Docker Commons Plugin 插件，不过只要在安装Jenkins时安装了建议的插件，就无需手动安装

# JDK

  • 在 Global Tool Configuration 中找到 JDK，点击 JDK Installations
  • 点击 ADD JDK，Name中填写 jdk-8u221
  • 勾选 Install automatically
  • 点击 Add Installer，选择Install from Java SE Development Kit from the website，版本选择 8u221
  • 根据提示输入 Oracle 账号密码。
  • 点击 Apply 应用此配置。

# Maven

  • 在 Global Tool Configuration 中找到 Maven，点击 Maven Installations
  • 点击 Add Maven，Name 填写 mvn-3.6.2
  • 勾选 Install automatically
  • 点击 Add Installer，选择 Install from Apache，选择版本3.6.2
  • 点击 Apply 应用此配置

# Docker

  • 在 Global Tool Configuration 中找到 Docker，点击 Docker Installations
  • 点击 Add Docker，Name中填写 myDocker
  • 勾选 Install automatically
  • 点击 Add Installer，版本选择 latest
  • 点击 Apply 应用此配置。

注意此方法是在 Jenkins 环境中安装 Docker Client，其默认还是与宿主机上的/var/run/docker.sock进行通信，因此需要保证Jenkins的宿主机上有可用的 Docker Engine

# 在 Jenkins 中使用 Docker Plugin （一般无需使用）

这是除了以上方法外，另一种在 Jenkins 中使用Docker的方法，主要由Docker Plugin插件实现。由于配置比较麻烦，一般无需使用。

  1. 进入 Manage Jenkins -> Manage Plugins -> Avaliable.
  2. 搜索 Docker，选择Docker plugin插件，勾选后点击 Install without Restart，等待插件安装完毕。

安装好插件后，需要进行相关配置。

  1. 进入 Manage Jenkins -> Configure System。
  2. 拉到最底部，点击 Add a new cloud -> Docker.
  3. 点击 Docker Cloud Detail，在 Docker Host URL 中填写 unix:///var/run/docker.sock
  4. 点击 Test Connection 测试是否能够连接本机上的 Docker Engine。

如果在 Test Connection 时出现权限不够的问题，可以在终端中执行 chmod 777 /var/run/docker.sock来修改文件的访问权限。

  1. 勾选 Enabled

然后对 Docker Agent Template进行配置。

  1. 点击 Docker Agent Templates，点击 Add Docker Template。
  2. 在 Labels 中填入 docker-agent
  3. 勾选 Enabled
  4. 在 Name 中填入 docker.
  5. 在 Docker Image 中填入 benhall/dind-jenkins-agent:v2。（该镜像来自这里 (opens new window))
  6. 点击 Container Settings，在volumes中填写 /var/run/docker.sock:/var/run/docker.sock. 该选项使我们创建的容器能够访问宿主机的 docker.sock
  7. 在 Connect Method 中选择 Connect with SSH.因为这个镜像是基于 Jenkins SSH Slave image建立的，所以默认的SSH Key就能够处理认证问题。
  8. 确认勾选了Enabled，点击保存。

至此 Docker配置完成，可以在 Pipeline中使用 Docker相关命令了。

# 参考资料

Installing Jenkins on RedHat distributions (opens new window)

Build docker image in Jenkins (opens new window)

←