配置 Docker 容器的 Jenkins

た入场券 2022-03-19 06:16 243阅读 0赞

本文包含以下内容：

1.  配置 Jenkins 镜像时区，使用国内的时区
2.  配置宿主机挂载目录
3.  创建启动脚本
4.  Jenkins 配置 Publish over SSH，允许 ssh 登陆宿主机
5.  Jenkins 构建镜像

> Jenkins 官方文档：  
> https://github.com/jenkinsci/docker/blob/master/README.md  
> 其他相关文档：  
> https://jenkins.io/zh/doc/book/installing/  
> 修改时区参考：  
> https://blog.csdn.net/isea533/article/details/87261764

## 配置时区 ##

使用默认镜像登陆后显示的时间为默认0时区的，可以通过下面方式简单修改，创建一个新的 Dockerfile，内容如下：

FROM jenkins/jenkins:lts
    USER root
    RUN cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && echo "Asia/Shanghai" > /etc/timezone
    ARG user=jenkins
    USER ${user}

根据当前文件创建一个新的镜像即可。

> 更多配置时区方法看这里：https://blog.csdn.net/isea533/article/details/87261764

## 配置宿主机挂载目录 ##

在宿主机创建一个 `/var/jenkins_home`，jenkins 所有信息都放在这里，当挂载该目录时，以后可以方便的升级 jenkins 镜像，不影响所有任务、配置、插件等信息。

创建目录后，配置权限 `chmod 777 /var/jenkins_home`。

## 参考的启动脚本 ##

docker run -d -p 9999:8080 \
                  -p 50000:50000 \
                  --restart=always \
                  --name jenkins \
                  -v /var/jenkins_home:/var/jenkins_home \
                  jenkins/jenkins:lts

最后的镜像名 `jenkins/jenkins:lts` 可以换成上面修改时区后的镜像。

## 配置 SSH ##

> 参考：  
> https://segmentfault.com/a/1190000012921606  
> https://hyjk2000.github.io/2012/03/16/how-to-set-up-ssh-keys/

在 Jenkins 中安装 `Publish over SSH` 插件，然后进入 jenkins 容器：

docker exec -it jenkins /bin/bash

进入后，执行下面命令创建 ssh 密钥：

# 创建目录
    mkdir ~/.ssh && cd ~/.ssh
    # 生成密钥
    ssh-keygen -t rsa
    # 一直回车即可
    # 生成私钥id_rsa，公钥id_rsa.pub
    # 退出镜像
    exit

在 jenkins 镜像中，`~` home 目录就是 `/var/jenkins_home`，所以 `.ssh` 文件也在宿主机上。

> Jenkins Dockerfile 部分代码如下
> 
>     RUN groupadd -g ${gid} ${group} \
>        && useradd -d "$JENKINS_HOME" -u ${uid} -g ${gid} -m -s /bin/bash ${user}
> 
> `-d` 指定了用户的 `home` 目录

下面开始在【宿主机】上继续操作，进入挂载的 `/var/jenkins_home/.ssh` 目录，执行下面的操作：

# 在宿主机创建 .ssh 目录
    mkdir ~/.ssh
    # 将 jenkins 镜像的公钥追加到 authorized_keys 后面
    cat id_rsa.pub >> ~/.ssh/authorized_keys

接下来还要配置 `sshd` 服务，按下面进行操作：

vi /etc/ssh/sshd_config

编辑 sshd\_config 的配置

# 启用下面的配置
    RSAAuthentication yes
    PubkeyAuthentication yes
    # 请留意 root 用户能否通过 SSH 登录
    PermitRootLogin yes

重启 SSH 服务：

service sshd restart

## 配置 Publish over SSH ##

在 Jenkins 中点击【系统管理】->【系统设置】，找到 `Publish over SSH` 插件，配置如下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2lzZWE1MzM_size_16_color_FFFFFF_t_70]

填写说明：

*  Passphrase 是创建 ssh 密钥时输入的密码，如果你按照前面一直回车，就是空，不需要输入，上图显示的内容是保存后自动出现的，不需要管。
 *  Key 部分要输入上面生成的私钥内容
 *  Name 给配置起一个主机名，自己能识别即可
 *  Hostname 配置主机地址
 *  Username 登陆的用户

配置完保存，点击【Test Configuration】测试能否登陆。

## 构建镜像 ##

Git 示例：https://gitee.com/free/docker-test

在 Jenkins 新建一个项目，然后配置如下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2lzZWE1MzM_size_16_color_FFFFFF_t_70 1]

这里使用了上面提供的 Git 地址。

选择 **Send files or execute commands over SSH after the build runs**，配置如下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2lzZWE1MzM_size_16_color_FFFFFF_t_70 2]  
这里就是选择了宿主机，然后配置了一个命令，这个命令是我们重点看的，命令如下：

cd /var/jenkins_home/workspace/DockerTest && docker build -t dockertest .

Jenkins 会通过 Git 下载项目，会下载到 `/var/jenkins_home/workspace/` 目录，Jenkins 镜像通过 ssh 登陆到宿主机时，可以直接访问到镜像中的该目录，所以能在宿主机执行该命令。

上面的命令就是进入 `DockerTest` 目录，执行构建镜像。

做好上面配置后，立即构建：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2lzZWE1MzM_size_16_color_FFFFFF_t_70 3]

输出的日志：

Started by user NetStar
    Building in workspace /var/jenkins_home/workspace/DockerTest
    No credentials specified
     > git rev-parse --is-inside-work-tree # timeout=10
    Fetching changes from the remote Git repository
     > git config remote.origin.url https://gitee.com/free/docker-test # timeout=10
    Fetching upstream changes from https://gitee.com/free/docker-test
     > git --version # timeout=10
     > git fetch --tags --progress https://gitee.com/free/docker-test +refs/heads/*:refs/remotes/origin/*
     > git rev-parse refs/remotes/origin/master^{commit} # timeout=10
     > git rev-parse refs/remotes/origin/origin/master^{commit} # timeout=10
    Checking out Revision 984f8a72be7d51f5f6586248e1734f5f8394b0cf (refs/remotes/origin/master)
     > git config core.sparsecheckout # timeout=10
     > git checkout -f 984f8a72be7d51f5f6586248e1734f5f8394b0cf
    Commit message: "test"
     > git rev-list --no-walk 984f8a72be7d51f5f6586248e1734f5f8394b0cf # timeout=10
    SSH: Connecting from host [27e4fe10d3b8]
    SSH: Connecting with configuration [k8s-master] ...
    SSH: EXEC: STDOUT/STDERR from command [cd /var/jenkins_home/workspace/DockerTest && docker build -t dockertest .] ...
    Sending build context to Docker daemon  53.76kB
    
    Step 1/3 : FROM alpine:3.9
     ---> caf27325b298
    Step 2/3 : RUN apk add tzdata && cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime     && echo "Asia/Shanghai" > /etc/timezone     && apk del tzdata
     ---> Using cache
     ---> 5508719ca922
    Step 3/3 : CMD ["/bin/sh"]
     ---> Using cache
     ---> a8a23bfcceef
    Successfully built a8a23bfcceef
    Successfully tagged dockertest:latest
    SSH: EXEC: completed after 200 ms
    SSH: Disconnecting configuration [k8s-master] ...
    SSH: Transferred 0 file(s)
    Finished: SUCCESS

构建成功后，通过 `docker images` 查看镜像：

dockertest                           latest                a8a23bfcceef        1 minutes ago        6.86MB

## 关键点 ##

所有的配置中，关键的地方在：

1.  Jenkins 在容器中执行，容器中没有 docker 服务，不能构建镜像
2.  宿主机映射了`/var/jenkins_home` 到 Jenkins 容器，所以宿主机能访问 Jenkins 下载和构建的内容
3.  Jenkins 通过 ssh 登陆到宿主机后，就能用宿主机的所有工具、命令、环境等等

理解这个运行机制后，就能根据自己的需要进行各种定制了。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2lzZWE1MzM_size_16_color_FFFFFF_t_70]: /images/20220319/7ffc75b369de45509c7adb0ef715a658.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2lzZWE1MzM_size_16_color_FFFFFF_t_70 1]: /images/20220319/821107d6f1a94f9f9bb7dfd066059af1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2lzZWE1MzM_size_16_color_FFFFFF_t_70 2]: /images/20220319/99195bc22122438ca5a784bbbafdb5b4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2lzZWE1MzM_size_16_color_FFFFFF_t_70 3]: /images/20220319/a157801399d14f2fa64b7d2d6a75aad7.png