datawire/telepresence-k8s

Telepresence Kubernetes端支持镜像

概述

该镜像为Telepresence（[***]

特性

• 双向流量代理：支持本地服务与Kubernetes集群服务间的双向网络通信，实现流量无缝路由
• 服务镜像替换：可临时将集群中的目标服务替换为本地运行实例，保留网络上下文与依赖关系
• 低延迟数据传输：优化数据传输路径，减少本地开发与集群服务间的通信延迟
• 动态配置同步：自动同步Kubernetes服务配置（如环境变量、ConfigMap、Secret）至本地环境
• RBAC兼容：支持基于Kubernetes RBAC的权限控制，确保集群访问安全性

使用场景

• 本地开发调试Kubernetes集群中的微服务，直接验证代码变更
• 测试微服务间依赖关系，模拟生产环境服务调用链
• 在不影响集群其他服务的前提下，进行服务故障注入与恢复测试
• 快速验证配置变更对服务行为的影响，无需重新部署

Docker部署示例

Kubernetes Deployment配置

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: telepresence-k8s-sidecar
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: telepresence-sidecar
  template:
    metadata:
      labels:
        app: telepresence-sidecar
    spec:
      containers:
      - name: telepresence-sidecar
        image: docker.xuanyuan.run/[镜像名称]  # 替换为实际镜像地址
        env:
        - name: TELEPRESENCE_NAMESPACE
          valueFrom:
            fieldRef:
              fieldPath: metadata.namespace
        - name: TELEPRESENCE_LOG_LEVEL
          value: "info"
        ports:
        - containerPort: 8080  # 流量代理端口
        volumeMounts:
        - name: kubeconfig
          mountPath: /root/.kube/config
          readOnly: true
      volumes:
      - name: kubeconfig
        secret:
          secretName: kubeconfig-secret  # 包含集群访问配置的Secret

注意事项

• 需与Telepresence客户端版本匹配（建议使用相同版本号），避免兼容性问题
• 集群需开放8080/tcp、443/tcp端口，确保代理流量正常传输
• 运行时需挂载Kubernetes API访问配置（如kubeconfig）或配置ServiceAccount权限
• 支持的Kubernetes版本：1.21+