摘要:828 B2B企业节特惠来袭,Flexus X实例引领自动化部署新纪元!Docker携手Jenkins与Gitee,共创CICD无限可能!在快速迭代的数字时代,我们自豪地推出这一前沿解决方案,为您的C# Web API项目注入前所未有的敏捷动力。通过集成Doc
前言
828 B2B企业节特惠来袭,Flexus X实例引领自动化部署新纪元!Docker携手Jenkins与Gitee,共创CICD无限可能!在快速迭代的数字时代,我们自豪地推出这一前沿解决方案,为您的C# Web API项目注入前所未有的敏捷动力。通过集成Docker容器化技术、Jenkins持续集成/持续部署(CICD)平台,以及Gitee高效版本控制系统,我们旨在打造一个无缝衔接的开发到部署流水线,让您的项目在数字化转型的浪潮中乘风破浪,遥遥领先!
一个高度自动化的环境,每一次代码提交都能触发自动化的构建、测试与部署流程。在这个流程中,Docker确保了应用运行环境的标准化与一致性,无论本地开发还是云端部署,都能享受到“所见即所得”的便捷;Jenkins作为强大的CICD引擎,自动化地管理着整个流程,从代码拉取、编译构建到部署发布,每一步都精准无误;而Gitee,作为您的代码仓库,不仅提供了安全的版本控制服务,还通过集成Jenkins触发器,实现了代码变更与部署流程的即时联动。
本实践指南将带您深入探索Docker+Jenkins+Gitee的完美结合,一步步构建起一套高效、可靠的CICD自动化部署体系。您将学会如何配置Jenkins以监听Gitee的Webhooks,实现代码提交的即时响应;如何利用Docker容器快速打包并运行您的C# Web API应用;以及如何通过Jenkins脚本化地管理整个部署流程,包括环境配置、依赖安装、测试执行与部署发布等关键环节。
实验步骤
环境准备
本实验沿用了上一个实验,环境是Flexus X实例自定义模式,使用了4vCPUs | 12GiB,镜像是最高版本的ubuntu,在上一个实验中使用xshell连接了服务器,随后在服务器中安装了git、dokcer。这里就不重复介绍了,可自行操作或参考上一个实验!
828华为云征文|Flexus X实例C#/.Net Core 结合(git代码管理、docker自定义镜像)快速发布部署-让你的项目飞起来~-CSDN博客
安装Portainer
介绍:
Portainer是一款开源的轻量级管理UI,旨在简化Docker和Kubernetes环境的管理。Portainer提供了状态显示面板、应用模板快速部署、容器镜像网络数据卷的基本操作(包括上传下载镜像,创建容器等操作)、事件日志显示、容器控制台操作、Swarm集群和服务的集中管理和操作等功能。这些功能基本能满足中小型单位对容器管理的全部需求。
拉取镜像
使用Docker命令拉取Portainer的Docker镜像:
docker pull portainer/portainer-ce
拉取镜像报错了!!!在尝试从 Docker 镜像仓库(如 Docker Hub)获取镜像时遇到了问题。我们可能需要配置 Docker 以使用国内的镜像源,因为直接访问 Docker Hub 有时可能会很慢或不稳定
更换镜像源
在Linux系统中,Docker的配置文件通常位于/etc/docker/daemon.json。如果该文件不存在,则需要手动创建。
从查询结果来看,我目前并没有这个文件,下面我自己创建一个!
// 创建文件
cd etc/docker
touch daemon.json
//编辑文件
vim daemon.json
// 在文件中输入以下内容 注意:刚打开文件要输入i才可以进入编辑模式
{
"registry-mirrors": [
"https://gallery.ecr.aws/",
"https://gitverse.ru/docs/artifactory/gitverse-registry/",
"https://docker.lmirror.top",
"https://atomhub.openatom.cn/"
]
}
// 退出编辑模式,从插入模式回到普通模式,只需要按下 Esc 键
// 退出 Vim
// 修改完成后我们需要完全退出 Vim 编辑器,可以使用以下命令:
:q //如果没有做任何修改,则退出 Vim。
:q! //强制退出 Vim,不保存任何修改。
:wq 或 :x //保存修改并退出 Vim。
:ZZ //和 :wq 一样,保存修改并退出 Vim,但更简短。
接下来我们重启docker服务
[root@localhost]# systemctl daemon-reload
[root@localhost]# systemctl restart docker
再次拉取Portainer的Docker镜像,此时已经可以正常拉取了!
启动容器
执行下面命令运行Portainer容器
docker run -d -p 9000:9000 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /var/lib/docker/volumes:/var/lib/docker/volumes portainer/portainer-ce
运行容器后,去华为服务器控制台开放我们的9000端口
使用我们的服务器IP地址+端口号,访问可视化界面,第一次访问需要配置账号密码
点击LiveConnect打开本地docker,可以查看宿主机配置信息、查看容器、镜像、网络、卷等相关信息。
安装jenkins
介绍:
Jenkins是一个开源的持续集成和持续部署(CI/CD)工具,它支持各种编程语言和平台,广泛应用于软件开发和交付过程中。Jenkins可以监视源代码仓库(如Git、SVN等)的变化,并在代码提交后自动执行构建过程,包括编译、测试和打包等步骤。
拉取镜像
使用docker pull jenkins/jenkins:lts命令拉取Jenkins的长期支持(LTS)版本镜像
运行容器
# 在宿主机上创建一个目录,用于存放Jenkins的数据
mkdir -p /var/jenkins_home
# 为了确保Jenkins容器能够正常访问该目录,需要设置适当的权限
chmod 777 /var/jenkins_home
# 启动容器
docker run -d --name myjenkins -p 8080:8080 -p 50000:50000 -v /var/jenkins_home:/var/jenkins_home -v /etc/localtime:/etc/localtime -v /usr/bin/docker:/usr/bin/docker -v /var/run/docker.sock:/var/run/docker.sock --restart=always jenkins/jenkins:lts
# 参数说明:
-d:以后台模式运行容器。
--name myjenkins:为容器指定一个名称。
-p 8080:8080:将容器的8080端口映射到宿主机的8080端口,用于访问Jenkins的Web界面。
-p 50000:50000:将容器的50000端口映射到宿主机的50000端口,用于Jenkins的节点和主控节点之间的通信。
-v /var/jenkins_home:/var/jenkins_home:将宿主机的/var/jenkins_home目录挂载到容器的/var/jenkins_home目录,用于持久化Jenkins的数据。
-v /etc/localtime:/etc/localtime:将宿主机的时区文件挂载到容器内,确保容器内的时间与宿主机一致。
-v /usr/bin/docker:/usr/bin/docker 和 -v /var/run/docker.sock:/var/run/docker.sock:允许容器内的Jenkins使用宿主机的Docker命令和Docker引擎。
--restart=always:设置容器在退出时总是自动重启。
执行完后使用docker ps命令查看正在运行的容器列表,确认Jenkins容器已经启动。
老样子,开放8080端口,ip+端口访问页面!
获取管理员密码
第一次访问需要输入管理员密码,我们有两种方法可以获取到密码!
查看日志:使用docker logs myjenkins命令查看Jenkins容器的输出日志,找到包含管理员密码的行。
直接查看文件:也可以在宿主机的/var/jenkins_home/secrets/initialAdminPassword文件中找到管理员密码。
这里我直接打开刚刚安装的portainer界面,找到容器,点击日志图标!
如下所示 Please use the following password to proceed to installation: 的下面一行就是密码!
选择安装建议安装的插件!
安装插件需要等待一会~~~
安装完成后系统提示我们创建一个新用户,这里我选择使用admin用户继续!
在设置中安装Gitee插件
点击New Item 创建一个新任务!
新建流水线项目
Portainer配置
然后选择第一种任务模式,自由风格软件项目
在源代码管理Source Code Management中选择Git,打开gitee找到自己需要部署的仓库,复制地址。
粘贴到Repository URL 中,第一次创建Credentials 是空的,我们点击下面的add新建一个,
新建Credentials 时我们只需要填写Username和Password,其他空着就好!
username就是刚刚打开gitee项目时如下图框框位置,然后password官方是建议使用私人令牌的,直接点击蓝色字体参考步骤生成私人令牌复制过来就好了!
Branches to build 选择你当前仓库要构建的分支,我这里默认是master分支
在这里可以选择远程触发构建,代码变更构建,定时构建等等,我这里选择的是Build when a change is pushed to Gitee,当gitee上的代码发送推送时触发构建!
勾选之后,滑到下面,点击Generate,会生成一条密码。注意(这里的上图的Webhook和下面生成的密码都要记录下来,稍后我们要配置到gitee上)
Build Environment中我们勾选第一个,每次构建前删除之前的工作区,以节省内存。
在Build Steps中我们选择新增一个Execute shell,编写命令来管理容器和镜像。
输入如下代码!
下面是对代码的解释,可以根据自己的项目差异进行调整!
# 将当前工作目录更改为 Jenkins 的一个特定工作空间
cd /var/lib/jenkins/workspace/auth_server
# 强制删除所有已停止的 Docker 容器
docker container prune -f
# 列出所有 Docker 容器(包括未运行的),然后通过管道 将输出传递给 grep "auth"
docker container ls -a | grep "auth"
if [ $? -eq 0 ];then
# 如果存在名为 auth 的容器,并且该容器正在运行,这条命令将停止该容器。
docker container stop auth
# 这条命令删除名为 auth 的容器
docker container rm auth
fi
# 强制删除所有未使用的 Docker 镜像
docker image prune -f
# 构建一个新的 Docker 镜像
docker build -t auth .
# 启动容器
docker run -d -p 5000:5000 --restart=always --name auth auth
gitee配置WebHooks
打开代码仓库,在管理中找到WebHooks,点击添加WebHook
将上面Jenkins项目设置中的Gitee webhook URL和Gitee Webhook 密码复制下来,填进去!
注意:因为Gitee中的bug,就算配置成功了,测试WebHook也会出现404错误,不要着急,稍后我们去修改一下代码提交一次!
构建
修改完配置之后,我们先手动进行构建一次,测试一下,点击项目中的build Now。
在下面会出现每一次的构建记录,点击最新的一次,再点击Console Output,可以查看我们的构建日志。由下图可见,我此次构建失败了!!!
从报错信息看出,这个错误信息表示在执行 Jenkins 构建任务时,尝试连接到 Docker 守护进程的 Unix 套接字(/var/run/docker.sock)时遇到了权限问题。因此,构建任务失败。
要解决这个问题,需要确保 Jenkins 用户具有访问 Docker 守护进程的权限。
打开终端并输入以下命令以创建名为 'jenkins' 的用户
sudo adduser jenkins
将 'jenkins' 用户添加到 'docker' 组
sudo usermod -a -G docker jenkins
在编辑完成后,需要重新加载 systemd 配置以使更改生效。运行以下命令:
sudo systemctl daemon-reload
重启 Docker 服务以应用新的配置:
sudo systemctl restart docker
如果上述方法不起作用,可以尝试更改/var/run/docker.sock的权限,使其对所有用户可读写。执行以下命令:
sudo chmod 666 /var/run/docker.sock
请注意,这种方法可能会带来安全风险,因为它允许所有用户访问Docker守护进程。在生产环境中,建议仅将特定用户添加到docker用户组。
构建成功!
打开Portainer看一下,虽然容器与宿主机映射的是5000端口,但其实因为我们没有给.net项目配置端口,实际上默认还是8080,这样会与jenkins的默认端口冲突,因此我们修改一下代码!
修改代码,自动部署
"Kestrel": {
"EndPoints": {
"Http": {
"Url": "http://+:5000"
}
}
}
因为我们之前已经配置好了,在代码提交之后,会自动发送一个请求到我们的jenkins
然后jenkins就会自动开启构建任务了
老样子,开放5000端口!
访问一下我们的接口,成功!
来源:互联网播客