mirrord

环境要求

• macOS 上可用的 Homebrew，或可执行 curl 的 shell 环境
• 一台可访问的 Kubernetes 集群，以及本机默认 kubeconfig（mirrord 用它访问 Kubernetes API）
• 集群中存在可作为 impersonate 目标的 Pod（需自行确认命名空间与 Pod 名）
• 希望调试的本地进程（如 node app.js 等）

安装与启动步骤

1. 1安装 mirrord CLI

   二选一：用 Homebrew 安装，或在没有 Homebrew 的环境下用官方脚本安装。二者择一执行即可。

   brew install metalbear-co/mirrord/mirrord

   复制

2. 2脚本方式安装(可选)

   若不使用 Homebrew，可用官方安装脚本下载安装 mirrord，需保证本机可访问 GitHub。

   curl -fsSL https://raw.githubusercontent.com/metalbear-co/mirrord/main/scripts/install.sh | bash

   复制

3. 3准备集群访问

   mirrord 使用你机器上的默认 kubeconfig 访问 Kubernetes API，请确认该 kubeconfig 指向要使用的集群并有相应权限。

4. 4确定目标 Pod

   先确定要模拟运行的 Pod 名称与命名空间，后续把它作为 --target 参数传入，形如 pod/my-pod。

5. 5运行本地进程

   用 mirrord exec 包裹原本的启动命令，并指定目标。本地进程即会通过该 Pod 获得其环境变量、DNS、网络与流量。

   mirrord exec node app.js --target pod/my-pod

   复制

6. 6IDE 插件替代方案

   也可改用 VS Code 扩展或 IntelliJ 插件：安装后在状态栏/工具栏点击启用 mirrord，再启动调试并选择要模拟的 Pod。

关键配置

如何确认成功

执行 mirrord exec 后本地进程正常启动，且能读到目标 Pod 的环境变量、DNS 与集群内服务响应，即表示已成功接入集群。

常见问题

注意事项

• mirrord 依赖本机默认 kubeconfig 访问 Kubernetes API，请确保其指向正确集群。
• 本地代码运行在本机，流量、文件与环境变量通过集群目标 Pod 路由，改完无需重新部署即可验证。
• 安装方式除 brew 外还可用官方 curl 安装脚本；另有社区维护的 Nix 方式（非官方）。
• 使用 IDE 时可直接用 VS Code 扩展或 IntelliJ 插件替代 CLI。