使用端口转发访问集群中的应用程序
本页面展示如何使用 kubectl port-forward
连接到在 Kubernetes 集群中运行的 MongoDB 服务器。这种连接类型对于数据库调试非常有用。
准备开始
你需要有一个 Kubernetes 集群,并且必须配置 kubectl 命令行工具以与你的集群通信。建议在至少有两个不充当控制平面主机的节点的集群上运行本教程。 如果你还没有集群,可以使用 minikube 创建一个集群,或者使用以下 Kubernetes 游乐场之一
你的 Kubernetes 服务器必须是 v1.10 或更高版本。要检查版本,请输入kubectl version
。- 安装 MongoDB Shell。
创建 MongoDB Deployment 和 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
创建一个 Service 以在网络上公开 MongoDB
kubectl apply -f https://k8s.io/examples/application/mongodb/mongo-service.yaml
如果命令成功执行,输出将验证 Service 已被创建
service/mongo created
检查已创建的 Service
kubectl get service mongo
输出显示已创建的服务
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE mongo ClusterIP 10.96.41.183 <none> 27017/TCP 11s
验证 MongoDB 服务器是否正在 Pod 中运行,并监听端口 27017
# Change mongo-75f59d57f4-4nd6q to the name of the Pod kubectl get pod mongo-75f59d57f4-4nd6q --template='{{(index (index .spec.containers 0).ports 0).containerPort}}{{"\n"}}'
输出显示该 Pod 中 MongoDB 的端口
27017
27017 是 MongoDB 的官方 TCP 端口。
将本地端口转发到 Pod 上的端口
kubectl port-forward
允许使用资源名称(例如 Pod 名称)来选择要转发端口的匹配 Pod。# Change mongo-75f59d57f4-4nd6q to the name of the 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 -> 27017
注意
kubectl port-forward
不会返回。要继续进行练习,你需要打开另一个终端。启动 MongoDB 命令行界面
mongosh --port 28015
在 MongoDB 命令行提示符下,输入
ping
命令db.runCommand( { ping: 1 } )
成功的 ping 请求返回
{ ok: 1 }
可选地,让 *kubectl* 选择本地端口
如果你不需要特定的本地端口,你可以让 kubectl
选择并分配本地端口,从而免除管理本地端口冲突的麻烦,使用更简单的语法
kubectl port-forward deployment/mongo :27017
kubectl
工具会找到一个未使用的本地端口号(避免使用较低的端口号,因为这些端口号可能被其他应用程序使用)。 输出类似于
Forwarding from 127.0.0.1:63753 -> 27017
Forwarding from [::1]:63753 -> 27017
讨论
与本地端口 28015 建立的连接被转发到运行 MongoDB 服务器的 Pod 的端口 27017。有了这个连接,你可以使用本地工作站来调试在 Pod 中运行的数据库。
下一步
了解更多关于 kubectl port-forward 的信息。