Docker+Jenkins+K8s全流程部署

从零部署企业级应用:Docker + Jenkins + Kubernetes 全流程指南

本指南基于容器化技术 Docker,结合持续集成工具 Jenkins 与容器编排系统 Kubernetes (K8s),提供一套自动化构建、测试及部署的企业级应用解决方案。该方案支持微服务架构、滚动更新及故障自愈,适合中大型项目的 DevOps 落地 。

一、核心环境准备

在实施 CI/CD 流水线前,需规划并准备好以下基础架构组件。Jenkins 负责流程编排,Docker 负责应用封装,Kubernetes 负责运行调度 。

组件名称 作用说明 安装验证命令 注意事项
Docker Engine 容器运行时,用于构建镜像和运行容器 docker --version 需确保宿主机内核支持 overlay2 存储驱动
Jenkins 自动化服务器,执行构建脚本和部署任务 java -jar jenkins.war --version 建议分配至少 2GB 内存,需安装 JDK 11+
Kubernetes Cluster 容器编排平台,管理生产环境 Pod kubectl version --client 可使用 Minikube 本地测试或云厂商托管版 (EKS/AKS)
Git Repository 源代码管理及 Webhook 触发源 git --version 需配置 Jenkins 凭据以拉取私有代码库

二、快速搭建步骤

1. 容器化应用 (Dockerfile)

编写 Dockerfile 定义应用运行环境,将代码打包为不可变的镜像 。

dockerfile 复制代码
#使用轻量级 Python 基础镜像
FROM python:3.9-slim

# 设置工作目录
WORKDIR /app

# 复制依赖文件并安装
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制应用源代码
COPY . .

# 暴露服务端口
EXPOSE 8000

# 启动命令
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

2. 配置 Jenkins 流水线

创建 Jenkinsfile 定义 CI/CD 流程,包含代码拉取、镜像构建、推送仓库及部署到 K8s 。

groovy 复制代码
pipeline {
    agent any
    
    // 定义环境变量
    environment {
 DOCKER_REGISTRY = 'registry.example.com'
        IMAGE_NAME = 'my-app'
        K8S_NAMESPACE = 'production'
    }

    stages {
        stage('拉取代码') {
            steps {
                // 从 Git 仓库检出代码
                checkout scm
            }
 }
        
        stage('构建 Docker 镜像') {
            steps {
                script {
                    // 使用当前构建号作为镜像标签
                    def imageTag = "${DOCKER_REGISTRY}/${IMAGE_NAME}:${BUILD_NUMBER}"
                    // 执行 Docker 构建命令 sh "docker build -t ${imageTag} ."
                    // 将构建标签存入环境变量供后续使用
                    env.DOCKER_IMAGE = imageTag
                }
            }
        }
        
        stage('推送镜像') {
            steps {
                script {
                    // 登录镜像仓库 (需预先在 Jenkins 凭据中配置)
                    withCredentials([usernamePassword(credentialsId: 'docker-cred', usernameVariable: 'USER', passwordVariable: 'PASS')]) {
                        sh "echo ${PASS} | docker login ${DOCKER_REGISTRY} -u ${USER} --password-stdin"
                        // 推送镜像
                        sh "docker push ${DOCKER_IMAGE}"
                    }
                }
            }
        }
        
        stage('部署到 K8s') {
            steps {
                script {
                    // 更新 K8s 部署文件的镜像版本
                    sh "kubectl set image deployment/my-app-deployment my-app=${DOCKER_IMAGE} -n ${K8S_NAMESPACE}"
                    // 等待滚动更新完成
 sh "kubectl rollout status deployment/my-app-deployment -n ${K8S_NAMESPACE}"
                }
            }
        }
    }
    
    post {
        failure {
            // 构建失败通知逻辑
 echo '构建失败,请检查日志!' }
    }
}

3. 本地预览与调试

在正式提交前,可利用本地 Minikube 或 Docker Compose 模拟运行环境,验证配置有效性 。

bash 复制代码
# 启动本地单节点 K8s集群
minikube start

# 应用部署配置 (假设已有 deployment.yaml)
kubectl apply -f deployment.yaml

# 查看 Pod 运行状态
kubectl get pods -n production

4. 常用命令速查表

DevOps 日常运维中高频使用的操作指令 :

命令 功能描述 适用场景
docker build -t <name> . 构建 Docker 镜像 开发完成后打包应用
kubectl apply -f <file> 应用资源配置 更新 Deployment 或 Service
kubectl logs -f <pod> 实时查看容器日志 排查应用运行错误
jenkins-cli build <job> 触发 Jenkins 任务 手动触发特定流水线
helm upgrade <release> 升级 Helm Chart 基于包管理器的复杂应用更新

三、关键问题管理 (BUG Fix)

在项目迭代过程中,针对已提交版本的缺陷管理至关重要,需建立快速响应机制 。

1. 常见协议层 BUG

涉及网络通信的项目常出现 DNS 解析失败或 SMTP 邮件发送异常,需针对性修正 。

  • DNS 解析错误 :某些语言内置函数(如 Lgetipnodebyname)若未指定 query type 可能导致解析超时。
    • 解决方案 :修改调用参数显式指定 AF_INET 或替换为异步 DNS 库。
  • SMTP 登录失败 :多服务器环境下 mail_initEX 可能因 SSL 握手配置遗漏导致无法登录。
    • 解决方案:检查证书路径配置,确保启用 TLS/SSL 加密通道,并验证防火墙端口 。

2. 内存与资源泄漏

长时间运行的容器可能出现内存溢出,需优化资源限制 。

  • 现象:Pod 频繁重启 (OOMKilled)。
  • 对策 :在 K8s YAML 中设置 resources.limits.memory,并在代码层检查未释放的对象引用或大对象缓存 。
yaml 复制代码
# K8s Deployment 资源限制示例
resources: limits:
    cpu: "500m"
    memory: "512Mi"
  requests:
    cpu: "250m"
    memory: "256Mi"

四、进阶优化与安全策略

基础流水线跑通后,需引入安全扫描与高可用策略以提升系统稳定性。

1. 安全加固措施

  • 镜像扫描:在 Jenkins 流水线中集成 Trivy 或 Clair,构建阶段自动扫描镜像漏洞,阻断高危镜像上线 。
  • 最小权限原则:K8s ServiceAccount 仅授予必要的 Namespace 操作权限,避免使用 cluster-admin 。
  • 密钥管理:严禁将数据库密码硬编码在代码中,统一使用 K8s Secrets 或 Vault 管理敏感信息 。

2. 高可用与监控

  • 健康检查 :配置 livenessProbe 和 readinessProbe,确保 K8s 能自动重启僵死进程并剔除未就绪节点 。
  • 日志聚合:部署 EFK (Elasticsearch, Fluentd, Kibana) 栈,集中收集分散在各 Pod 中的日志,便于故障溯源 。
  • 指标监控:集成 Prometheus + Grafana,实时监控 CPU、内存及 QPS 指标,设置阈值告警 。

五、替代方案简述

若上述组合过于重型,可根据团队规模考虑以下轻量化方案 :

  • GitHub Actions + Docker Hub:适合开源项目或小团队,无需自建 Jenkins 服务器,利用 GitHub 原生 CI 能力直接构建推送。
  • ArgoCD:专注于 GitOps 的持续交付工具,通过监听 Git 仓库变化自动同步 K8s 状态,替代 Jenkins 的部署环节。
  • Rancher:提供可视化的 K8s 管理平台,内置应用商店和监控,降低原生 K8s 的操作门槛。

参考来源

相关推荐
我超膨胀der.11 分钟前
关于如何完整转移LABVIEW源码
笔记·labview
eggwyw24 分钟前
C++设计模式之解释器模式
开发语言·c++
国科安芯1 小时前
FPGA上电偶发不启动:多轨电源时序、PGOOD与并联供电的FAE排查笔记——ASP4644S2B在星载智能处理板中的工程应用分析
笔记·单片机·嵌入式硬件·fpga开发·低轨卫星·抗辐射
欢乐马87911 小时前
优化|MPSolver 和 pywraplp 到底谁是谁?一次讲清 OR-Tools 的三层结构
python
mengge.cloud3 小时前
Python基础保姆级!从入门到入土
开发语言·python·云原生·pygame
Resean02233 小时前
Spring 源码分析(六)循环依赖与三级缓存
java·spring·缓存
在爪洼山玩泥巴3 小时前
fastjson2 JSONPath 取不存在路径,为什么会抛 “not support”?
java·开发语言·jsonpath·fastjson
qq_158895411117 小时前
Suno-API 是什么?官方 V6 模型与 Python / TypeScript 接入指南
python·ai音乐·suno api
星落梦生13 小时前
SpringAOP基础笔记(7)
java·开发语言