本文展示如何使用 kubectl port-forward 连接到在 Kubernetes 集群中运行的 MongoDB 服务。
这种类型的连接对数据库调试很有用。
-
安装 MongoDB Shell。
创建 MongoDB Deployment 和服务 {#creating-mongodb-deployment-and-service}
-
创建一个运行 MongoDB 的 Deployment:
kubectl apply -f https://k8s.io/examples/application/mongodb/mongo-deployment.yaml成功执行的命令的输出可以证明创建了 Deployment:
deployment.apps/mongo created查看 Pod 状态,检查其是否准备就绪:
kubectl get pods输出显示创建的 Pod:
NAME READY STATUS RESTARTS AGE mongo-75f59d57f4-4nd6q 1/1 Running 0 2m4s查看 Deployment 状态:
kubectl get deployment输出显示创建的 Deployment:
NAME READY UP-TO-DATE AVAILABLE AGE mongo 1/1 1 1 2m21s该 Deployment 自动管理一个 ReplicaSet。查看该 ReplicaSet 的状态:
kubectl get replicaset输出显示 ReplicaSet 已被创建:
NAME DESIRED CURRENT READY AGE mongo-75f59d57f4 1 1 1 3m12s -
创建一个在网络上公开的 MongoDB 服务:
kubectl apply -f https://k8s.io/examples/application/mongodb/mongo-service.yaml成功执行的命令的输出可以证明 Service 已经被创建:
service/mongo created检查所创建的 Service:
kubectl get service mongo输出显示已被创建的 Service:
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE mongo ClusterIP 10.96.41.183 <none> 27017/TCP 11s -
验证 MongoDB 服务是否运行在 Pod 中并且在监听 27017 端口:
# 将 mongo-75f59d57f4-4nd6q 改为 Pod 的名称 kubectl get pod mongo-75f59d57f4-4nd6q --template=''输出应该显示对应 Pod 中 MongoDB 的端口:
2701727017 是 MongoDB 的官方 TCP 端口。
转发一个本地端口到 Pod 端口 {#forward-a-local-port-to-a-port-on-the-pod}
-
kubectl port-forward允许使用资源名称 (例如 Pod 名称)来选择匹配的 Pod 来进行端口转发。# 将 mongo-75f59d57f4-4nd6q 改为 Pod 的名称 kubectl port-forward mongo-75f59d57f4-4nd6q 28015:27017这相当于
kubectl port-forward pods/mongo-75f59d57f4-4nd6q 28015:27017或者
kubectl port-forward deployment/mongo 28015:27017或者
kubectl port-forward replicaset/mongo-75f59d57f4 28015:27017或者
kubectl port-forward service/mongo 28015:27017以上所有命令都有效。输出类似于:
Forwarding from 127.0.0.1:28015 -> 27017 Forwarding from [::1]:28015 -> 27017kubectl port-forward不会返回。你需要打开另一个终端来继续这个练习。 -
启动 MongoDB 命令行接口:
mongosh --port 28015 -
在 MongoDB 命令行提示符下,输入
ping命令:db.runCommand( { ping: 1 } )成功的 ping 请求应该返回:
{ ok: 1 }
(可选操作)让 kubectl 来选择本地端口 {#let-kubectl-choose-local-port}
如果你不需要指定特定的本地端口,你可以让 kubectl 来选择和分配本地端口,
这样你就不需要管理本地端口冲突。该命令使用稍微不同的语法:
kubectl port-forward deployment/mongo :27017
kubectl 工具会找到一个未被使用的本地端口号(避免使用低段位的端口号,
因为他们可能会被其他应用程序使用)。输出类似于:
Forwarding from 127.0.0.1:63753 -> 27017
Forwarding from [::1]:63753 -> 27017
讨论 {#discussion}
与本地 28015 端口建立的连接将被转发到运行 MongoDB 服务器的 Pod 的 27017 端口。 通过此连接,你可以使用本地工作站来调试在 Pod 中运行的数据库。
kubectl port-forward 仅实现了 TCP 端口 支持。
在 Issue 47862
中跟踪了对 UDP 协议的支持。
鉴权与安全考量
对 kubectl port-forward 的访问由 Kubernetes 的鉴权机制控制,
例如。
鉴权由 Kubernetes API 服务器而非 kubectl 客户端执行。
要使用 kubectl port-forward,用户必须拥有访问目标资源(例如 Pod 或 Service)的权限,
并拥有对 portforward 子资源的权限。典型所需的权限包括对 pods 的 get
和对 pods/portforward 的 create。
集群管理员应当谨慎地限制这些权限,因为端口转发可以为工作负载提供直接的网络访问, 并且可能绕过网络层面的控制。
进一步了解 kubectl port-forward。
来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。
