Spring Boot + Docker + Kubernetes：云原生部署实战指南

原创于 2025-03-03 22:53:47 发布 · 1k 阅读

19 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #docker #后端

springboot 专栏收录该内容

34 篇文章

订阅专栏

引言

在云原生时代，快速构建、部署和扩展应用已成为现代开发的核心需求。Spring Boot 作为轻量级Java框架，Docker 作为容器化标准，以及 Kubernetes 作为容器编排平台，三者结合为开发者提供了从开发到生产的全链路解决方案。本文将手把手带你完成一个Spring Boot应用的云原生部署实践。

第一部分：技术栈简介

1.1 Spring Boot

Spring Boot通过约定优于配置的理念，简化了Spring应用的初始化与部署流程。其内嵌的Tomcat服务器和starter依赖机制，让开发者能够快速构建可独立运行的JAR包。

1.2 Docker

Docker通过容器化技术将应用及其依赖打包成标准镜像，实现环境一致性。容器与虚拟机相比，资源占用更低、启动更快，是云原生架构的基石。

1.3 Kubernetes

Kubernetes（K8s）是容器编排领域的领导者，提供自动化部署、扩缩容、服务发现等功能。其核心概念包括Pod、Deployment、Service和Ingress。

第二部分：实战部署全流程

2.1 创建Spring Boot应用

@SpringBootApplication
@RestController
public class DemoApp {
    public static void main(String[] args) {
        SpringApplication.run(DemoApp.class, args);
    }

    @GetMapping("/")
    public String hello() {
        return "Hello from Cloud Native!";
    }
}

使用 ./mvnw clean package 生成可执行的JAR文件。

2.2 Docker容器化

编写Dockerfile实现多阶段构建，优化镜像体积：

# 构建阶段
FROM maven:3.8.6-jdk-11 AS build
COPY src /app/src
COPY pom.xml /app
RUN mvn -f /app/pom.xml clean package

# 运行阶段
FROM openjdk:11-jre-slim
COPY --from=build /app/target/demo-0.0.1.jar /app.jar
EXPOSE 8080
ENTRYPOINT ["java","-jar","/app.jar"]

执行命令构建镜像：

docker build -t myapp:1.0.0 .

2.3 Kubernetes集群部署

2.3.1 部署配置（deployment.yaml）

apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp-deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: myapp
  template:
    metadata:
      labels:
        app: myapp
    spec:
      containers:
      - name: myapp
        image: myapp:1.0.0
        ports:
        - containerPort: 8080
        livenessProbe:
          httpGet:
            path: /actuator/health
            port: 8080
          initialDelaySeconds: 30
          periodSeconds: 10

2.3.2 服务暴露（service.yaml）

apiVersion: v1
kind: Service
metadata:
  name: myapp-service
spec:
  selector:
    app: myapp
  ports:
    - protocol: TCP
      port: 80
      targetPort: 8080
  type: LoadBalancer

执行部署命令：

kubectl apply -f deployment.yaml
kubectl apply -f service.yaml

第三部分：进阶优化与最佳实践

3.1 镜像优化策略

使用Alpine基础镜像（如eclipse-temurin:17-jdk-alpine）
分离依赖层与代码层，利用Docker缓存机制

3.2 Kubernetes特性应用

Horizontal Pod Autoscaler：根据CPU负载自动扩缩容
ConfigMap & Secret：管理环境变量与敏感信息
Ingress Controller：实现七层路由与HTTPS终结

3.3 监控与日志

集成Prometheus采集JVM指标
使用EFK（Elasticsearch+Fluentd+Kibana）日志收集方案

第四部分：常见问题排查

镜像拉取失败
- 检查镜像仓库权限
- 使用kubectl describe pod <pod-name>查看详细事件
服务无法访问
- 验证Service的selector标签匹配
- 检查防火墙规则和网络策略
内存溢出（OOM）
- 设置JVM参数：-XX:+UseContainerSupport -XX:MaxRAMPercentage=75.0
- 配置K8s资源限制（resources.limits）

结语

通过Spring Boot+Docker+Kubernetes的黄金组合，开发者可以轻松构建弹性、可扩展的云原生应用。本文从基础部署到进阶优化，覆盖了生产级应用的关键环节。随着云原生生态的演进，建议进一步探索Service Mesh、GitOps等新兴实践，持续提升部署效能与系统可靠性。

延伸阅读

Spring官方容器化指南：https://spring.io/guides/gs/spring-boot-docker/
Kubernetes官方文档：https://kubernetes.io/docs/home/
《云原生模式：设计拥抱变化的软件》（O'Reilly）