本文jenkins部署golang项目流程
- jenkins服务拉取github上的项目
- 构建golang项目并生成docker镜像[
jenkins调用的是宿主机上的docker环境
,如何调用的,后面会说明] - 启动golang项目的docker镜像
docker的安装这里就不说了
docker安装jenkins
Makefile
run:
docker run \
-u root \
-d \
-p 8088:8080 \
-p 50000:50000 \
-e TZ="Asia/Shanghai" \
-v /Users/chen/data/docker/jenkins:/var/jenkins_home \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /usr/local/bin/docker:/usr/bin/docker \
--name jenkins \
jenkins/jenkins:lts
说明:
-v /Users/chen/data/docker/jenkins:/var/jenkins_home
挂载jenkins的home目录,jenkins安装的插件,拉取的项目代码都在这个目录里
-v /var/run/docker.sock:/var/run/docker.sock
与-v /usr/local/bin/docker:/usr/bin/docker
挂载这两个文件就能在docker容器内访问宿主机上的docker。官方文档里有说明
执行make来安装jenkins
make run
- 安装后访问
http://127.0.0.1:8088/login
- 获取登录密码
docker exec -it jenkins cat /var/jenkins_home/secrets/initialAdminPassword
- 选择“选择插件来安装”[ 插件安装很慢,参考 Jenkins安装插件提速]
- 选择插件
Localization: Chinese (Simplified)
Docker
Github
Go
SSH
- 添加凭据[Jenkins>凭据>系统>全局凭据]
用于拉取github上的代码
需要在jenkins容器里生成ssh
# 进入容器
docker exec -it jenkins bash
# 生成ssh,一路回车就行了
ssh-keygen -t rsa
# 获取密钥,下图Private Key的值
cat ~/.ssh/id_rsa
# 获取公钥,加入到github的 SSH keys 里
cat ~/.ssh/id_rsa.pub
-
全局工具配置[Jenkins>全局工具配置]
-
创建任务
(1). 创建任务
(2). 设置参数与源码管理。VERSION会在构建docker容器时用到,相当项目版本号;Git> Credentialst选择第5步
创建的凭据
(3). 构建环境与构建
Dockerfile
FROM alpine:latest
RUN mkdir -p /app
WORKDIR /app
ADD main /app/main
EXPOSE 9999
CMD ["./main"]
cd $WORKSPACE
export GOPROXY=https://goproxy.io
go mod tidy
# 打印依赖,部署成功后查看版本依赖是否如预期
cat ./go.mod
cd ./app/test/http
# linux环境编译
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o main
# 构建docker镜像,项目中需要在当前目录下有dockerfile,否则构建失败
docker build -t qicmsg/test/demo:$VERSION .
rm -rf main
docker rm http_test -f
docker run --name http_test -p 9999:9999 -d qicmsg/test/demo:$VERSION
- 开始构建项目
到这里整体流程就走完了。docker container ls
就能看到刚启动的容器了。
注:在实际中,通常是jenkins是一台服务器,运行golang项目的是一台独立的服务器(集群可以用k8s来部署)。在jenkins构建项目后,构建docker镜像
docker build
并提交到docker仓库docker push
。然后在7.(3)
步的构建后操作
通过ssh来执行远端命令部署项目