将Docker黑盒应用迁移至K8s：gRPC端口5993通信配置咨询

核心逻辑梳理 #

Docker里的docker run -p 5993:5993本质是把容器内的5993端口映射到宿主机，让外部能访问容器服务。在K8s里，别用port-forward（这只是临时调试工具），要根据数据库的位置选对应的Service类型：如果数据库在集群内，用ClusterIP；如果数据库在集群外，用NodePort或云环境的LoadBalancer。

必配资源清单 #

你需要两个核心K8s资源：Deployment（管理应用Pod）和Service（暴露Pod端口）

1. Deployment配置（deploy.yaml） #

对应Docker run的容器定义，负责启动和管理应用Pod：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: blackbox-app
spec:
  replicas: 1
  selector:
    matchLabels:
      app: blackbox-app
  template:
    metadata:
      labels:
        app: blackbox-app
    spec:
      containers:
      - name: blackbox-app
        image: your-app-image:tag  # 替换成你的实际应用镜像
        ports:
        - containerPort: 5993  # 和Docker容器内的端口保持一致
        # 可添加Docker run的其他参数，比如环境变量、挂载卷等

2. Service配置（svc.yaml） #

根据数据库位置选对应的服务类型：

场景A：数据库在K8s集群内部

用默认的ClusterIP类型，集群内的数据库可通过服务名直接访问应用：

apiVersion: v1
kind: Service
metadata:
  name: blackbox-app-svc
spec:
  selector:
    app: blackbox-app  # 必须和Deployment的Pod标签匹配
  ports:
  - protocol: TCP  # gRPC基于TCP，固定用TCP
    port: 5993  # 集群内访问用的服务端口
    targetPort: 5993  # 对应Pod的容器端口

集群内数据库访问地址：blackbox-app-svc:5993

场景B：数据库在K8s集群外部

用NodePort类型，外部数据库通过集群节点IP+NodePort访问：

apiVersion: v1
kind: Service
metadata:
  name: blackbox-app-svc
spec:
  type: NodePort
  selector:
    app: blackbox-app
  ports:
  - protocol: TCP
    port: 5993
    targetPort: 5993
    nodePort: 30599  # 可选，指定节点端口（范围30000-32767），不指定会自动分配

外部数据库访问地址：集群节点IP:30599

部署命令 #

保存上述yaml文件后，执行：

kubectl apply -f deploy.yaml
kubectl apply -f svc.yaml

避坑提示 #

• port-forward仅用于临时本地调试，比如kubectl port-forward deployment/blackbox-app 5993:5993，生产环境禁止使用，因为无负载均衡、重启即失效。
• 云环境优先用LoadBalancer类型的Service，会自动生成云厂商负载均衡器，比NodePort更稳定。
• gRPC依赖TCP协议，Service的protocol必须设为TCP，不能用UDP。

内容的提问来源于stack exchange，提问作者Mirco