目录

前言

实验步骤

环境准备

安装Portainer

拉取镜像

更换镜像源

启动容器

安装jenkins

拉取镜像

获取管理员密码

新建流水线项目

Portainer配置

gitee配置WebHooks

构建

修改代码,自动部署


前言

🚀 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+端口访问页面!

获取管理员密码

第一次访问需要输入管理员密码,我们有两种方法可以获取到密码!

  1. 查看日志

使用docker logs myjenkins命令查看Jenkins容器的输出日志,找到包含管理员密码的行。

  1. 直接查看文件

也可以在宿主机的/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的默认端口冲突,因此我们修改一下代码!

修改代码,自动部署

在appsetting中加入配置,提交代码!

  "Kestrel": {
    "EndPoints": {
      "Http": {
        "Url": "http://+:5000"
      }
    }
  }

因为我们之前已经配置好了,在代码提交之后,会自动发送一个请求到我们的jenkins

然后jenkins就会自动开启构建任务了

老样子,开放5000端口!

访问一下我们的接口,成功!

Logo

助力广东及东莞地区开发者,代码托管、在线学习与竞赛、技术交流与分享、资源共享、职业发展,成为松山湖开发者首选的工作与学习平台

更多推荐