mirrord lets you easily mirror traffic from your Kubernetes cluster to your development environment. It comes as both Visual Studio Code extension and a CLI tool.
Getting Started
mirrord uses your machine's default kubeconfig for access to the Kubernetes API.
Make sure your local process is listening on the same port as the remote pod.
VSCode Extension
Installation
Get the extension here.
How to use
- Click "Enable mirrord" on the status bar
- Start debugging your project
- Choose pod to mirror traffic from
- The debugged process will start with mirrord, and receive traffic
CLI Tool
Installation
curl -fsSL https://raw.githubusercontent.com/metalbear-co/mirrord/main/scripts/install.sh | bash- Windows isn't supported currently (you can use WSL)
How to use
mirrord exec <process command> --pod-name <name of the pod to impersonate>e.g.
mirrord exec node app.js --pod-name my-podHow it works
mirrord works by letting you select a pod to mirror traffic from. It launches a privileged pod on the same nodewhich enters the namespace of the selected pod and captures traffic from it.
Contributing
Contributions are welcome via PRs.
Help & Community 🎉 ✉️
Join our Discord Server for questions, support and fun.
Code of Conduct
We take our community seriously and we are dedicated to providing a safe and welcoming environment for everyone. Please take a few minutes to review our Code of Conduct.