mac通过docker一键部署Jenkins
一、前言
程序猿开发任务本来就比较繁锁，如果搭建各种开源的软件还需要搜索这样那样的配置，那基本上两鬓斑白的头发基本上都快脱光了，如何找女朋友呢？难道一直和五姑娘为伴?所以自己当第一个吃螃蟹的人摸索了一些套路，编写一些简易的 shell 脚本帮我们快速的搭建服务器，猿们只要按着套路“一步一步”的操作，基本上都可以快速部署服务，也有《Jenkins自动安装脚本》，大家根据自己的实际情况进行操作。
二、系统配置
mac os：Monterey mac version：12.4 (21F79) mac type: MacBook Air (M1, 2020), Apple M1 docker desktop version：v4.10.0 docker version：v20.10.17 docker-compose version: v1.29.2 三、安装步骤
Dockerhub查看镜像地址
# 如果你比较懒可以使用最后的“Jenkins自动安装脚本”，mac电脑通用 https://hub.docker.com/r/jenkins/jenkins/tags 1、一键安装
1.1、下载脚本
https://gitee.com/xiaoyaojiugui/technical/blob/master/docker/foundations/cicd/jenkins 1.2、安装程序
# 跳转到指定文件夹，并执行如下命令： sh ./jenkins.sh 1.2.1、安装程序详情
---------------函数开始执行--------------- 1.1、检查必要软件，跳过此步骤，目录已存在[/Users/jason.zhuo/data/docker/apps/jdk-17] 1.2、检查必要软件，跳过此步骤，目录已存在[/Users/jason.zhuo/data/docker/apps/apache-maven-3.8.6] 1.3、检查必要软件，跳过此步骤，文件已存在[/Users/jason.zhuo/codes/leisure/doc/technical/docker/foundations/cicd/jenkins/software/jenkins.war] 2.1、执行创建容器操作，跳过此步骤，镜像已存在[jenkins/jenkins:latest] 2.2、执行创建容器操作，创建目录并授权，执行命令：sudo mkdir -p -v /Users/jason.zhuo/data/docker/volumes/jenkins/{jenkins-home,conf} && sudo chown -R jason.zhuo /Users/jason.zhuo/data/docker/volumes/jenkins mkdir: created directory '/Users/jason.zhuo/data/docker/volumes/jenkins' mkdir: created directory '/Users/jason.zhuo/data/docker/volumes/jenkins/jenkins-home' mkdir: created directory '/Users/jason.zhuo/data/docker/volumes/jenkins/conf' 2.3、执行创建容器操作，执行命令：docker run -d -p 39090:8080 -p 50000:50000 -v /Users/jason.zhuo/data/docker/volumes/jenkins/jenkins-home:/var/jenkins_home --name jenkins jenkins/jenkins:latest 2.4.1、执行创建容器操作，根据服务器性能调整时间，默认休息 10 秒，--> Tue 20 Sep 2022 11:12:41 AM CST <-- 2.4.2、执行创建容器操作，根据服务器性能调整时间，默认休息 10 秒，--> Tue 20 Sep 2022 11:12:51 AM CST <-- 2.5.1、执行创建容器操作，修改配置文件[/Users/jason.zhuo/data/docker/volumes/jenkins/jenkins-home/hudson.model.UpdateCenter.xml] 2.5.2、执行创建容器操作，查看配置文件，执行命令：cat /Users/jason.zhuo/data/docker/volumes/jenkins/jenkins-home/hudson.model.UpdateCenter.xml | grep 'url' 2.5.3、执行创建容器操作，修改配置文件[/Users/jason.zhuo/data/docker/volumes/jenkins/jenkins-home/updates/default.json] sed -i "" 's/https://updates.jenkins.io/download/https://mirrors.tuna.tsinghua.edu.cn/jenkins/g' /Users/jason.zhuo/data/docker/volumes/jenkins/jenkins-home/updates/default.json && sed -i "" 's/http://www.google.com/https://www.baidu.com/g' /Users/jason.zhuo/data/docker/volumes/jenkins/jenkins-home/updates/default.json 2.5.5、执行创建容器操作，拷贝配置[/etc/profile]到本地并配置环境变量，执行命令：sudo docker cp $(docker ps -a | grep jenkins | awk '{print $1}'):/etc/profile /Users/jason.zhuo/data/docker/volumes/jenkins/conf/ 2.6.1、执行重建容器操作，其容器为[jenkins/jenkins:latest]，执行命令： docker run -d -p 39090:8080 -p 50000:50000 --privileged=true -v /usr/bin/docker:/usr/bin/docker -v /var/run/docker.sock:/var/run/docker.sock -v /Users/jason.zhuo/data/docker/volumes/jenkins/jenkins-home:/var/jenkins_home -v /Users/jason.zhuo/data/docker/volumes/jenkins/conf/profile:/etc/profile -v /Users/jason.zhuo/data/docker/volumes/jenkins/conf/.bashrc:/root/.bashrc -v /Users/jason.zhuo/data/docker/apps/apache-maven-3.8.6:/usr/local/apps/apache-maven-3.8.6 -v /Users/jason.zhuo/data/docker/apps/jdk-17:/usr/local/apps/jdk-17 --name jenkins jenkins/jenkins:latest 2.6.2、复制Jenkins的最新war包到指定目录，执行命令：docker cp ./software/jenkins.war $(docker ps -a | grep jenkins | awk '{print $1}'):/usr/share/jenkins/jenkins.war 2.7.1、查看容器状态，执行命令：docker inspect --format='{{.State.Status}}' jenkins 2.7.2、查看容器状态，[exited]，启动命令：docker start jenkins jenkins 2.7.3、查看容器详情，执行命令：docker ps | grep jenkins/jenkins:latest 3.1、其他待执行命令，登录容器其命令为：docker exec -it -u root jenkins /bin/bash 3.2、其他待执行命令，复制最新war包其命令为：docker cp ./jenkins.war $(docker ps -a | grep jenkins | awk '{print $1}'):/usr/share/jenkins/jenkins.war ---------------函数执行完毕--------------- 注意：此处休息10秒，是因为刚启动该文件没有初始完成（hudson.model.UpdateCenter.xml） 1.2.2、下载必要软件详情
1、检查目标目录，待执行脚本的路径为[/Users/jason.zhuo/code/leisure/doc/technical/docker/foundations/cicd/software]，包括如下文件： 2、检查目标目录，跳过此步骤，文件夹已存在[/Users/jason.zhuo/data/docker/apps] 3、检查Maven软件，其文件名[apache-maven-3.8.6]，压缩包名[apache-maven-3.8.6-bin.tar.gz] 4、检查Maven软件，解压压缩包，执行命令：tar -zxf apache-maven-3.8.6-bin.tar.gz 5、检查Maven软件，拷贝到指定目录，执行命令：sudo cp -r apache-maven-3.8.6 /Users/jason.zhuo/data/docker/apps 6、检查JDK软件，其文件名[jdk-17]，压缩包[jdk-17_linux-aarch64_bin.tar.gz] 7、检查JDK软件，解压压缩包，执行命令：tar -zxf jdk-17_linux-aarch64_bin.tar.gz 8、检查JDK软件，重命名文件，执行命令：sudo mv jdk-17.0.4.1 jdk-17 9、检查JDK软件，拷贝到指定目录，执行命令：sudo cp -r jdk-17 /Users/jason.zhuo/data/docker/apps 10、查看目标目录内容，执行命令：ls /Users/jason.zhuo/data/docker/apps 1.3、启动成功后，即可正常访问
http://localhost:39090/login 1.4、查看登录密码
docker exec -it jenkins cat /var/jenkins_home/secrets/initialAdminPassword 1.5、插件自定义安装
注意：此处不安装任何插件，因为Jenkins的官方插件下载地址速度非常慢。
1、获取密码，登录即可； 2、“选择插件来安装”而非社区推荐的插件 --> 选择“无” --> 然后点击“安装”即可； 3、创建第一个管理员账户，只有创建了新账户并成功登录后，才能执行如下《步骤1.6》 
1.6、修改国内插件下载源
注意：执行完命令后请重启！执行完命令后请重启！执行完命令后请重启！
1、Jenkins的官方插件下载地址速度非常慢，需要替换成国内插件地址； 2、手动更新配置，复制《1.2.1 安装程序详情》中的《2.5.3命令》，在终端执行即可； 3、执行完以下命令，需要重启 jenkins 才能生效； # 解决打开登录界面时一直在转圈圈，程序自动更新 update-center.json sed -i "" 's/https://updates.jenkins.io/update-center.json/https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json/g' /Users/jason.zhuo/data/docker/volumes/jenkins/jenkins-data/hudson.model.UpdateCenter.xml # 替换成国内插件地址，手动更新 default.json # 其实有很多朋友会问，为什么更新 default.json 不放在 shell 脚本中操作呢？之前试过在 shell 脚本中更新，但只要没有创建第一个管理员账户，那 default.json 配置就会被还原成官方配置，请执行命令； sed -i "" 's/https://updates.jenkins.io/download/https://mirrors.tuna.tsinghua.edu.cn/jenkins/g' /Users/jason.zhuo/data/docker/volumes/jenkins/jenkins-home/updates/default.json && sed -i "" 's/https://www.google.com/https://www.baidu.com/g' /Users/jason.zhuo/data/docker/volumes/jenkins/jenkins-home/updates/default.json 1.7、容器内下载最新版本Jenkins
1.7.1、以root用户登录容器
1、以root用户登录容器 docker exec -it -u root jenkins /bin/bash 2、跳转到指定目录 cd /usr/share/jenkins 3、让环境变量生效 source /etc/profile 1.7.2、在容器中下载jenkins的最新war包
# 1、如果容器内没有wget命令，则安装应用： sudo apt-get update && apt-get install wget # 2、下载最新的镜像 wget http://mirrors.jenkins.io/war/latest/jenkins.war 1.7.3、新旧war包替换
# 1、移除旧war包 rm -rf jenkins.war # 2、重命令新war包 mv jenkins.war.1 jenkins.war 1.7.4、退出容器，并重启应用
docker restart jenkins 1.8、手动安装社区推荐的插件
注意：如果安装插件时失败，且有提示要更新 Jenkins 版本，操作请按《步骤1.7》
Jenkins -> Manage Jenkins -> Manage Plugins，点击Available
| 序号 | 插件 | 是否安装 |
|---|---|---|
| 1 | Folders | yes |
| 2 | OWASP Markup Formatter | |
| 3 | Build Timeout | yes |
| 4 | Credentials Binding | |
| 5 | Timestamper | yes |
| 6 | Workspace Cleanup | yes |
| 7 | Ant | yes |
| 8 | Maven Integration | yes |
| 9 | GitHub Branch Source | yes |
| 10 | Git | yes |
| 11 | Pipeline | yes |
| 12 | Pipeline: Groovy | yes |
| 13 | Pipeline: Stage View | yes |
| 14 | Pipeline: Declarative | yes |
| 15 | Pipeline: Basic Steps | yes |
| 16 | SSH Build Agents | yes |
| 17 | Publish Over SSH | yes |
| 18 | Matrix Authorization Strategy | |
| 19 | Parameterized Trigger | yes |
| 20 | Email Extension | yes |
| 21 | JUnit | yes |
| 22 | Localization: Chinese (Simplified) | yes |
1.9、解决问题
-
打开登录界面时，一直停留在“Please wait while Jenkins is restarting ...”
解决方案：请参考《步骤1.6》 -
Jenkins的官方插件下载地址速度非常慢，需要替换成国内插件地址
解决方案：请参考《步骤1.6》 -
Docker 中的 Jenkins 重启时，“/etc/profile”环境变量失效
解决方案：
1.在/root/.bashrc文件最下面添加如下指令：source /etc/profile
2.保存文件，然后执行：source /root/.bashrc
1.10、卸载程序
备注：此步骤请慎用，执行脚本时后面加任意参数即可卸载
# 参数1：即删除容器 sh ./jenkins.sh del1 # 参数1：删除容器和文件夹 sh ./jenkins.sh delete # 参数2：即删除镜像，删除后需要重新下载镜像才能初始化容器 sh ./jenkins.sh del1 del2 1.10.1、卸载程序详情
---------------函数开始执行--------------- 1.1、执行容器删除操作，跳过此步骤，检查必要软件 2.1、执行容器删除操作，跳过此步骤，删除原镜像[jenkins/jenkins:latest] 2.2、执行容器删除操作，跳过此步骤，创建目录[/Users/jason.zhuo/data/docker/volumes/jenkins] 2.3、执行容器删除操作，跳过此步骤，第一次初始化容器[jenkins] 2.4、执行容器删除操作，跳过此步骤，休眠 120 秒 2.5、执行容器删除操作，跳过此步骤，修改配置文件 2.6、执行容器删除操作，执行命令：docker stop jenkins && docker rm jenkins 2.6、执行容器删除操作，成功删除容器[jenkins] 2.7、执行容器删除操作，跳过此步骤，第二次初始化容器[jenkins] 2.8、执行容器删除操作，跳过此步骤，检查容器状态 2.9.1、执行容器删除操作，删除文件夹，执行命令：sudo rm -rf /Users/jason.zhuo/data/docker/volumes/jenkins 2.9.2、执行容器删除操作，成功删除文件夹[/Users/jason.zhuo/data/docker/volumes/jenkins] ---------------函数执行完毕--------------- 四、总结
自动化脚本安装完成后，本地的 Jenkins 基本上就可以随便玩，文章如有不对之处请留言，会及时修正，谢谢阅读！！
五、后记
所有文章均为本人原创，本人写作的目的就是想帮助对技术有需要的人，所以欢迎同行转载本站文章，但是，希望您注明来源，并留下原文链接地址，这是对文章作者的尊重，也是对知识的尊重。
