写在开篇
关于上篇
本篇在 《上篇:带你手工体验从写代码、编译、打包镜像、部署到K8S的全过程》 的基础上,将手动的过程通过jenkins工具将其改造成自动化。
环境准备
我的环境说明:
组件 | 安装方式 | 访问IP | 访问端口 |
---|---|---|---|
jenkins | docker | 192.168.11.254 | 8086 |
gitlab | docker | 192.168.11.254 | 8088 |
harbor | docker | 192.168.11.254 | 8081 |
上面的3个组件均以docker的方式安装在同一台宿主机上,且是在k8s集群外部。即使Jenkins、GitLab、Harbor都部署在K8S集群外部,也是可以将Go web项目发布到K8S集群中的。那么,关于如何安装上面的组件,可参考我之前发布过的文章 《云原生下的CICD-3件套快速搭建合集:jenkins+harbor+gitlab》。
当然也可以将CICD的相关组件部署在K8S集群内部,这些内容后面有时间的时候再作分享。
制作jenkins镜像
因jenkinsci/blueocean镜像中没有安装go和kubectl,因此基于它来重新制作一个新的镜像,把go和kubectl安装好。
- 从jenkinsci/blueocean镜像启动jenkins容器
[root@workhost jenkins]# docker run -d -u root --name jenkins-ser01 --restart=always -p 8086:8080 -p 50000:50000 -v /data/jenkins/data:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock jenkinsci/blueocean
- 将准备好的kubectl工具拷贝到容器里面
# 我的宿主机已经有kubectl二进制包
[root@workhost jenkins]# docker cp /usr/local/bin/kubectl jenkins-ser01:/bin/kubectl
# 拷贝后进入容器检查能否正常执行
bash-5.1# kubectl version
WARNING: This version information is deprecated and will be replaced with the output from kubectl version --short. Use --output=yaml|json to get the full version.
Client Version: version.Info{Major:"1", Minor:"25", GitVersion:"v1.25.4", GitCommit:"872a965c6c6526caa949f0c6ac028ef7aff3fb78", GitTreeState:"clean", BuildDate:"2022-11-09T13:36:36Z", GoVersion:"go1.19.3", Compiler:"gc", Platform:"linux/amd64"}
Kustomize Version: v4.5.7
- 进入容器编译安装golang
由于jenkins镜像是基于Alpine Linux的,需要从源代码编译安装go,不然其它发行版的二进制包是不能直接使用的
# 进入容器
[root@workhost jenkins]# docker exec -it jenkins-ser01 bash
# 编译安装golang
bash-5.1# export GOARCH=amd64
bash-5.1# export GOOS=linux
bash-5.1# wget https://go.dev/dl/go1.20.4.src.tar.gz
bash-5.1# tar -zxf go1.20.4.src.tar.gz
bash-5.1# apk add --no-cache --virtual .build-deps bash gcc go musl-dev
bash-5.1# export GOROOT_BOOTSTRAP="$(go env GOROOT)" GOHOSTOS="$GOOS" GOHOSTARCH="$GOARCH"
bash-5.1# cd ./go/src
bash-5.1# ./make.bash
bash-5.1# go install std
# 查看版本
bash-5.1# which go
/usr/bin/go
bash-5.1#
bash-5.1# go version
go version go1.18.7 linux/amd64
# 清理现场和退出容器
bash-5.1# cd /
bash-5.1# rm -rf go go1.20.4.src.tar.gz
bash-5.1# exit
exit
- 从容器提交镜像并推送到harbor
[root@workhost jenkins]# docker commit jenkins-ser01 192.168.11.254:8081/jenkins/jenkins:20230505v1
sha256:34685da4c262a14229d4aee5de9a294a877f4974c68f2bcff5e57d3f1420f101
[root@workhost jenkins]# docker push 192.168.11.254:8081/jenkins/jenkins:20230505v1
The push refers to repository [192.168.11.254:8081/jenkins/jenkins]
334b6fe88500: Pushing [====> ] 78.86MB/838.3MB
18df88a5f0e3: Pushed
704921b7ee47: Pushing [====================> ] 94.57MB/235MB
...
...
- 最后就可以删掉这个容器
[root@workhost jenkins]# docker stop jenkins-ser01
jenkins-ser01
[root@workhost jenkins]# docker rm jenkins-ser01
jenkins-ser01
- 从制作好的镜像启动jenkins容器
[root@workhost jenkins]# docker run -d -u root --name jenkins-ser01 --restart=always -p 8086:8080 -p 50000:50000 -v /data/jenkins/data:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock 192.168.11.254:8081/jenkins/jenkins:20230505v1
a052d6f503d6ef9a90d8cc99bf606daa92b5c890a8bff885d2b189fa1174492a
[root@workhost jenkins]#
[root@workhost jenkins]# docker ps -a | grep jenk
a052d6f503d6 192.168.11.254:8081/jenkins/jenkins:20230505v1 "/sbin/tini -- /usr/…" 7 seconds ago Up 6 seconds 0.0.0.0:50000->50000/tcp, :::50000->50000/tcp, 0.0.0.0:8086->8080/tcp, :::8086->8080/tcp jenkins-ser01
[root@workhost jenkins]#
[root@workhost jenkins]# docker exec -it jenkins-ser01 bash
bash-5.1# go version
go version go1.18.7 linux/amd64
bash-5.1# kubectl version
WARNING: This version information is deprecated and will be replaced with the output from kubectl version --short. Use --output=yaml|json to get the full version.
Client Version: version.Info{Major:"1", Minor:"25", GitVersion:"v1.25.4", GitCommit:"872a965c6c6526caa949f0c6ac028ef7aff3fb78", GitTreeState:"clean", BuildDate:"2022-11-09T13:36:36Z", GoVersion:"go1.19.3", Compiler:"gc", Platform:"linux/amd64"}
Kustomize Version: v4.5.7
构建方式的选择
在 Jenkins 中,Freestyle Project 和 Pipeline 都是常用的构建作业类型,它们都可以用来实现自动化构建和持续集成,但它们的应用场景略有不同,还是得提前了解一下:
- 如果项目比较简单,例如只需要执行一些 Shell 命令、构建 Maven 项目、执行 Ant 构建等简单操作,那么使用 Freestyle Project 就可以满足需求,因为 Freestyle Project 的配置界面非常简单,可以快速地完成配置和构建。
- 如果项目比较复杂,例如需要处理多个 Git 仓库、执行多个步骤、分支流程等,那么使用 Pipeline 可能更加适合,因为 Pipeline 具有灵活的流程控制能力,可以支持复杂的项目构建过程。同时,Pipeline 也支持以代码的形式进行定义,具有更好的可维护性和可重用性。
建议根据项目的具体需求,选择使用适合的构建方式。通过对这两种构建方式的了解,相信你已经知道了哪种合适自己了。当然,还有其它的构建方式,比如“多分支流水线”等等,这些以后用到了再去了解吧。
涉及到的插件
下面的插件是我以后要用到的,先提前安装好。本次打算先用“自由软件风格项目”来发布goweb应用,有些插件在本篇还未用到,比如Pipeline,不过装上也无妨。因篇幅有限,本篇不讲如何安装插件,请自行安装好即可。
- Kubernetes:提供了在 Jenkins 中管理和部署应用程序到 Kubernetes 集群的能力。
- Kubernetes CLI:提供了在 Jenkins 中使用 kubectl 命令行工具与 Kubernetes 集群交互的能力。
- Git:用于在 Jenkins 中集成 Git 版本控制系统。
- Docker:用于在 Jenkins 中构建和推送 Docker 镜像。
- Credentials:用于在 Jenkins 中配置和管理 GitLab 和 Harbor 的认证凭据。
- Config File Provider
- Pipeline:用于在 Jenkins 中创建和管理流水线(Pipeline)作业。
- Go:是一个官方支持的Jenkins插件,它提供了构建和部署Go应用程序的能力。
提示:如果只需要使用 kubectl 命令行工具与 Kubernetes 集群交互,那么只需要安装 Kubernetes CLI 插件即可。如果需要在 Jenkins 构建管道中使用 Kubernetes 插件提供的更丰富的功能和 Jenkins 语法来管理 Kubernetes 资源,那么需要安装 Kubernetes 插件。在这里,我先把两个都安装上。
goweb项目结构
[root@workhost goweb]# tree
.
├── Dockerfile
├── go.mod
├── main.go
├── README.md
└── static
└── login.html
[root@workhost goweb]#
Dockerfile代码:
FROM alpine:latest
WORKDIR /app
COPY static /app/static
COPY main /app
EXPOSE 80
CMD ["./main"]
将dockerfile和项目代码一并提交到gitlab:
git add .
git commit -m "add code"
git push
提交后:
在jenkins发布goweb
- 凭据准备
装备好k8s、gitlab、harbor的凭据
![图片]()
连接k8s的凭据,我直接上传了kubeconfig文件:
![图片]()
- 创建自由风格的软件项目
![图片]()
- 在参数化构建选项中准备好要用到的参数
- VERSION:这个变量我打算用来作为发布版本的用途,当构建镜像时,会作为镜像的标签
- HARORB_ADMIN_PASSWD:因为推送镜像时我用到是shell命令的方式,登录harbor的时候引用这个密码变量
- 源码管理,配置git
这里要注意指定分支,我的是 “/main”,在gitlab上进入代码仓库里可看到。
- 在构建环境中配置连接k8s
- 构建步骤中配置编译go代码
![图片]()
- 构建步骤中配置构建镜像和推送镜像
![图片]()
- 构建步骤中,配置创建deployment和service
cat
- 开始运行构建任务
![图片]()
- 到k8s上检查
[root@k8s-b-master ~]# kubectl get deployment,pod,svc
NAME READY UP-TO-DATE AVAILABLE AGE
deployment.apps/goweb 6/6 6 6 73m
NAME READY STATUS RESTARTS AGE
pod/goweb-d59b979bb-2xrxm 1/1 Running 0 58s
pod/goweb-d59b979bb-jllgt 1/1 Running 0 56s
pod/goweb-d59b979bb-nd8dl 1/1 Running 0 56s
pod/goweb-d59b979bb-prl7m 1/1 Running 0 55s
pod/goweb-d59b979bb-r5csh 1/1 Running 0 58s
pod/goweb-d59b979bb-t2v5n 1/1 Running 0 58s
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
service/goweb NodePort 10.96.6.121 5678:30080/TCP 55m
service/kubernetes ClusterIP 10.96.0.1 443/TCP 8d
[root@k8s-b-master ~]#
- 访问
最后
本次采用的是Freestyle Project的构建方式,这是最常见,也是比较传统的方式。下次在k8s部署 jenkins 主从架构,并以 Pipeline 的方式来构建发布。
本文转载于WX公众号:不背锅运维(喜欢的盆友关注我们):https://mp.weixin.qq.com/s/yJ6rkYrwn8RAMLt5uCF9mw
服务器托管,北京服务器托管,服务器租用 http://www.fwqtg.net