本文介绍如何使用kubectl port-forward
命令连接K8S集群中运行的Redis服务。这种连接方式有助于数据库的调试工作。
注意:本文针对K8S的版本号为v1.9,其他版本可能会有少许不同。
0x00 准备工作
在进行该操作之前,需要满足以下条件:
- 需要有一个K8S集群,并且配置好了
kubectl
命令行工具来与集群通信。如果未准备好集群,那么你可以使用Minikube创建一个K8S集群,或者你也可以使用下面K8S环境二者之一: - 安装了redis-cli
如果需要查看K8S版本信息,可以输入指令kubectl version
。
0x01 创建Pod运行Redis服务器
1、创建一个Pod:
kubectl create -f https://k8s.io/docs/tasks/access-application-cluster/redis-master.yaml
表示该Pod成功创建的输出结果如下所示:
pod "redis-master" created
2、检查该Pod是否运行并处于ready状态:
kubectl get pods
当该Pod处于ready状态时,输出内容中的STATUS字段的值为Running:
NAME READY STATUS RESTARTS AGE
redis-master 2/2 Running 0 41s
3、确认Redis服务运行于该Pod中,并监听端口6379:
kubectl get pods redis-master --template=‘{{(index (index .spec.containers 0).ports 0).containerPort}}{{"\n"}}‘
输入结果会展示端口号:
6379
0x02 转发本地端口到Pod端口
1、转发本地6379端口到redis-master
Pod的6379端口:
kubectl port-forward redis-master 6379:6379
输出结果类似如下内容:
I0710 14:43:38.274550 3655 portforward.go:225] Forwarding from 127.0.0.1:6379 -> 6379
I0710 14:43:38.274797 3655 portforward.go:225] Forwarding from [::1]:6379 -> 6379
2、启动Redis命令行界面:
redis-cli
3、在Redis命令行提示中,输入ping
命令:
127.0.0.1:6379>ping
ping
请求成功将返回PONG
。
0x03 总结
向本地端口6379发起的连接,将会转发到运行着Redis服务器的Pod的6379端口。通过这种机制,我们就可以使用本地工作站来调试运行在Pod内的数据库了。
注意:由于已知的限制,端口转发目前仅仅支持TCP协议,对于UDP协议的支持功能目前正在由issue 47862跟踪。
英文原文:https://kubernetes.io/docs/tasks/access-application-cluster/port-forward-access-application-cluster/