K8s部署Spring Boot应用全流程指南-代码聚汇网

K8s部署Spring Boot应用全流程指南

冰炭不同炉·2026-08-11·阅读 25 GEO检测（免费）

KubernetesSpring BootDocker

|难度：普通|阅读约 18 分钟

1. 为什么选择K8s部署Spring Boot应用

在当今云原生时代，Kubernetes（简称K8s）已成为容器编排的事实标准。对于Java开发者而言，将Spring Boot应用部署到K8s集群能够获得诸多优势：

首先，K8s提供了强大的弹性伸缩能力。当我们的Spring Boot应用面临突发流量时，通过简单的kubectl scale命令或HPA（Horizontal Pod Autoscaler）配置，就能实现应用的自动扩缩容。这比传统虚拟机部署方式要灵活得多。

其次，K8s完善的健康检查机制（Liveness和Readiness探针）可以确保我们的Spring Boot应用始终保持可用状态。当应用实例出现异常时，K8s会自动重启容器或将其从服务列表中剔除，避免影响整体系统稳定性。

从资源利用率角度看，K8s能够更高效地利用集群资源。通过合理的资源限制（Resource Limits）配置，我们可以在单个物理节点上运行多个Spring Boot应用实例，显著降低基础设施成本。

提示：虽然K8s功能强大，但对于小型项目或开发环境，直接使用docker-compose可能更为轻量。建议根据实际业务规模选择合适的部署方案。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 构建Spring Boot应用的Docker镜像

2.1 准备Dockerfile

一个标准的Spring Boot应用Dockerfile示例如下：

dockerfile复制# 使用官方OpenJDK镜像作为基础
FROM eclipse-temurin:17-jdk-jammy as builder

# 设置工作目录
WORKDIR /app

# 复制构建文件
COPY gradlew .
COPY gradle gradle
COPY build.gradle .
COPY settings.gradle .
COPY src src

# 构建应用
RUN ./gradlew bootJar

# 运行时镜像
FROM eclipse-temurin:17-jre-jammy

WORKDIR /app

# 从构建阶段复制jar文件
COPY --from=builder /app/build/libs/*.jar app.jar

# 设置JVM参数
ENV JAVA_OPTS="-XX:+UseContainerSupport -XX:MaxRAMPercentage=75.0"

# 暴露端口
EXPOSE 8080

# 启动命令
ENTRYPOINT ["sh", "-c", "java ${JAVA_OPTS} -jar /app/app.jar"]

关键点说明：

使用多阶段构建减小最终镜像体积
选择合适的基础镜像（这里使用eclipse-temurin替代已弃用的openjdk官方镜像）
设置JVM参数时考虑容器环境（特别是内存限制）

2.2 优化镜像构建

在实际项目中，我们可以通过以下方式进一步优化：

使用.dockerignore文件排除不必要的文件（如IDE配置、本地构建产物等）
利用构建缓存加速构建过程（合理安排COPY命令的顺序）
考虑使用Jib等工具直接构建镜像，无需编写Dockerfile

注意：在CI/CD流水线中，建议为镜像打上语义化版本标签（如v1.0.0）和git commit SHA，便于追踪和回滚。

3. 配置K8s Deployment

3.1 基础Deployment配置

下面是一个典型的Spring Boot应用Deployment配置示例：

yaml复制apiVersion: apps/v1
kind: Deployment
metadata:
  name: springboot-app
  labels:
    app: springboot-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: springboot-app
  template:
    metadata:
      labels:
        app: springboot-app
    spec:
      containers:
      - name: app
        image: your-registry/springboot-app:v1.0.0
        ports:
        - containerPort: 8080
        resources:
          requests:
            cpu: "500m"
            memory: "512Mi"
          limits:
            cpu: "1000m"
            memory: "1024Mi"
        livenessProbe:
          httpGet:
            path: /actuator/health/liveness
            port: 8080
          initialDelaySeconds: 30
          periodSeconds: 10
        readinessProbe:
          httpGet:
            path: /actuator/health/readiness
            port: 8080
          initialDelaySeconds: 20
          periodSeconds: 5

3.2 关键配置解析

副本数（replicas）：根据预期负载设置合适的副本数量，生产环境通常至少3个
资源限制（resources）：
- requests：K8s调度依据，应设置为应用正常运行所需的最小资源
- limits：容器能使用的资源上限，防止单个应用耗尽节点资源
健康检查（livenessProbe/readinessProbe）：
- 利用Spring Boot Actuator提供的健康端点
- initialDelaySeconds需根据应用启动时间调整
- 生产环境建议配置failureThreshold（默认3次失败后采取行动）
滚动更新策略：可通过strategy字段配置，控制更新时的最大不可用pod数和最大增量数

4. 配套K8s资源配置

4.1 Service配置

Deployment管理的是Pod，要让应用可被访问，还需要创建Service：

yaml复制apiVersion: v1
kind: Service
metadata:
  name: springboot-app-service
spec:
  selector:
    app: springboot-app
  ports:
    - protocol: TCP
      port: 80
      targetPort: 8080
  type: ClusterIP

4.2 ConfigMap和Secret

对于Spring Boot应用的配置，推荐使用ConfigMap和Secret：

yaml复制apiVersion: v1
kind: ConfigMap
metadata:
  name: springboot-app-config
data:
  application.properties: |
    server.port=8080
    spring.datasource.url=jdbc:mysql://mysql-service:3306/mydb
    logging.level.root=INFO

敏感信息如数据库密码应使用Secret：

yaml复制apiVersion: v1
kind: Secret
metadata:
  name: db-secret
type: Opaque
data:
  username: base64编码值
  password: base64编码值

然后在Deployment中通过环境变量引用：

yaml复制env:
- name: SPRING_DATASOURCE_USERNAME
  valueFrom:
    secretKeyRef:
      name: db-secret
      key: username
- name: SPRING_DATASOURCE_PASSWORD
  valueFrom:
    secretKeyRef:
      name: db-secret
      key: password

5. 部署与运维实践

5.1 部署流程

构建并推送Docker镜像：

bash复制docker build -t your-registry/springboot-app:v1.0.0 .
docker push your-registry/springboot-app:v1.0.0

应用K8s配置：

bash复制kubectl apply -f deployment.yaml
kubectl apply -f service.yaml
kubectl apply -f configmap.yaml
kubectl apply -f secret.yaml

验证部署状态：

bash复制kubectl get pods -w
kubectl logs -f <pod-name>
kubectl describe pod <pod-name>

5.2 常见问题排查

Pod处于CrashLoopBackOff状态：
- 检查应用日志：kubectl logs
- 检查前一个容器的日志（如果容器快速重启）：kubectl logs --previous
- 验证资源配置是否足够（特别是内存限制）
应用启动但健康检查失败：
- 确认健康端点路径是否正确
- 检查initialDelaySeconds是否足够长（Spring Boot应用启动可能需要较长时间）
- 验证网络策略是否允许Pod间通信
性能问题：
- 使用kubectl top pod查看资源使用情况
- 考虑调整JVM参数（特别是堆内存设置）
- 检查是否有线程阻塞或数据库连接池耗尽

5.3 高级配置建议

使用Init Container进行依赖检查：
可以在主容器启动前使用Init Container检查数据库等依赖服务是否就绪。
配置PodDisruptionBudget：
确保在维护期间保留最小可用实例数。
考虑使用PodAntiAffinity：
将Pod分散到不同节点，提高可用性。
集成监控：
通过Prometheus Operator等工具监控应用指标和JVM状态。

6. 从开发到生产的全流程建议

在实际项目中将Spring Boot应用部署到K8s时，我总结了以下经验：

环境差异化配置：
使用Spring Profile和K8s ConfigMap结合，实现不同环境（dev/staging/prod）的配置管理。例如：

yaml复制# configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: springboot-app-config
data:
  application-prod.properties: |
    # 生产环境特定配置
  application-dev.properties: |
    # 开发环境特定配置

然后在Deployment中通过环境变量激活对应的Profile：

yaml复制env:
- name: SPRING_PROFILES_ACTIVE
  value: prod

优雅停机配置：
确保Spring Boot应用正确处理SIGTERM信号，在K8s终止Pod时完成正在处理的请求：

properties复制# application.properties
server.shutdown=graceful
spring.lifecycle.timeout-per-shutdown-phase=30s

日志收集方案：
在K8s环境中，建议：
- 将日志输出到stdout/stderr
- 使用Fluentd或Filebeat等工具收集日志
- 考虑集成ELK或Loki等日志系统
持续交付流水线：
建立自动化构建部署流程，典型步骤包括：
- 代码提交触发镜像构建
- 运行单元测试和集成测试
- 扫描镜像安全漏洞
- 部署到测试环境验证
- 人工审批后部署到生产
蓝绿部署或金丝雀发布：
对于关键业务系统，考虑更高级的部署策略：
- 使用K8s的Service和Ingress实现流量切换
- 通过Argo Rollouts等工具管理渐进式发布
- 集成监控系统实现自动回滚
JVM调优经验：
在容器环境中运行Java应用需要特别注意：
- 使用-XX:+UseContainerSupport让JVM识别容器内存限制
- 设置合理的堆内存比例（如-XX:MaxRAMPercentage=75.0）
- 考虑使用GraalVM Native Image减小镜像大小和启动时间
- 对于内存敏感应用，可以尝试ZGC或Shenandoah垃圾收集器
本地开发体验优化：
为了让开发者在本地获得类似K8s环境的体验：
- 使用Telepresence将本地服务连接到远程K8s集群
- 考虑使用Skaffold实现代码变更自动重建和部署
- 对于微服务架构，可在本地使用docker-compose运行依赖服务