Skip to content

Tutorial

This tutorial introduces ConfigHub by doing the thing ConfigHub is for: running the same piece of software in multiple places and keeping its configuration under control as it changes.

You'll bring up a local Kubernetes cluster wired to ConfigHub, install a component from a config bundle with one command, and make it live by creating a deployment and releasing it. Then you'll change it, add a second cluster with a production deployment, and flow a change through the whole graph — base to dev to prod — the way you would in a real fleet.

The steps:

  • Set Up Confighub: Get an account, install the CLI and authenticate
  • Set Up Your Cluster: a local kind cluster wired to ConfigHub with cub cluster up
  • Install a Component: a component's base, seeded from a config bundle with cub variant upload
  • Go Live: create the dev deployment, publish a release, watch the cluster pull it
  • Make a Change: the core loop — change the base, promote, release
  • Add a Production Deployment: a second cluster, and a new deployment stamped from the base
  • Flow a Change: a change flows base → dev → prod, verified in dev first, while a deployment keeps the value it protected
  • Make and Undo a Change: make a temporary operational change in production and then undo the change

Let's get started.