OSS Telepresence Daemon (Docker模式) 镜像文档

镜像概述

该镜像提供了OSS Telepresence守护进程（Daemon）的Docker模式运行环境。Telepresence是一款用于简化Kubernetes服务开发的工具，通过在Docker环境中运行守护进程，实现本地开发环境与远程Kubernetes集群的无缝网络连接、服务通信及流量管理，帮助开发人员在本地高效调试依赖Kubernetes集群服务的应用。

核心功能与特性

• 本地-集群网络代理：建立本地开发环境与Kubernetes集群的双向网络通道，支持本地服务与集群服务直接通信
• 流量拦截与重定向：可将集群中指定服务的流量拦截并转发至本地运行的服务实例，便于实时调试
• 环境配置同步：自动同步Kubernetes集群中的环境变量、ConfigMap和Secret至本地，确保开发环境一致性
• 轻量级Docker部署：以容器化方式运行，简化依赖管理与跨环境部署，支持与Docker Compose等工具集成

使用场景与适用范围

• Kubernetes服务本地调试：开发人员需在本地运行服务并与远程Kubernetes集群中其他服务交互时
• 依赖集群服务的本地开发：本地应用依赖Kubernetes集群中的数据库、消息队列等中间件服务时
• 多服务联调：需要在本地模拟多服务协作场景，验证跨服务功能时
• CI/CD流程集成：在Docker化的CI/CD管道中集成Telepresence，实现自动化测试与集群交互

使用方法与配置说明

前置条件

• 已安装Docker Engine（20.10+版本）
• 本地已配置Kubernetes集群访问凭证（kubeconfig）
• 已安装Telepresence客户端（用于与守护进程交互）

基本运行命令

docker run -d \
  --name telepresence-daemon \
  --network host \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $HOME/.kube/config:/root/.kube/config \
  -v $HOME/.telepresence:/root/.telepresence \
  ghcr.io/telepresenceio/telepresence-daemon:latest

关键参数说明

环境变量配置

可通过-e参数设置环境变量调整守护进程行为：

与Telepresence客户端配合使用

启动守护进程后，通过本地Telepresence客户端连接并使用：

# 连接到Docker模式的守护进程
telepresence connect --docker

# 验证连接状态
telepresence status

# 拦截集群服务流量至本地端口
telepresence intercept <service-name> --port <local-port>:<service-port>

Docker Compose配置示例

version: '3.8'
services:
  telepresence-daemon:
    image: ghcr.io/telepresenceio/telepresence-daemon:latest
    container_name: telepresence-daemon
    network_mode: host
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ${HOME}/.kube/config:/root/.kube/config
      - ${HOME}/.telepresence:/root/.telepresence
    environment:
      - TELEPRESENCE_LOG_LEVEL=debug
    restart: unless-stopped