Kubernetes 中 Java 应用的远程调试端口暴露方法
为什么需要远程调试
在日常开发中，通常会在本地环境中完成代码编写和初步测试，随后将应用部署至生产环境。然而，在 Kubernetes 集群中，由于服务间的通信依赖于集群内部的虚拟网络，使得直接在本地连接远程服务变得复杂。尽管如此，我们仍可通过远程调试机制来解决这一问题。
传统环境下的远程调试配置
在非容器化部署场景下，启用 Java 应用的远程调试功能只需要在启动 JVM 时添加特定参数：
java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 -jar myapp.jar
各参数含义如下：
transport=dt_socket：使用 socket 方式进行通信。server=y：表明当前 JVM 实例扮演服务器角色。suspend=n：控制 JVM 是否等待调试器连接后才开始执行，此处设置为不等待。address=5005：指定监听的调试端口。
容器环境中启用调试模式
要在 Kubernetes Pod 内部启用 Java 调试支持，关键在于确保容器内的 Java 进程以调试模式运行，并通过 Service 将其调试端口对外暴露。
构建包含调试参数的 Docker 镜像
可以通过修改 Dockerfile 的入口指令（ENTRYPOINT）来实现：
FROM openjdk:8-jdk-alpine
COPY ./target/myapp-1.0.jar /app.jar
ENTRYPOINT ["java", "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005", "-jar", "/app.jar"]
在 Deployment 中动态指定调试参数
也可以不在镜像中固化调试参数，而是在 Kubernetes 的 Pod 模板中通过 command 和 args 字段传递：
apiVersion: apps/v1
kind: Deployment
metadata:
name: demo-app
namespace: dev
spec:
replicas: 1
selector:
matchLabels:
app: demo-app
template:
metadata:
labels:
app: demo-app
spec:
containers:
- name: app-container
image: myapp:latest
command: ["java"]
args: ["-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005", "-jar", "app.jar"]
ports:
- containerPort: 8080
暴露调试端口的方法
为了让外部 IDE 可以连接到 Pod 内的调试端口，我们需要借助 Kubernetes Service 提供的多种暴露机制。
使用 NodePort 类型 Service
NodePort 是最直观的一种方式，它会将调试端口映射到集群节点上的某个固定端口上：
apiVersion: v1
kind: Service
metadata:
name: demo-service-nodeport
namespace: dev
spec:
type: NodePort
ports:
- name: web
port: 8080
nodePort: 30080
- name: debug
port: 5005
nodePort: 30050
selector:
app: demo-app
此时，开发者只需获取任意一个工作节点的 IP 地址，并通过该节点的 30050 端口连接调试器即可。
利用 externalIPs 映射调试端口
externalIPs 允许我们将服务绑定到集群外可访问的物理或虚拟 IP 上：
apiVersion: v1
kind: Service
metadata:
name: demo-service-externalip
namespace: dev
spec:
ports:
- name: web
port: 8080
protocol: TCP
- name: debug
port: 5005
protocol: TCP
externalIPs:
- 192.168.100.100
selector:
app: demo-app
这样可以直接通过 192.168.100.100:5005 来建立与 Pod 的调试连接。
