Manage as Code
With the Steadybit CLI, you can keep teams, their members and permissions, and environments as YAML files in a Git repository and apply them to the platform from a pipeline. Onboarding a new team then means opening a pull request instead of clicking through the UI. It works like infrastructure as code: diff shows what a change would do, and apply makes it so.
The same works for experiment templates, property definitions, hubs, integrations, and service profiles. This page focuses on teams and environments.
Prerequisites
The CLI installed.
An access token of type Admin. Creating teams and environments, and exporting the tenant, needs admin permissions.
Step 1 - Export Your Current Setup
Start from what the platform already has, so that the files have the right format and nothing is lost on the first apply:
steadybit export --tenant -d ./platformThis writes one directory per kind, among them environments/ and teams/. Delete the directories of kinds you don't want to manage from Git. apply and diff only look at the directories that exist.
Commit the result to a Git repository.
Step 2 - Describe Environments
An environment is a file in platform/environments/. The query selects the targets the environment contains:
name: Payments Prod
query: k8s.cluster-name="prod" and k8s.namespace="payments"A file without an id creates a new environment. The CLI writes the new id back into the file. Commit it, though a file without an id still matches an existing environment by its name.
Step 3 - Describe Teams
A team is a file in platform/teams/. The key identifies the team, so changing it creates a new team:
allowedEnvironmentsnames the environments the team may use, by name.allowedActionslists the ids of the actions the team may run.steadybit action listshows the ids available in your tenant.membersgives each member's email, or theusernamean export writes, and a role ofOWNERorMEMBER.
Together, allowedEnvironments and allowedActions are the team's maximum blast radius, as described in Teams.
Step 4 - Review and Apply
apply handles the kinds in an order that resolves their references. Environments come before teams, so a team can name an environment created in the same apply.
To apply a single kind, use its own command, for example steadybit team apply -f ./platform/teams -R or steadybit environment diff -f ./platform/environments -R.
Run It From a Pipeline
Store the admin access token as a CI secret, review the dry run on pull requests, and apply on the main branch. With GitHub Actions:
Running steadybit diff -d ./platform on a schedule tells you when someone changed the platform in the UI, as it exits with 2 when the platform and the files differ.
To let the new team run its own experiments from its own pipeline, give it a team access token:
Caveats
Compared to a tool like Terraform, keep the following in mind:
Nothing is deleted.
applycreates and updates, but never deletes a team or an environment whose file is gone. Delete those explicitly withsteadybit team deleteorsteadybit environment delete.Only files are compared.
diffreports differences for the files you have, not for teams or environments created in the UI that have no file.There is no state file. Teams are matched by their key, and environments by their id or else their name. Renaming an environment in a file without an
idcreates a new environment.The member list is complete. Applying a team file sets its members to exactly those listed: members missing from the file are removed from the team.
members: []removes everyone not managed by OIDC or LDAP.Users must exist before they can be added. Members whose email the platform doesn't know yet are skipped without an error. Invite them first with
steadybit user invite --email jane@example.com(SaaS only), or let them log in once with single sign-on, then apply again.Actions must be available. The platform rejects a team whose
allowedActionsinclude an action no installed extension provides. Install the extensions before applying.OIDC and LDAP manage their own members. If the OIDC Integration or LDAP Integration syncs teams, membership comes from the identity provider:
applynever removes members it manages. Manage the team's environments and actions from Git, and its members in the identity provider.The token needs admin permissions. Keep the admin token in the pipeline's secrets only, and give teams their own team tokens for their experiments.
Last updated
Was this helpful?
