Files
Yi.Framework/Yi.Doc.Md/04.橙子运维CICD教程/03.Jenkins流水线配置.md
2023-12-23 21:14:56 +08:00

265 lines
9.6 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## jenkins流水线
在上一章已经将核心的环境给安装了接下来我们可进行jenkins的流水线配置
> 这里开始配置的前提,需要将推荐插件下载,不安装插件流水线的功能都没有,同时检测`Publish Over SSH`插件是否已经安装,需要这个插件进行远程执行命令
## 配置凭据
我们需要先将密钥配置好因为我们等下的流水线的git拉去代码要将密钥进行登录
`系统管理/凭据/系统/全局凭据 (unrestricted)`中添加一个用户名和密码的凭据这里我们可以填写我们git仓库的的账号即可
## 配置免密登录
这一步至关重要,由于我们会远程向其他服务器执行命名,需要先配置免密登录。
通常来说jenkins只做拉去代码打包发布成可执行的包至于执行包发布给谁可以通过ssh发送对应的服务器只需要收到包解压然后直接启动即可如果服务器资源不够也可以考虑`127.0.0.1`当远程服务器
``` shell
#获取rsa密钥对
ssh-keygen -t rsa\
#将密钥进行拷贝
ssh-copy-id -i /root/.ssh/id_rsa.pub root\@localhost
```
按以上的提示一步一步回车即可
如果提示命令没有找到需安装openssh客户端
``` shell
yum -y install openssh-clients\
```
## Publish over SSH配置
由于我们使用到这个插件进行命令与文件的传输
需要在`系统管理/System/Publish over SSH`中进行配置这个插件
主要就是针对的上方的免密登录功能
以下详细介绍每一个配置吧~
``` shell
name: 只是一个标识
Hostname: 远程ip如果是本机可以localhost
Username远程登录用户名可以root
Remote Directory远程传输根目录待会传输文件的目录会拼接上这个我是习惯传输到/home下所以可以填写/home
Key 输入框粘贴 `/root/.ssh/id_rsa` 中的密钥,全部都要粘贴进去哦~
```
保存之前,可以进行测试,看以下是否成功!
## 环境变量配置
如果之前配置的环境变量不是系统环境变量需要单独为jenkins赋上
不然执行命令将提示命令未找到主要是dotnet与npm
我们可以在`系统管理/System`中的全局属性下有一个`环境变量`
``` shell
key: PATH
value: /usr/share/Modules/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin:/opt/dotnet:/opt/nodejs/node-v18.13.0-linux-x64/bin
```
### 后端脚本编写
有了环境我们可以将我们的代码手动发布上传测试一下是否可以手动执行dotnet运行如果成功将说明环境安装成功
之后,我们可以写两个脚本,一个启动、一个关闭,放到我们的程序入口,关于程序的启动和关闭,可以由脚本来控制会减少很多的问题及困难
我们其实已经在程序里带出来了,就是框架中的`start.sh`及`end.sh`
``` shell
#!/bin/bash
./end.sh
nohup dotnet Yi.Abp.Web.dll > /dev/null 2>&1 &
echo "Yi-启动成功!"
#!/bin/bash
kill $(lsof -t -i:19001)
echo "Yi-进程已关闭"
```
编写启动和停止脚本,我们还要给它赋值权限,否则不是一个有效的执行文件
``` shell
chmod +x start.sh
chmod +x end.sh
```
> 这里如果提示unix编码问题 ^M
可以使用vim进行转码
``` shell
vim test.sh
:set ff=unix
:wq
```
## 流水线编写
好了,到了这步,如果你一切顺利,恭喜你,准备进入流水线的脚本编写了
> 心急吃不了热豆腐,我们得静下心来,这块需要慢慢配置,一点一点调试
首页->新建任务->流水线
> 以下脚本为Yi框架的cicd脚本后端与前端及各个项目是不一样
我这里已经将脚本编写好,可根据实际情况进行更改,主要是密钥和授权等
### 后端流水线脚本:
``` java
pipeline {
agent any
stages {
stage('git') {
steps {
git branch: 'abp', credentialsId: '38c9c74f-8658-4b8d-9ee7-d4c9923ef042', url: 'https://gitee.com/ccnetcore/Yi.git'
echo '仓库克隆成功'
}
}
stage('build') {
steps {
sh """
cd Yi.Abp.Net8/src/Yi.Abp.Web;
dotnet publish -c Release;
"""
echo '构建成功'
}
}
stage('zip') {
steps {
sh """
mkdir -p ./publish
7za a ./publish/publish_01.zip ./Yi.Abp.Net8/src/Yi.Abp.Web/bin/Release/net8.0/publish/*;
"""
echo '压缩包成功'
}
}
stage('publish') {
steps {
sshPublisher(publishers: [sshPublisherDesc(configName: 'ccnetcore', transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand: '''cd /home/yi/net8
echo 开始解压
unzip -o /home/yi/build/publish_01.zip -d ./
echo 开始启动
sh start.sh
echo 启动成功''', execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator: '[, ]+', remoteDirectory: 'yi/build', remoteDirectorySDF: false, removePrefix: 'publish', sourceFiles: 'publish/publish_01.zip')], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: true)])
echo '发布成功'
}
}
}
}
```
### 前端rbac脚本
``` shell
pipeline {
agent any
stages {
stage('git') {
steps {
git branch: 'abp', credentialsId: '38c9c74f-8658-4b8d-9ee7-d4c9923ef042', url: 'https://gitee.com/ccnetcore/Yi.git'
echo '仓库克隆成功'
}
}
stage('build') {
steps {
sh """
cd Yi.RuoYi.Vue3;
npm config set registry https://registry.npm.taobao.org;
npm i;
npm run build:prod;
"""
echo '构建成功'
}
}
stage('zip') {
steps {
sh """
mkdir -p ./publish
7za a ./publish/publish_rbac_01.zip ./Yi.RuoYi.Vue3/dist/*;
"""
echo '压缩包成功'
}
}
stage('publish') {
steps {
sshPublisher(publishers: [sshPublisherDesc(configName: 'ccnetcore', transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand: '''cd /home/yi/rbac
echo 开始解压
unzip -o /home/yi/build/publish_rbac_01.zip -d ./
echo 替换完成''', execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator: '[, ]+', remoteDirectory: 'yi/build', remoteDirectorySDF: false, removePrefix: 'publish', sourceFiles: 'publish/publish_rbac_01.zip')], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: true)])
echo '发布成功'
}
}
}
}
```
### 前端bbs脚本
``` shell
pipeline {
agent any
stages {
stage('git') {
steps {
git branch: 'abp', credentialsId: '38c9c74f-8658-4b8d-9ee7-d4c9923ef042', url: 'https://gitee.com/ccnetcore/Yi.git'
echo '仓库克隆成功'
}
}
stage('build') {
steps {
sh """
cd Yi.Bbs.Vue3;
npm config set registry https://registry.npm.taobao.org;
npm install;
npm run build;
"""
echo '构建成功'
}
}
stage('zip') {
steps {
sh """
mkdir -p ./publish
7za a ./publish/publish_bbs_01.zip ./Yi.Bbs.Vue3/dist/*;
"""
echo '压缩包成功'
}
}
stage('publish') {
steps {
sshPublisher(publishers: [sshPublisherDesc(configName: 'ccnetcore', transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand: '''cd /home/yi/bbs
echo 开始解压
unzip -o /home/yi/build/publish_bbs_01.zip -d ./
echo 替换完成''', execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator: '[, ]+', remoteDirectory: 'yi/build', remoteDirectorySDF: false, removePrefix: 'publish', sourceFiles: 'publish/publish_bbs_01.zip')], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: true)])
echo '发布成功'
}
}
}
}
```
编写完成之后,可以逐步一下一下进行测试,看看哪里有问题再进行更改
> 以上脚本,都是一步一个脚印,一晚一行代码磨出来的,比较适合现在的场景,可推荐使用,坑比较少
## 进阶
后续,你可以尝试`gitlab+jenkins+harbor+docker+k8s`的路线这块橙子也是搭建过好几次但需求点过于多比较费劲同时一般只有非常大型的项目才用的上再次就不过多赘述了想讲实战讲清楚估计是当前篇幅至少10倍以上里面的坑我之前pdf简单汇总了一次大概就有23面以上现在可能很有很多工具安装应该没有那么简单了不过我还暂时没有去接触的场景如果你想像我一样可以一起播撒这颗种子让更多人的收获
## 结语
可以看的出来一个大家认为很简答的cicd如果像从零开始一下一下搭建出来坑还是蛮多的爬出这些坑也是比较费事并没有网上说的那么容易
本人这种环境搭建不下10次以上也只是`无他,熟能生巧而已`
> 搞的多了,也就麻了,水来土挡,坑来我填
最后,如果你这边怀着激动心情,讲上述的过程全部跑成功了,那么恭喜你啦~我亲爱的朋友,这篇文章教程就有它真正的意义了!