Skip to main content

🎛️ Config Management

Config Management is our ultimate, end-to-end solution for handling all configuration needs across MapColonies. It is built to carry your service gracefully from early development straight into production! 🚀

🧩 The Four Pillars​

Our config management ecosystem is broken down into four core parts:

  • 📜 Schemas: The central repository storing the JSON Schemas that rigidly define every config.
  • 🧠 Config-Server: The brain of the operation, centrally managing and serving all configurations.
  • 📦 Config (NPM): The lightweight NPM package you drop into your NodeJS service to easily consume configurations.
  • 🖥️ Config-UI: The sleek, user-friendly interface for manually interacting with the config server.

config parts relation diagram

💡 Why We Built This (Motivation)​

The MapColonies™ Config Management system provides a single source of truth for every service configuration.

  • ✅ Guaranteed Correctness: It validates every config against a JSON Schema, ensuring errors are caught before they break your app.
  • ⌨️ Strong Typing: Because we use schema validation, all configurations are strongly typed, giving you a flawless integration experience in your code.
  • ⚡ Instant Updates: No more painful environment variable changes or full deployment restarts! If a config changes, you just rollout the pod to instantly fetch the new configuration.

Ready to dive in? Check out the Zero to Hero Guide to seamlessly integrate this system into your service today!

🚀 What's Next?​

We are constantly improving the ecosystem. Here is what is on the horizon:

  • 🧪 Customizable Test Configs: Soon, you'll be able to effortlessly tweak configurations specifically for testing environments!
  • 🔭 Enhanced Observability: We are adding deep observability hooks for granular config analysis.
  • ✨ UI Polish: We are continuously refining the Config-UI to make your experience even smoother.