腾讯云 CVM + Docker + Jenkins + GitLab CI/CD 全流程指南（python、flask实现简单计算器）

腾讯云 CVM Docker Jenkins GitLab CI/CD 全流程指南适用场景个人学习 / 体验 CI/CD 流程总耗时约 2~3 小时含 CVM 创建等待时间预算腾讯云 CVM 按量计费约 0.4~0.5 元/小时文章目录腾讯云 CVM Docker Jenkins GitLab CI/CD 全流程指南1. 架构概览2. 第一步创建腾讯云 CVM 实例2.1 登录腾讯云控制台2.2 推荐配置2.3 安全组配置3. 第二步连接 CVM 并安装 Docker3.1 SSH 登录3.2 安装 Docker官方脚本最快最稳4. 第三步Docker 部署 Jenkins4.1 创建 Jenkins 数据目录4.2 启动 Jenkins 容器4.3 确认 Jenkins 正在运行5. 第四步Jenkins 初始化配置5.1 访问 Jenkins Web UI5.2 获取初始管理员密码5.3 安装推荐插件5.4 创建管理员账户5.5 实例配置6. 第五步GitLab.cn 创建项目并推送代码6.1 注册/登录 GitLab.cn6.2 创建新项目6.3 获取项目地址6.4 生成 GitLab Personal Access Token6.5 从本地推送 Demo 项目6.6 验证7. 第六步Jenkins 配置 GitLab 集成7.1 安装必要插件7.2 添加 GitLab 凭据7.3 配置 GitLab 服务器连接8. 第七步创建 Jenkins Pipeline 任务8.1 新建 Pipeline 任务8.2 配置 PipelineGeneral 部分Build Triggers 部分8.3 Pipeline 定义9. 第八步触发 CI/CD 并验证9.1 方式一手动触发先试这个9.2 方式二Git Push 自动触发配置 Webhook9.3 验证自动触发10. 附Python Demo 项目文件清单快速本地验证在 WSL 中视频演示常见问题排查Q1: Jenkins 页面打不开Q2: Jenkins Pipeline 报 docker: command not foundQ3: git push 到 GitLab.cn 失败Q4: Webhook 不生效清理资源重要源码下载1. 架构概览┌──────────────┐ push code ┌──────────────┐ │ GitLab │ ──────────────────▶│ Jenkins │ │ (代码仓库) │ webhook 触发 │ (CI/CD 引擎) │ └──────────────┘ └──────┬───────┘ │ Docker 执行 │ ┌────────────┴────────────┐ │ ① Build (docker build) │ │ ② Test (pytest) │ │ ③ Deploy (echo) │ └─────────────────────────┘ │ ┌──────▼──────┐ │ 腾讯云 CVM │ │ (Ubuntu) │ └─────────────┘核心组件组件用途部署方式腾讯云 CVM运行 Jenkins 的服务器云控制台创建Docker容器运行时运行 Jenkins 和构建任务apt 安装JenkinsCI/CD 编排引擎Docker 容器GitLab源代码托管SaaS 平台Python Demo被构建和测试的项目Flask 应用2. 第一步创建腾讯云 CVM 实例2.1 登录腾讯云控制台打开 https://console.cloud.tencent.com/cvm 点击「新建」。2.2 推荐配置配置项推荐值说明计费模式按量计费体验用用完即删省钱地域任意如广州/上海跟着推荐走机型任意标准型 /2核4G以上Jenkins Docker 最低需求镜像Ubuntu 22.04 LTS稳定Docker 支持好系统盘高性能云硬盘 50GB默认即可网络子网选择要正确比如南京三区子网选择对应带宽按流量计费体验够用2.3 安全组配置关键步骤需要放行以下端口端口协议来源用途22TCP你的 IP建议SSH 连接8080TCP0.0.0.0/0Jenkins Web UI50000TCP0.0.0.0/0Jenkins Agent 通信嫌麻烦的直接安全组配置0.0.0.0/0 ALL⚠️ 安全提醒体验结束后建议将 8080 和 50000 的来源改回你的 IP 或直接删除安全组规则。3. 第二步连接 CVM 并安装 Docker3.1 SSH 登录# 从你的本地机器执行替换 YOUR_IP 和 YOUR_KEY.pemsshubuntu公网IP3.2 安装 Docker官方脚本最快最稳Ubuntu / Debiansudoaptupdatesudoaptinstall-yca-certificatescurlgnupg添加 Docker 官方 GPG keysudoinstall-m0755-d/etc/apt/keyringscurl-fsSLhttps://download.docker.com/linux/ubuntu/gpg|sudogpg--dearmor-o/etc/apt/keyrings/docker.gpgsudochmodar /etc/apt/keyrings/docker.gpg添加源./etc/os-releaseecho\deb [arch$(dpkg --print-architecture)signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \${VERSION_CODENAME}stable|\sudotee/etc/apt/sources.list.d/docker.list/dev/null安装 Dockersudoaptupdatesudoaptinstall-ydocker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin启动并设置开机自启sudosystemctlenable--nowdocker验证sudodockerrun hello-world# 如果失败先编辑下面的仓库如果不想每次都写sudosudo usermod -aG docker $USER然后执行newgrp docker查看docker ps仓库配置编辑/etc/docker/daemon.json{registry-mirrors:[https://docker.m.daocloud.io,https://xxx.mirror.aliyuncs.com,https://hub-mirror.c.163.com,https://mirror.baidubce.com,https://mirror.ccs.tencentyun.com],log-driver:json-file,log-opts:{max-size:10m,max-file:3}}# 重启服务sudosystemctl daemon-reloadsudosystemctl restartdocker# 阿里云的镜像自行获取4. 第三步Docker 部署 Jenkins4.1 创建 Jenkins 数据目录# Jenkins 数据持久化到宿主机容器删了数据还在mkdir-p~/jenkins_homesudochown1000:1000 ~/jenkins_home# Jenkins 容器内用 uid10004.2 启动 Jenkins 容器dockerrun-d\--namejenkins\--restartunless-stopped\-p8080:8080\-p50000:50000\-v~/jenkins_home:/var/jenkins_home\-v/var/run/docker.sock:/var/run/docker.sock\jenkins/jenkins:lts参数说明-d后台运行--restart unless-stopped开机自启-p 8080:8080Jenkins Web UI 端口-p 50000:50000Jenkins Agent 通信端口-v ~/jenkins_home:...数据持久化-v /var/run/docker.sock:...关键让 Jenkins 容器内可以调用宿主机的 DockerDocker-in-Docker 简化版4.3 确认 Jenkins 正在运行dockerps|grepjenkins# 应该看到 jenkins 容器状态为 Up5. 第四步Jenkins 初始化配置5.1 访问 Jenkins Web UI浏览器打开http://YOUR_CVM_IP:8080如果打不开检查安全组是否放行了 8080 端口5.2 获取初始管理员密码回到 SSH 终端执行dockerexecjenkinscat/var/jenkins_home/secrets/initialAdminPassword将输出的密码粘贴到 Web 页面的输入框中。5.3 安装推荐插件选择「Install suggested plugins」等待插件安装完成约 3~5 分钟。这一步会自动安装 Git、Pipeline、Docker 等核心插件。5.4 创建管理员账户按提示创建用户名admin密码自己设一个记住邮箱你的邮箱5.5 实例配置Jenkins URL 保持默认http://YOUR_IP:8080点击 Save and Finish。6. 第五步GitLab.cn 创建项目并推送代码6.1 注册/登录 GitLab.cn打开 https://gitlab.cn 注册或登录你的账号。6.2 创建新项目点击「New project」→「Create blank project」填写Project namecalculator-apiVisibility Level选Private或Public看你喜好点击「Create project」6.3 获取项目地址项目创建后页面顶部会显示 Git 地址例如https://gitlab.cn/your-username/calculator-api.git6.4 生成 GitLab Personal Access Token点击右上角头像 →「Preferences」左侧菜单「Access Tokens」填写Token namejenkins-ciExpiration date随便选个远的如 2027-01-01Scopes勾选read_repository和write_repository点击「Create personal access token」立即复制 Token页面刷新后就看不到了6.5 从本地推送 Demo 项目回到你的本地开发机或 WSL 终端项目文件已在/home/yl/ci-demo-project/目录中。cd/home/yl/ci-demo-project# 初始化 Gitgitinitgitadd.gitcommit-mfeat: init calculator API project# 关联远程仓库替换为你的地址gitremoteaddorigin https://gitlab.cn/YOUR_USERNAME/calculator-api.git# 推送到 GitLab会提示输入用户名和 Access Tokengitpush-uorigin main用户名填你的 GitLab 用户名密码填刚才生成的 Personal Access Token6.6 验证刷新 GitLab.cn 项目页面应该能看到所有文件app.py, Jenkinsfile, Dockerfile 等。7. 第六步Jenkins 配置 GitLab 集成7.1 安装必要插件回到 Jenkins Web UI →「Manage Jenkins」→「Plugins」→「Available plugins」搜索并安装GitLab PluginDocker Pipeline安装后重启 Jenkins或勾选「重启后安装」。7.2 添加 GitLab 凭据「Manage Jenkins」→「Credentials」→「System」→「Global credentials」点击「Add Credentials」填写KindGitLab API tokenAPI token粘贴 6.4 步生成的 Personal Access TokenIDgitlab-token自定义标识DescriptionGitLab API Token for calculator-api点击「Create」7.3 配置 GitLab 服务器连接「Manage Jenkins」→「Configure System」找到「GitLab」部分点击「Add」→「GitLab Servers」填写Server namejihulabURLhttps://jihulab.comCredentials选择刚才创建的gitlab-token点击「Test Connection」→ 应该显示「Success」保存8. 第七步创建 Jenkins Pipeline 任务8.1 新建 Pipeline 任务Jenkins 首页点击「New Item」输入名称calculator-api-pipeline选择「Pipeline」点击 OK8.2 配置 Pipeline在任务配置页面General 部分勾选「GitLab Connection」选择gitlab.cn勾选「This project is parameterized」(可跳过)Build Triggers 部分勾选「Build when a change is pushed to GitLab」勾选以下事件✅ Push Events✅ Merge Request Events点击「Advanced」在「Secret token」处点击「Generate」生成一个 Token复制这个 Secret token 值后面配置 webhook 要用然后点击页面底部的「Save」8.3 Pipeline 定义在「Pipeline」部分选择「Pipeline script from SCM」SCMGitRepository URLhttps://jihulab.com/ylqb1124/calculator-api.gitCredentialsUsername with passwordBranches to build*/mainScript PathJenkinsfile点击「Save」项目里已经有一个写好的JenkinsfilePipeline 会自动读取它。9. 第八步触发 CI/CD 并验证9.1 方式一手动触发先试这个在 Jenkins 任务页面点击「Build Now」观察构建过程。点击构建编号如 #1→「Console Output」你应该看到[Pipeline]stage(Build)Building Docker image...dockerbuild-tcalculator-api.[Pipeline]stage(Test)Running testsincontainer...dockerrun--rmcalculator-api pytest test_app.py-vtest_health PASSED test_add PASSED...8passed[Pipeline]stage(Deploy)Deploying calculator-api...[Pipeline]End of Pipeline Finished: SUCCESS注意这里很有可能会Failure这是因为容器内没有docker环境可以下载一个最小的二进制Docker环境dockerexec-uroot jenkinssh-c curl -fsSLo /tmp/docker.tgz https://mirrors.aliyun.com/docker-ce/linux/static/stable/x86_64/docker-27.5.1.tgz \ tar xzf /tmp/docker.tgz -C /usr/local/bin --strip-components1 随后给权限dockerexec-uroot jenkinssh-c # 把 docker.sock 的组改成 docker宿主机映射过来的可能需要这一步 chmod 666 /var/run/docker.sock 9.2 方式二Git Push 自动触发配置 Webhook回到 GitLab.cn 项目页面「Settings」→「Webhooks」填写URLhttp://YOUR_CVM_IP:8080/project/calculator-api-pipeline⚠️ 注意GitLab.cn 的 Webhook URL 必须是公网可访问的。如果你的 CVM 没有固定公网 IPwebhook 可能不生效但手动触发完全不受影响。Secret token粘贴 8.2 步生成的 Secret tokenTrigger勾选「Push events」取消勾选「Enable SSL verification」新手建议取消点击「Add webhook」点击「Test」→ 选择「Push events」如果返回 HTTP 200 即成功9.3 验证自动触发# 在你的本地项目里随便改点东西echo# test triggerREADME.mdgitaddREADME.mdgitcommit-mtest: trigger CI pipelinegitpush origin main回到 Jenkins应该看到一个自动触发的构建任务开始运行。10. 附Python Demo 项目文件清单项目目录/home/yl/ci-demo-project/ci-demo-project/ ├── app.py # Flask 计算器 API/add /subtract /multiply /divide /health ├── test_app.py # pytest 测试用例8 个测试覆盖正常/异常场景 ├── requirements.txt # Python 依赖Flask, pytest ├── Dockerfile # 多阶段构建镜像 ├── docker-compose.yml # 一键启动 ├── Jenkinsfile # CI/CD Pipeline 定义Build → Test → Deploy ├── .dockerignore # Docker 构建忽略文件 ├── README.md # 项目说明 └── CI-CD-Guide.md # 本文档快速本地验证在 WSL 中cd/home/yl/ci-demo-project# 安装依赖pipinstall-rrequirements.txt# 运行测试python3-mpytest test_app.py-v# 启动服务python3 app.py# 然后访问 http://localhost:5000/health# 测试计算: http://localhost:5000/add?a3b4所有 8 个测试已验证通过 ✅视频演示jenkins、CI/CD效果演示常见问题排查Q1: Jenkins 页面打不开检查 CVM 安全组是否放行 8080 端口检查 Jenkins 容器是否运行docker ps | grep jenkins检查 CVM 防火墙sudo ufw statusQ2: Jenkins Pipeline 报docker: command not foundJenkins 容器内部没有 Docker。确认启动时有没有挂载 docker.sock# 检查挂载dockerinspect jenkins|grepdocker.sock# 如果没有重新创建容器数据在 ~/jenkins_home 中不会丢dockerrm-fjenkinsdockerrun-d\--namejenkins\--restartunless-stopped\-p8080:8080-p50000:50000\-v~/jenkins_home:/var/jenkins_home\-v/var/run/docker.sock:/var/run/docker.sock\jenkins/jenkins:ltsQ3:git push到 GitLab.cn 失败确认使用的是 Personal Access Token 而不是密码确认 Token 权限包含write_repositoryQ4: Webhook 不生效GitLab.cn 到 CVM 公网 IP 可能不通国内网络环境建议先用手动触发验证如果公网 IP 是动态的Webhook 不可靠手动触发一样体验流程清理资源重要体验完成后及时释放资源避免持续扣费# 1. 在腾讯云控制台销毁 CVM 实例或关机# 2. 删除不再需要的安全组规则# 3. 如果使用了弹性公网 IP记得释放按量计费 IP 闲置也扣费源码下载gitlab仓库地址