Spring Boot应用容器化与Kubernetes部署实战

1. 项目概述

作为一名长期奋战在微服务架构一线的开发者，我深知将Spring Boot应用容器化并部署到Kubernetes集群的重要性。这次我将分享一个完整的实战案例，从零开始构建Spring Boot应用镜像，最终部署到K8s集群并实现弹性扩缩容。整个过程涉及Maven项目构建、Docker镜像制作、K8s资源编排等核心环节，特别适合刚接触云原生的Java开发者参考。

2. 环境准备与项目初始化

2.1 基础环境要求

在开始之前，请确保你的开发环境满足以下条件：

• JDK 8+（推荐JDK 11或17）
• Maven 3.6+
• IntelliJ IDEA或Eclipse IDE
• Docker Desktop或Linux Docker环境
• 可用的Kubernetes集群（Minikube、kubeadm集群或云服务商集群）

提示：生产环境建议使用OpenJDK基础镜像而非Oracle JDK，避免潜在的许可问题。本文使用的是openjdk:8-jdk-alpine镜像。

2.2 创建Spring Boot项目

在IDEA中新建Maven项目，命名为springbootdemo。关键pom.xml配置如下：

xml复制<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.0</version> <!-- 使用稳定版本 -->
</parent>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <excludes>
                    <exclude>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                    </exclude>
                </excludes>
            </configuration>
        </plugin>
    </plugins>
</build>

这里有几个值得注意的细节：

1. 使用Spring Boot 2.7.0稳定版而非快照版本
2. 排除了Lombok等开发时依赖（生产环境不需要）
3. 配置了spring-boot-maven-plugin用于构建可执行JAR

2.3 编写示例接口

创建简单的REST接口用于验证部署效果：

java复制@RestController
@RequestMapping("/api")
public class HealthController {
    
    @GetMapping("/health")
    public Map<String, String> healthCheck() {
        return Collections.singletonMap("status", "UP");
    }
    
    @GetMapping("/host")
    public Map<String, String> hostInfo() {
        try {
            return Collections.singletonMap("hostname", 
                InetAddress.getLocalHost().getHostName());
        } catch (UnknownHostException e) {
            throw new RuntimeException(e);
        }
    }
}

这个控制器提供了两个端点：

• /api/health：基础健康检查
• /api/host：返回当前容器主机名（用于验证K8s负载均衡）

3. Docker镜像构建

3.1 优化Dockerfile

标准的Dockerfile如下：

dockerfile复制FROM openjdk:8-jdk-alpine

# 设置时区
RUN apk add --no-cache tzdata && \
    cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
    echo "Asia/Shanghai" > /etc/timezone

# 创建非root用户运行
RUN addgroup -S spring && adduser -S spring -G spring
USER spring:spring

# 优化JVM参数
ENV JAVA_OPTS="-XX:+UseContainerSupport -XX:MaxRAMPercentage=75.0"

# 复制构建产物
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar

# 暴露端口
EXPOSE 8080

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

这个Dockerfile做了多处优化：

1. 设置容器时区（避免日志时间错乱）
2. 使用非root用户运行（安全最佳实践）
3. 配置容器感知的JVM参数
4. 使用分层构建减少镜像体积

3.2 构建与测试镜像

构建命令：

bash复制# 先打包Spring Boot应用
mvn clean package -DskipTests

# 构建Docker镜像
docker build -t springbootdemo:1.0.0 .

# 测试运行
docker run -d -p 8080:8080 --name demo springbootdemo:1.0.0

验证镜像是否正常工作：

bash复制curl http://localhost:8080/api/health
# 预期输出: {"status":"UP"}

4. Kubernetes部署配置

4.1 Deployment配置详解

完整的deployment.yaml配置：

yaml复制apiVersion: apps/v1
kind: Deployment
metadata:
  name: springboot-demo
  labels:
    app: springboot-demo
spec:
  replicas: 2
  strategy:
    rollingUpdate:
      maxSurge: 1
      maxUnavailable: 0
    type: RollingUpdate
  selector:
    matchLabels:
      app: springboot-demo
  template:
    metadata:
      labels:
        app: springboot-demo
    spec:
      containers:
      - name: app
        image: springbootdemo:1.0.0
        imagePullPolicy: IfNotPresent
        ports:
        - containerPort: 8080
        resources:
          requests:
            cpu: "500m"
            memory: "512Mi"
          limits:
            cpu: "1000m"
            memory: "1024Mi"
        livenessProbe:
          httpGet:
            path: /api/health
            port: 8080
          initialDelaySeconds: 30
          periodSeconds: 10
        readinessProbe:
          httpGet:
            path: /api/health
            port: 8080
          initialDelaySeconds: 20
          periodSeconds: 5

关键配置说明：

1. 滚动更新策略：maxUnavailable=0确保更新时不中断服务
2. 资源限制：防止单个Pod占用过多资源
3. 健康检查：livenessProbe和readinessProbe确保服务可用性

4.2 Service配置

service.yaml配置：

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

这里选择NodePort类型方便测试，生产环境建议使用LoadBalancer或Ingress。

5. 部署与验证

5.1 应用部署

执行部署命令：

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

# 查看部署状态
kubectl get pods -w

5.2 验证负载均衡

通过多次访问host接口验证请求被分配到不同Pod：

bash复制for i in {1..5}; do
  curl http://<node-ip>:30080/api/host
done

预期会看到不同的hostname输出，证明负载均衡生效。

5.3 扩缩容操作

手动扩缩容：

bash复制# 扩容到3个实例
kubectl scale deployment springboot-demo --replicas=3

# 查看资源使用情况
kubectl top pods

6. 生产环境优化建议

6.1 镜像管理最佳实践

1. 使用私有镜像仓库（Harbor、Nexus等）
2. 为镜像打语义化版本标签
3. 定期扫描镜像漏洞

6.2 K8s配置优化

1. 配置HPA自动扩缩容：

yaml复制apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
  name: springboot-hpa
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: springboot-demo
  minReplicas: 2
  maxReplicas: 10
  metrics:
  - type: Resource
    resource:
      name: cpu
      target:
        type: Utilization
        averageUtilization: 70

2. 使用ConfigMap管理应用配置
3. 配置Pod反亲和性提高可用性

6.3 监控与日志

1. 集成Prometheus监控JVM指标
2. 使用ELK或Loki收集日志
3. 配置告警规则

7. 常见问题排查

7.1 Pod启动失败

可能原因：

• 镜像拉取失败：检查镜像地址和pull secret
• 资源不足：describe pod查看事件
• 健康检查失败：调整initialDelaySeconds

7.2 服务无法访问

排查步骤：

1. 检查Service的selector是否匹配Pod标签
2. 验证kube-proxy是否正常运行
3. 检查网络策略是否允许流量

7.3 性能问题

优化方向：

• 调整JVM参数（特别是堆内存设置）
• 增加Pod资源限制
• 优化应用代码（数据库查询等）

在实际项目中，我们还需要考虑CI/CD流水线的搭建、多环境配置管理、安全加固等更多方面。这个示例提供了最基础的部署框架，你可以根据实际需求进行扩展。