Telepresence无法从GitLab CI Job容器调用API问题排查

核心原因 #

Telepresence在容器内运行时，会创建进程级的DNS代理或端口转发规则，这些规则默认仅在运行Telepresence的Service容器内部生效。即便Job容器与Service容器共享网络，Job容器的DNS解析和网络路由不会自动继承Service容器里Telepresence的配置——因为Telepresence的代理逻辑不会修改整个共享网络的全局DNS或路由表。

可行解决方案 #

方案1：在Job容器内直接运行Telepresence #

• 放弃将Telepresence部署在Service容器，改为在Job容器的执行脚本中直接安装并启动Telepresence。
• 示例CI配置片段：

job_with_telepresence:
  script:
    - curl -fL https://app.getambassador.io/download/tel2/linux/amd64/latest/telepresence -o telepresence
    - chmod +x telepresence
    - sudo ./telepresence connect
    - # 此处执行你的API调用命令

• 优点：配置简单，Job容器直接拥有Telepresence的代理能力，无需依赖Service容器的网络配置。

方案2：暴露Service容器的Telepresence代理端口 #

• 在Service容器的启动脚本中，启动Telepresence时指定--expose参数，将代理端口绑定到容器的全局网络接口（而非仅本地回环）：

telepresence connect --expose 0.0.0.0:8080

• 在Job容器中，将API请求的目标地址改为[Service容器别名]:[暴露的端口]，同时确保Telepresence的代理规则允许转发该API的请求。
• 注意：需提前配置好Telepresence的代理规则，避免出现权限或路由异常。

方案3：共享Telepresence的DNS配置 #

• 将Service容器中Telepresence生成的DNS配置文件（通常位于/etc/resolv.conf）挂载到Job容器中。
• 示例CI配置片段：

job:
  services:
    - name: your-telepresence-service
      alias: telepresence-service
  script:
    - # 拷贝Service容器的DNS配置到Job容器
    - docker cp telepresence-service:/etc/resolv.conf /etc/resolv.conf
    - # 执行API调用命令

• 缺点：依赖Docker命令，部分GitLab CI运行环境可能限制Docker操作，且DNS配置路径可能随Telepresence版本变化。

内容的提问来源于stack exchange，提问作者Abhishek Bhaware