Skip to content
GitHub

Permanent lanes

A permanent lane is a lane that is never closed: a staging next to main, that work lands on before it reaches main, and that CI deploys from.

Terminal window
kito lane create staging
kito lane open alice --intent "users have a team" --scope src/api.py --on staging

Landing on a permanent lane makes a checkpoint of it, runs its checks, and exports the checkpoint to a git branch of its own, staging, pushed with main’s:

lane/2: landed on staging as ckpt#2 (git 07b67ccad5), verified in 0.3 s

What lands on main directly comes into staging as a merge:

Terminal window
kito lane catch-up staging

When staging is good, it lands on main as a git merge of the two branches, and stays open, brought up to main:

Terminal window
kito integrate staging
* 3ce6813 (HEAD -> main) staging
|\
| * 5e7f5e3 (staging) catch up with main
| |\
| |/
|/|
* | 8335d1d a readme
| * 41708f7 show the team
| * 07b67cc users have a team
|/
* fc1d222 an app with an API and a page
[lanes.staging]
verify = ["npm test"] # its checks, instead of [verify]
branch = "staging" # its git branch (default: its name)
integrate = ["ci"] # who may land on it (default: whoever may integrate)