WebStorm 2025.2 Help

使用 Telepresence 进行远程调试

Telepresence 是一个工具,可让您访问 Kubernetes 集群中的服务,对其进行调试,并像在本地计算机上运行一样进行更改和测试。

Kubernetes 插件提供与 Telepresence 的集成,可让您:

连接到 Telepresence

  1. 打开 Services 工具窗口:选择 视图(V)| 工具窗口(T)| 服务 或按 Alt+8

  2. 右键点击您的 Kubernetes 集群并选择 连接Telepresence。 或者,点击工具栏中的 Telepresence 图标。 根据提示输入管理员账户密码以启动 Telepresence 守护程序。 在 Windows 上,允许执行 telepresence.exe

  3. 安装 Telepresence 和 Traffic Manager 后,请再次点击 连接Telepresence

现在,您可以通过 DNS 名称访问 Kubernetes 集群中的服务,就像集群在本地工作站上运行一样。 例如,如果某个应用程序接受对 hello-node:9001 的请求,您可以通过其名称访问。

Telepresence 连接

拦截来自集群的流量

拦截允许您将发送到 Kubernetes 集群中某个服务的流量路由到本地服务。

  1. 在工具栏中点击 Telepresence 图标创建新拦截 ),然后点击 创建新拦截

  2. 在打开的窗口中,从 服务 列表中选择要拦截的 workload。 这可以是 Deployment、ReplicaSet 或 StatefulSet。

    端口 字段中指定本地服务实例正在运行的端口。

    Telepresence 拦截

如果服务拦截成功,您可以在本地访问,并使用 IDE 功能试验、调试并分析在集群中运行的应用程序。

退出 Telepresence

Telepresence 一次只能与一个集群交互,因此连接其他集群前可能需要停止当前连接。 退出 Telepresence 将停止所有活动拦截。

  1. 打开 Services 工具窗口:选择 视图(V)| 工具窗口(T)| 服务 或按 Alt+8

  2. 右键点击您的 Kubernetes 集群并选择 退出Telepresence。 或者,点击工具栏中的 退出 Telepresence 图标

带拦截功能运行应用程序

在 WebStorm 中,单击一下即可运行本地应用程序,同时将发往 Kubernetes 集群中服务的流量重定向到该本地应用程序。

这是通过配置到 Kubernetes 集群的通道(即 Telepresence 拦截),并将其添加为运行配置中的 启动前任务 来实现的。 每次运行此运行配置时,WebStorm 都会创建一个 Telepresence 拦截,从而能够像在本地运行一样调试远程应用程序。

为此,您需要:

  1. 创建包含拦截的运行配置

  2. 使用该运行配置运行应用程序

在运行配置中添加拦截

  1. 请确保:

    • 服务的原始实例已部署并在 Kubernetes 集群中运行,且本地实例的源代码已在编辑器中打开。

    • 您的 WebStorm 实例已 连接到 Kubernetes 集群

  2. 点击主类声明附近边栏中的 ,然后选择 添加用于远程调试的隧道。 此操作在 WebStorm 中至少连接一个集群时可用。

    或者,如果应用程序已有运行/调试配置,点击运行控件中的 ,然后选择 添加用于远程调试的隧道

  3. 在打开的 将Kubernetes 隧道添加到运行配置 窗口中,选择集群和命名空间并点击 连接到集群。 根据提示输入管理员账户密码以启动 Telepresence 守护程序。

  4. 如果已成功连接到集群,请配置拦截参数:

    • 服务 列表中选择要拦截的 workload

    • 端口 字段中指定本地服务实例正在运行的端口。

    • 可选地为 telepresence intercept 命令指定其他选项。

    将 Kubernetes 通道添加到运行配置

    如果您希望查看 Telepresence 命令的输出,请展开 输出 部分。 如果在连接到 Telepresence 时出现任何错误,该部分将自动展开。

  5. 单击 保存配置。 为了检查 intercept 参数,WebStorm 将创建一个 intercept,然后终止该操作。

intercept 参数将作为一个 添加调试隧道 启动前任务保存在新的运行配置中。 为了与其他运行配置区分开来,该运行配置名称将包含 (Telepresence) 后缀,例如 MyApp(Telepresence)

现在,您可以 运行应用程序并拦截其远程版本了。

带拦截功能运行应用程序

  1. 在运行控件中,选择带有 (Telepresence) 后缀的运行配置。

  2. 单击 以运行它,或单击 以启动调试会话。

这将运行您的本地应用程序,同时使用上述指定参数运行 telepresence intercept 命令。

Telepresence 现在拦截集群中某个服务的所有流量,并将其路由至您的本地应用程序。 您可以在本地编写代码并调试被拦截的服务。

服务 工具窗口将在 Telepresence 拦截 节点下显示已创建的 intercept。 Kubernetes 集群的根节点还会显示所生成的 telepresence 命令及相关日志。

服务工具窗口中的 Telepresence 拦截

当您停止此应用程序(通过单击 )时,WebStorm 也会停止该 intercept(telepresence leave)。

最后修改日期: 2025年 9月 26日