Docker官方文档解读：Java应用Kubernetes本地部署测试指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00882/article/details/148549040

Docker官方文档解读：Java应用Kubernetes本地部署测试指南

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs

前言

在当今云原生时代，Kubernetes已成为容器编排的事实标准。作为Java开发者，掌握如何在本地Kubernetes环境中测试和部署应用是必备技能。本文基于Docker官方文档，将详细介绍如何使用Docker Desktop在本地Kubernetes集群中部署和测试Java应用的全过程。

准备工作

在开始之前，请确保已完成以下准备工作：

已完成本系列指南的前置章节，包括应用容器化等内容
已在Docker Desktop中启用Kubernetes功能
已安装并配置好kubectl命令行工具

核心概念解析

Kubernetes部署对象

在Kubernetes中，Deployment是最常用的工作负载对象之一，它提供了以下关键特性：

声明式更新：只需描述期望状态，Kubernetes会自动完成实际状态到期望状态的转换
滚动更新：支持无停机部署新版本应用
回滚能力：当新版本出现问题时可以快速回退到旧版本
副本管理：确保指定数量的Pod实例始终运行

Kubernetes服务对象

Service是Kubernetes中定义网络访问方式的核心对象，本文使用的NodePort类型具有以下特点：

在每个节点上开放静态端口
通过节点IP和端口访问服务
适合开发测试环境使用
生产环境通常使用LoadBalancer或Ingress

详细部署步骤

1. 创建Kubernetes部署描述文件

在项目根目录创建docker-java-kubernetes.yaml文件，内容如下：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: docker-java-demo
spec:
  replicas: 1
  selector:
    matchLabels:
      service: server
  template:
    metadata:
      labels:
        service: server
    spec:
      containers:
        - name: server-service
          image: 你的Docker用户名/仓库名
          imagePullPolicy: Always
---
apiVersion: v1
kind: Service
metadata:
  name: service-entrypoint
spec:
  type: NodePort
  selector:
    service: server
  ports:
    - port: 8080
      targetPort: 8080
      nodePort: 30001

关键配置说明：

replicas: 1：指定只运行1个Pod实例
imagePullPolicy: Always：总是拉取最新镜像
nodePort: 30001：将服务暴露在节点的30001端口

2. 应用Kubernetes配置

执行以下命令部署应用：

kubectl apply -f docker-java-kubernetes.yaml

成功执行后，系统会创建Deployment和Service资源。

3. 验证部署状态

检查Deployment状态：

kubectl get deployments

预期输出应显示1个可用副本：

NAME             READY   UP-TO-DATE   AVAILABLE   AGE
docker-java-demo 1/1     1            1           15s

检查Service状态：

kubectl get services

应能看到NodePort服务已正确配置：

NAME               TYPE        CLUSTER-IP      PORT(S)          AGE
service-entrypoint NodePort    10.99.128.230   8080:30001/TCP   75s

4. 测试应用访问

使用curl测试应用健康检查接口：

curl --request GET \
  --url http://localhost:30001/actuator/health \
  --header 'content-type: application/json'

预期返回应用健康状态：

{"status":"UP","groups":["liveness","readiness"]}

5. 清理资源

测试完成后，执行以下命令删除部署：

kubectl delete -f docker-java-kubernetes.yaml

常见问题排查

Pod启动失败：
- 使用kubectl get pods查看Pod状态
- 使用kubectl describe pod <pod-name>查看详细错误信息
- 使用kubectl logs <pod-name>查看容器日志
服务无法访问：
- 确认Docker Desktop的Kubernetes已启用
- 检查节点端口是否被占用
- 验证Service的selector是否与Pod标签匹配
镜像拉取失败：
- 确认镜像名称拼写正确
- 检查是否已登录Docker镜像仓库
- 确认镜像已成功推送到仓库

进阶建议

多环境配置：
- 使用Kustomize或Helm管理不同环境的配置
- 为开发、测试、生产环境创建不同的命名空间

资源限制：

为容器配置requests和limits，避免资源争用

示例：

resources:
  requests:
    memory: "256Mi"
    cpu: "250m"
  limits:
    memory: "512Mi"
    cpu: "500m"

健康检查：

配置liveness和readiness探针

示例：

livenessProbe:
  httpGet:
    path: /actuator/health
    port: 8080
  initialDelaySeconds: 30
  periodSeconds: 10

总结

通过本文，我们学习了如何使用Docker Desktop在本地Kubernetes环境中部署和测试Java应用。这种本地开发测试方式可以：

提前发现Kubernetes环境下的兼容性问题
验证部署描述文件的正确性
模拟真实集群环境的行为
提高开发效率，减少云环境调试时间

掌握这些技能将为后续的生产环境部署打下坚实基础。建议开发者充分利用Docker Desktop提供的本地Kubernetes功能，在开发早期就能获得接近生产环境的体验。

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考