基于Docker的Jenkins部署手册
在windows中基于Docker环境,在Docker中使用Jenkins,并将前端项目打包交由Jenkins自动构建。
1. 使用Docker ,Docker具有容器化优势,可以快速构建一个Jenkins运行环境且与宿主机器环境完全隔离,可以确保打包与开发环境的一致性
2. 使用Jenkins具备完善的配置功能,且在打包构建时可以配置同本地相同的Node环境,降低对本地计算机构建的性能依赖
3. 可以配合Git CI进行持续构建,完成代码推送后即可自动化构建,降低打包成本
| 操作系统 | Windows11 |
|---|---|
| Docker版本 | 最新版本docker Desktop |
| Jenkins版本 | Version 2.439 (docker) |
1. window程序需要开启 Hyper-V 虚拟机管理程序
2. Window程序建议开启 适用于window的linux的子系统
3. 安装最新版本 Docker Desktop 并启动Docker服务 ,Docker官方 www.docker.com/
4. 使用CMD 安装Jenkins镜像
| Dockerfile docker pull jenkins/jenkins |
|---|
Jenkins Docker Hub 镜像官方hub.docker.com/r/jenkins/j…
需要确保已经完成Docker安装,并且通过CMD 成功拉取Jenkins的Docker镜像
1. 创建并运行容器 ****使用Jenkins 最新的镜像
| Dockerfile docker run -d -v D:/Jenkins:/var/jenkins_home -p 8453:8080 -p 50000:50000 --name Jenkins jenkins/jenkins:latest |
|---|
使用docker基于jenkins/jenkins:latest镜像创建并运行容器Jenkins ,-p参数 将物理端口8453 、50000分别映射到docker容器的8080、50000端口,-v参数 将docker文件/var/jenkins_home 映射到本地 D:/Jenkins
2. 使用浏览器访问服务器 8453端口 ,进入Jenkins初始化流程
获取管理员密码解锁Jenkins,由于已经映射到Windows目录下,所有请在 D:\jenkins\secrets 打开initialAdminPassword 文件获取初始化密码并填入Jenkins管理员密码中并点击确认
3. 安装Jenkins插件
这里使用推荐插件,快速完成Jenkins必须插件安装,并等待插件安装完成
4.创建管理员用户
根据提示输入管理员账号以及密码并选择下一步
保存实例配置并Jenkins主页,此处无需修改实例实例配置
5.Jenkins首页
此处截图为首页实例,首次初始化无任务列表
6. 安装全局Node.js插件
1.进入插件管理页面
2.在Available plugins 页面搜索node插件安装
7. 设置全局node.js配置
1.进入全局工具配置页面
2.选择NodeJS安装选项卡,添加一个NodeJS,选择合适NodeJs版本勾选自动安装即可
3.点击保存即可
8. 设置Git代码库凭据
在Docker Desktop中选择Jenkins容器 进入命令模式 或通过CMD进入容器命令交互,此处演示使用Docker Desktop
- 在docker容器命令中输入以下命令生成ed25519 密钥
- 将id_ed25519.pub 密钥数据复制并填入Git存储库中,以允许Jenkins拉取代码
ssh-keygen -t ed25519 -C "<注释内容>"
cat ~/.ssh/id_ed25519.pub
9. Jenkins全局执行密钥
同第8步,使用Docker Desktop 命令界面输入以下命令 生成Jenkins密钥并且填入Jenkins凭据管理中
sudo su -s /bin/bash jenkins
cd ~
ssh-keygen -m PEM -t rsa -f id_rsa
cat .ssh/id_rsa.pub
1.进入凭据管理页面
2.点击system-》全局凭据-》 Add Credentials 进入凭据添加页面
3.选择SSH username with private key -》Enter directly -》添加,加入上一步生成的密钥并保存
10. 执行git ls 同第8步,使用Docker Desktop 命令界面输入以下命令
git ls-remote -h -- git@codeuxxxx.git HEAD
其中Git地址可以是任意git库地址
11. 新建构建任务 完成以上操作后即可进行任务构建
1.回到Jenkins首页,点击新建任务
2.输入任务名称以及选择自由风格项目
3.点击确定进入下一步
12. 构建任务配置
1.输入项目基础信息
2.填入Git库地址以及分支参数
3.勾选提供node服务 Provide Node & npm bin/ folder to PATH ,并选择第7步配置的node配置
4.Build Steps 中输入构建shell脚本
5.检查配置后保存任务
13. 开始构建 选择对应任务即可开始构建