Run Local Code in Cloud Conditions with mirrord

Ever wished you could test your local code against real cloud environments without actually deploying it? Or maybe you’re tired of setting up complex local mocks for cloud services just to debug an issue? That’s where mirrord comes in—a tool that bridges the gap between your local dev environment and your cloud setup.

What It Does

mirrord lets you run your local process as if it were in the cloud, intercepting traffic, environment variables, and even file access from a remote Kubernetes pod. Instead of deploying your code to test cloud behavior, you can just point mirrord at a pod in your cluster, and your local app will behave like it’s running there.

Why It’s Cool

• No More Fake Mocks: Test against real cloud dependencies (databases, queues, etc.) without deploying.
• Debug Like a Pro: Reproduce cloud-specific issues locally without extra setup.
• Traffic Mirroring: Forward or mirror incoming traffic from a cloud pod to your local machine.
• Kubernetes-Native: Works seamlessly with k8s, so you can target any pod in your cluster.

It’s like kubectl port-forward on steroids—but for everything your app interacts with.

How to Try It

1. Install mirrord:

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

2. Run your app with mirrord:

   mirrord exec -t your-deployment python3 app.py
   

   Or use the VS Code extension for a GUI experience.

Check out the docs for more advanced setups.

Final Thoughts

mirrord is one of those tools that feels like cheating—it removes so much friction from cloud development. If you’ve ever wasted time syncing local and remote environments, give it a shot. It’s open source (MIT licensed), so you can poke around the GitHub repo or contribute if you’re into Rust.

For more cool projects like this, follow @githubprojects.