Mirrord NPM | npm.io

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

VSCode Extension
CLI Tool
mirrord uses your machine's default kubeconfig for access to the Kubernetes API.

VSCode Extension

Installation

Get the extension here.

How to use

Start debugging your project
Click "Start mirrord" on the status bar
Choose pod to mirror traffic from
To stop mirroring, click "Stop mirrord" (or stop debugging)

Currently the extension only captures port 80, but that will be configurable soon. The extension automatically detects which port your debugged process listens on and directs the mirrored traffic to it. If you prefer to direct traffic to a different local port, edit launch.json:

{ "mirrord": { "port": "<port to send traffic to>" } }

CLI Tool

Installation

npm install -g mirrord

How to use

mirrord <pod name>

For more options, run:

mirrord --help

How 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.

For more technical information, see TECHNICAL.md