kubectl port-forward
概要
将一个或多个本地端口转发到 Pod。
使用资源类型/名称(例如 deployment/mydeployment)来选择 Pod。如果省略,资源类型默认为“pod”。
如果有多个 Pod 匹配条件,将自动选择一个 Pod。转发会话在所选 Pod 终止时结束,需要重新运行命令才能恢复转发。
kubectl port-forward TYPE/NAME [options] [LOCAL_PORT:]REMOTE_PORT [...[LOCAL_PORT_N:]REMOTE_PORT_N]
示例
# Listen on ports 5000 and 6000 locally, forwarding data to/from ports 5000 and 6000 in the pod
kubectl port-forward pod/mypod 5000 6000
# Listen on ports 5000 and 6000 locally, forwarding data to/from ports 5000 and 6000 in a pod selected by the deployment
kubectl port-forward deployment/mydeployment 5000 6000
# Listen on port 8443 locally, forwarding to the targetPort of the service's port named "https" in a pod selected by the service
kubectl port-forward service/myservice 8443:https
# Listen on port 8888 locally, forwarding to 5000 in the pod
kubectl port-forward pod/mypod 8888:5000
# Listen on port 8888 on all addresses, forwarding to 5000 in the pod
kubectl port-forward --address 0.0.0.0 pod/mypod 8888:5000
# Listen on port 8888 on localhost and selected IP, forwarding to 5000 in the pod
kubectl port-forward --address localhost,10.19.21.23 pod/mypod 8888:5000
# Listen on a random port locally, forwarding to 5000 in the pod
kubectl port-forward pod/mypod :5000
选项
--address 字符串 默认: "localhost" | |
要监听的地址(逗号分隔)。只接受 IP 地址或 localhost 作为值。当提供 localhost 时,kubectl 将尝试绑定到 127.0.0.1 和 ::1,如果这两个地址都不可用以绑定,则会失败。 | |
-h, --help | |
port-forward 的帮助 | |
--pod-running-timeout 持续时间 默认: 1m0s | |
等待至少一个 Pod 运行的时长(例如 5s、2m 或 3h,大于零) |
--as 字符串 | |
要模拟操作的用户名。用户可以是普通用户或命名空间中的服务帐户。 | |
--as-group 字符串 | |
要模拟操作的组,此标志可以重复以指定多个组。 | |
--as-uid 字符串 | |
要模拟操作的 UID。 | |
--cache-dir 字符串 默认: "$HOME/.kube/cache" | |
默认缓存目录 | |
--certificate-authority 字符串 | |
证书颁发机构证书文件的路径 | |
--client-certificate 字符串 | |
TLS 客户端证书文件的路径 | |
--client-key 字符串 | |
TLS 客户端密钥文件的路径 | |
--cloud-provider-gce-l7lb-src-cidrs cidr 默认: 130.211.0.0/22,35.191.0.0/16 | |
在 GCE 防火墙中为 L7 LB 流量代理和健康检查打开的 CIDR | |
--cloud-provider-gce-lb-src-cidrs cidr 默认: 130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16 | |
在 GCE 防火墙中为 L4 LB 流量代理和健康检查打开的 CIDR | |
--cluster 字符串 | |
要使用的 kubeconfig 集群的名称 | |
--context 字符串 | |
要使用的 kubeconfig 上下文的名称 | |
--default-not-ready-toleration-seconds 整数 默认: 300 | |
指示默认添加到每个尚未包含此类容忍度的 Pod 的 notReady:NoExecute 容忍度的 tolerationSeconds。 | |
--default-unreachable-toleration-seconds 整数 默认: 300 | |
指示默认添加到每个尚未包含此类容忍度的 Pod 的 unreachable:NoExecute 容忍度的 tolerationSeconds。 | |
--disable-compression | |
如果为 true,则选择退出对所有服务器请求的响应压缩 | |
--insecure-skip-tls-verify | |
如果为 true,则不会检查服务器证书的有效性。这将使您的 HTTPS 连接不安全 | |
--kubeconfig 字符串 | |
CLI 请求使用的 kubeconfig 文件的路径。 | |
--match-server-version | |
要求服务器版本与客户端版本匹配 | |
-n, --namespace 字符串 | |
如果存在,则为此次 CLI 请求的命名空间范围 | |
--password 字符串 | |
API 服务器基本身份验证的密码 | |
--profile 字符串 默认: "none" | |
要捕获的配置文件的名称。之一(none|cpu|heap|goroutine|threadcreate|block|mutex) | |
--profile-output 字符串 默认: "profile.pprof" | |
要写入配置文件的名称 | |
--request-timeout 字符串 默认: "0" | |
在放弃单个服务器请求之前等待的时长。非零值应包含相应的单位(例如 1s、2m、3h)。值为零表示不超时请求。 | |
-s, --server 字符串 | |
Kubernetes API 服务器的地址和端口 | |
--storage-driver-buffer-duration 持续时间 默认: 1m0s | |
存储驱动程序中的写入将在此持续时间内缓冲,并作为单个事务提交到非内存后端 | |
--storage-driver-db 字符串 默认: "cadvisor" | |
数据库名称 | |
--storage-driver-host 字符串 默认: "localhost:8086" | |
数据库主机:端口 | |
--storage-driver-password 字符串 默认: "root" | |
数据库密码 | |
--storage-driver-secure | |
使用与数据库的安全连接 | |
--storage-driver-table 字符串 默认: "stats" | |
表名 | |
--storage-driver-user 字符串 默认: "root" | |
数据库用户名 | |
--tls-server-name 字符串 | |
用于服务器证书验证的服务器名称。如果未提供,则使用用于联系服务器的主机名 | |
--token 字符串 | |
用于 API 服务器身份验证的承载令牌 | |
--user 字符串 | |
要使用的 kubeconfig 用户的名称 | |
--username 字符串 | |
API 服务器基本身份验证的用户名 | |
--version 版本[=true] | |
--version, --version=raw 打印版本信息并退出; --version=vX.Y.Z... 设置报告的版本 | |
--warnings-as-errors | |
将从服务器接收到的警告视为错误并使用非零退出代码退出 |
另请参阅
- kubectl - kubectl 控制 Kubernetes 集群管理器
此页面是自动生成的。
如果您打算报告此页面的问题,请在您的问题描述中提及该页面是自动生成的。修复可能需要在 Kubernetes 项目中的其他地方进行。