Telepresence项目：在Docker或虚拟机中托管Kubernetes集群的网络配置指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00063/article/details/148465265

Telepresence项目：在Docker或虚拟机中托管Kubernetes集群的网络配置指南

telepresence Telepresence是一个开源的本地开发工具，用于在本地计算机上模拟远程Kubernetes集群环境。 - 功能：本地开发；远程Kubernetes集群模拟；Kubernetes集成；网络代理。 - 特点：易于使用；支持多种编程语言；实时代码部署；与Kubernetes集成。项目地址: https://gitcode.com/gh_mirrors/te/telepresence

概述

在使用Telepresence与本地托管的Kubernetes集群（如Docker Desktop、Kind、Minikube或k3s）交互时，网络配置是一个需要特别注意的关键环节。本文将深入探讨常见的网络问题及其解决方案，帮助开发者构建稳定的本地开发环境。

网络问题根源分析

Telepresence通过创建虚拟网络接口(VIF)将集群子网映射到主机。当集群节点也能访问主机设备时，就会出现网络冲突：

双重映射问题：集群节点和Telepresence VIF同时映射相同的子网
递归连接风险：请求可能在VIF和集群间无限循环
资源消耗：递归连接会导致大量快速连接请求，消耗系统资源

解决方案一：配置递归阻断

技术原理

通过设置routing.recursionBlockDuration参数，Telepresence可以在建立连接后暂时阻断相同IP:PORT的新连接，有效防止递归循环。

配置方法

在Telepresence客户端配置中添加：

routing:
  recursionBlockDuration: 1ms

适用场景

快速临时解决方案
测试环境验证
资源受限的环境

解决方案二：创建桥接网络

技术优势

桥接网络作为链路层(L2)设备，能够：

绕过主机的网络栈
让Kubernetes集群直接连接到主机的路由器
提供更稳定、高效的网络连接

实现步骤

修改虚拟机网络设置：将集群节点直接连接到主机的物理网络设备
配置静态IP：确保所有节点在同一子网
设置默认路由：指向主机的默认网关
配置DNS：使用外部DNS服务而非主机提供的DNS

实战案例：Vagrant+VirtualBox+k3s环境配置

环境准备

安装Vagrant和VirtualBox
准备主机网络信息：
- 桥接网卡名称
- 默认网关IP
- 外部DNS服务器IP

核心配置解析

1. 服务器节点配置

server_script = <<-SHELL
  export INSTALL_K3S_EXEC="--bind-address=#{server_ip} --node-external-ip=#{server_ip} --flannel-iface=eth1"
  # 配置容器镜像仓库
  cat <<-'EOF' > /etc/rancher/k3s/registries.yaml
  mirrors:
    "multi:5000":
      endpoint:
        - "http://#{server_ip}:5000"
  EOF
  # 安装k3s
  curl -sfL https://get.k3s.io | sh -
SHELL

2. 代理节点配置

agent_script = <<-SHELL
  export K3S_TOKEN_FILE=/vagrant_shared/token
  export K3S_URL=https://#{server_ip}:6443
  export INSTALL_K3S_EXEC="--flannel-iface=eth1"
  # 同步镜像仓库配置
  cp /vagrant_shared/registries.yaml /etc/rancher/k3s/
  curl -sfL https://get.k3s.io | sh -
SHELL

3. 网络配置脚本

network_script = <<-SHELL
  # 设置默认路由
  ip route delete default 2>&1 >/dev/null || true
  ip route add default via #{$default_route}
  # 配置DNS
  cp /etc/resolv.conf /etc/resolv.conf.orig
  sed 's/^nameserver.*/nameserver #{$nameserver}/' /etc/resolv.conf.orig > /etc/resolv.conf
SHELL

容器镜像仓库部署

部署Kubernetes registry的YAML配置要点：

使用registry:2官方镜像
配置5000端口服务
设置持久化存储卷
创建LoadBalancer类型服务

apiVersion: v1
kind: Service
metadata:
  name: kube-registry
  namespace: kube-system
spec:
  type: LoadBalancer
  ports:
  - port: 5000
    targetPort: 5000