Skip to main content

Teams and companies

One install, used by everyone who ships software in the company. Developers deploy on their own, without a ticket to operations and without learning Kubernetes. The platform team decides the shape: which workspaces exist, who may do what in them, and where they run.

Good for: startups that outgrew Docker Compose, product teams sharing infrastructure, an internal developer platform, and agencies building and running apps for themselves.

An identity provider signs people in; a Git forge triggers runners that push images to the built-in registry, which deploys to the web, data and tools workspaces

How to cut workspaces​

A workspace is the boundary for data, secrets, network, members and quotas. Cut it where one of those must differ.

Cut byWhenExample
Team or productEach team owns its apps and should not touch another'sweb, mobile-api, data
EnvironmentProduction must have fewer people with write access than stagingshop-staging, shop-production
ClientYou build and run apps for others; see Hosting providers and agenciesclient-jkantech

Environments add approval gates to releases: a release needs a set number of approvals before it is promoted. Promotion redeploys the same application, so a stage with its own variables, secrets, domain or database still needs its own application, and usually its own workspace. See laying out workspaces for the per-stage and per-project layouts.

Which setup?​

How many teams you have does not decide the hardware; how long an app may be down, and where its users are, does. Most companies start on one server and grow without reinstalling.

Your situationSetup
Internal tools and staging that can wait while a server rebootsOne server
Customer-facing apps that must stay up through a node failureOne cluster, several servers
Those apps also keep uploads or files on diskReplicated storage on that cluster
Offices, factories or customers in several places, or production on separate hardwareSeveral clusters as regions

Setting it up​

  1. Connect the company's identity provider as an OIDC SSO provider, so people sign in with their work account and leave when HR offboards them. Mapping identity-provider groups to workspace roles is Enterprise.
  2. Create the workspaces and invite people with a role: Owner, Admin, Developer or Viewer. Give most people Developer; keep Owner for the few who manage members and settings.
  3. Register build runners. A workspace may register its own machines, which it alone uses, or build on the platform's shared runners.
  4. Put the configuration in Git. Declare apps, databases, volumes and routes in manifests and let GitOps reconcile them, or run miabi apply from CI. The console stays available for anything ad hoc.
  5. Keep secrets in the vault. Reference them as ${{ secrets.NAME }} in manifests and pipelines; values never appear in Git. See Secrets.

Keeping production apart​

Production on separate hardware is a placement question, not a separate install:

  • Run production and staging in different locations, so a load test in staging never competes with production for CPU.
  • Set each workspace's default location, so new apps land in the right place without anyone choosing.
  • Use a tighter plan for staging workspaces, so a runaway experiment hits a quota instead of the production nodes. See Plans & quotas.

Automating it​

Everything in the console is an API. Teams that manage infrastructure as code can drive Miabi from:

Where to go next​