website/content/zh/docs/tasks/access-application-cluster/port-forward-access-application-cluster.md

---

title: 使用端口转发来访问集群中的应用 content_template: templates/task weight: 40

{{% capture overview %}}

本文展示如何使用 kubectl port-forward 连接到在 Kubernetes 集群中运行的 Redis 服务。这种类型的连接对数据库调试很有用。 {{% /capture %}}

{{% capture prerequisites %}}

• {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}

• 安装 redis-cli。

{{% /capture %}}

{{% capture steps %}}

创建 Redis deployment 和服务

1. 创建一个 Redis deployment：

   kubectl create -f https://k8s.io/docs/tutorials/stateless-application/guestbook/redis-master-deployment.yaml
   

查看输出是否成功，以验证是否成功创建 deployment：

    deployment "redis-master" created

当 pod 是 ready 时，您将得到：
   
   kubectl get pods

    NAME                            READY     STATUS    RESTARTS   AGE
    redis-master-765d459796-258hz   1/1       Running   0          50s

   kubectl get deployment
   
    NAME         DESIRED   CURRENT   UP-TO-DATE   AVAILABLE   AGE
    redis-master 1         1         1            1           55s

   kubectl get rs
   
    NAME                      DESIRED   CURRENT   READY     AGE
    redis-master-765d459796   1         1         1         1m

2. 创建一个 Redis 服务：

   kubectl create -f https://k8s.io/docs/tutorials/stateless-application/guestbook/redis-master-service.yaml
   

查看输出是否成功，以验证是否成功创建服务：

    service "redis-master" created

检查服务是否创建：

   kubectl get svc | grep redis

    NAME           TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)    AGE
    redis-master   ClusterIP   10.0.0.213   <none>        6379/TCP   27s

3. 验证 Redis 服务是否运行在 pod 中并且监听 6379 端口：

   kubectl get pods redis-master-765d459796-258hz --template='{{(index (index .spec.containers 0).ports 0).containerPort}}{{"\n"}}'
   

输出应该显示端口：

    6379

转发一个本地端口到 pod 端口

1. 从 Kubernetes v1.10 开始，kubectl port-forward 允许使用资源名称（例如服务名称）来选择匹配的 pod 来进行端口转发。

    kubectl port-forward redis-master-765d459796-258hz 6379:6379 
   

这相当于

    kubectl port-forward pods/redis-master-765d459796-258hz 6379:6379

或者

    kubectl port-forward deployment/redis-master 6379:6379 

或者

    kubectl port-forward rs/redis-master 6379:6379 

或者

    kubectl port-forward svc/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。

{{% /capture %}}

{{% capture discussion %}}

讨论

与本地 6379 端口建立的连接将转发到运行 Redis 服务器的 pod 的 6379 端口。通过此连接，您可以使用本地工作站来调试在 pod 中运行的数据库。

{{< warning >}}

警告： 由于已知的限制，目前的端口转发仅适用于 TCP 协议。 在 issue 47862 中正在跟踪对 UDP 协议的支持。 {{< /warning >}}

{{% /capture %}}

{{% capture whatsnext %}}

学习更多关于 kubectl port-forward。 {{% /capture %}}