datawire/ambassador-telepresence

企业级Telepresence Daemon (Docker模式)

镜像概述

本镜像为企业级Telepresence守护进程（Telepresence Daemon）的Docker模式运行版本，专为在Docker环境中部署设计。Telepresence是一款用于简化Kubernetes应用本地开发的工具，本镜像通过容器化方式提供守护进程服务，实现本地Docker开发环境与远程Kubernetes集群的流量代理、资源访问和开发调试集成。

核心功能与特性

• Docker环境原生适配：针对Docker容器化环境优化，支持在独立容器中运行，无需主机直接安装Telepresence
• Kubernetes流量代理：实现本地Docker服务与Kubernetes集群间的双向流量转发，支持请求拦截、响应模拟
• 集群资源透明访问：允许本地Docker容器直接访问Kubernetes集群内的服务、ConfigMap、Secret等资源
• 企业级安全增强：集成企业版特有的认证机制（如SSO）、TLS加密通信和细粒度权限控制
• 轻量级运行：容器化设计，资源占用低，支持与Docker Compose等工具集成

使用场景

• 本地Docker开发与K8s联调：开发人员在本地Docker环境开发微服务时，需访问Kubernetes集群内的依赖服务（如数据库、消息队列）
• 流量拦截调试：拦截Kubernetes集群中特定服务的生产流量，路由至本地Docker容器进行代码调试
• 混合环境部署验证：验证Docker Compose管理的本地服务与Kubernetes集群服务的交互兼容性
• CI/CD流水线集成：在CI/CD流程中通过Docker容器化方式运行Telepresence，实现自动化测试环境与K8s集群的集成

使用方法与配置说明

前提条件

• Docker Engine 20.10+
• 已配置kubectl访问目标Kubernetes集群（集群版本1.21+）
• （企业版功能）有效的Telepresence企业授权令牌

基本部署命令

通过以下命令启动Telepresence Daemon容器：

bash
docker run -d \
  --name telepresence-daemon \
  --privileged \
  --restart unless-stopped \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $HOME/.kube/config:/root/.kube/config:ro \
  -v telepresence-cache:/telepresence/cache \
  -e KUBECONFIG=/root/.kube/config \
  -e TELEPRESENCE_LOG_LEVEL=info \
  -e ENTERPRISE_TOKEN=<your-enterprise-token> \
  --network host \
  docker.xuanyuan.run/your-registry/telepresence-enterprise-daemon:latest

核心配置参数

环境变量配置

卷挂载说明

• /var/run/docker.sock：必须挂载，用于与Docker引擎交互，管理本地容器网络
• $HOME/.kube/config：只读挂载，提供Kubernetes集群访问凭证
• telepresence-cache：可选命名卷，存储代理配置缓存和运行日志（建议持久化）

部署验证

1. 检查容器运行状态：

   bash
   docker ps --filter "name=telepresence-daemon"
   

2. 查看启动日志：

   bash
   docker logs telepresence-daemon --tail 20
   

   成功启动日志应包含："Telepresence daemon started successfully in Docker mode"

3. 验证集群连接：

   bash
   docker exec -it telepresence-daemon telepresence status
   

   输出应显示集群连接状态为Connected

停止与清理

bash
# 停止容器
docker stop telepresence-daemon

# 删除容器
docker rm telepresence-daemon

# （可选）删除缓存卷
docker volume rm telepresence-cache