7.6 KiB
| title | content_type | weight |
|---|---|---|
| 使用端口转发来访问集群中的应用 | task | 40 |
本文展示如何使用 kubectl port-forward 连接到在 Kubernetes 集群中
运行的 Redis 服务。这种类型的连接对数据库调试很有用。
{{% heading "prerequisites" %}}
- {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
- 安装 redis-cli。
创建 Redis deployment 和服务
-
创建一个 Redis deployment：
kubectl apply -f https://k8s.io/examples/application/guestbook/redis-master-deployment.yaml查看输出是否成功，以验证是否成功创建 deployment：
deployment.apps/redis-master created查看 pod 状态，检查其是否准备就绪：
kubectl get pods输出显示创建的 pod：
NAME READY STATUS RESTARTS AGE redis-master-765d459796-258hz 1/1 Running 0 50s查看 deployment 状态：
kubectl get deployment输出显示创建的 deployment：
NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE redis-master 1 1 1 1 55s查看 replicaset 状态：
kubectl get rs输出显示创建的 replicaset：
NAME DESIRED CURRENT READY AGE redis-master-765d459796 1 1 1 1m
-
创建一个 Redis 服务：
kubectl apply -f https://k8s.io/examples/application/guestbook/redis-master-service.yaml查看输出是否成功，以验证是否成功创建 service：
service/redis-master created检查 service 是否创建：
kubectl get svc | grep redis输出显示创建的 service：
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE redis-master ClusterIP 10.0.0.213 <none> 6379/TCP 27s
-
验证 Redis 服务是否运行在 pod 中并且监听 6379 端口：
kubectl get pods redis-master-765d459796-258hz \ --template='{{(index (index .spec.containers 0).ports 0).containerPort}}{{"\n"}}'输出应该显示端口：
6379
转发一个本地端口到 pod 端口
-
从 Kubernetes v1.10 开始，
kubectl port-forward允许使用资源名称 （例如 pod 名称）来选择匹配的 pod 来进行端口转发。kubectl port-forward redis-master-765d459796-258hz 7000:6379这相当于
kubectl port-forward pods/redis-master-765d459796-258hz 7000:6379或者
kubectl port-forward deployment/redis-master 7000:6379或者
kubectl port-forward rs/redis-master 7000:6379或者
kubectl port-forward svc/redis-master 7000:redis以上所有命令都应该有效。输出应该类似于：
Forwarding from 127.0.0.1:7000 -> 6379 Forwarding from [::1]:7000 -> 6379
{{< note >}}
kubectl port-forward 不会返回。你需要打开另一个终端来继续这个练习。
{{< /note >}}
-
启动 Redis 命令行接口：
redis-cli -p 7000
-
在 Redis 命令行提示符下，输入
ping命令：ping成功的 ping 请求应该返回：
PONG
（可选操作）让 kubectl 来选择本地端口
如果你不需要指定特定的本地端口，你可以让 kubectl 来选择和分配本地端口，
以便你不需要管理本地端口冲突。该命令使用稍微不同的语法：
kubectl port-forward deployment/redis-master :6379
kubectl 工具会找到一个未被使用的本地端口号（避免使用低段位的端口号，因为他们可能会被其他应用程序使用）。输出应该类似于：
Forwarding from 127.0.0.1:62162 -> 6379
Forwarding from [::1]:62162 -> 6379
讨论
与本地 7000 端口建立的连接将转发到运行 Redis 服务器的 pod 的 6379 端口。 通过此连接，您可以使用本地工作站来调试在 pod 中运行的数据库。
{{< warning >}} 由于已知的限制，目前的端口转发仅适用于 TCP 协议。 在 issue 47862 中正在跟踪对 UDP 协议的支持。 {{< /warning >}}
{{% heading "whatsnext" %}}
进一步了解 kubectl port-forward。