Previews of merge requests
Once a team lead turns previews on, kanman starts every new merge request on your own runner, checks it and links the running preview in the merge request.
Reading a diff tells you what changed. A preview lets you click through it. With previews on, kanman starts every new merge request of your team on your own runner, checks it against the story and puts a link to the running preview in the merge request, so reviewers try the change before it merges.
Previews are part of team apps, which come with the Enterprise plan.
Turn previews on
Previews are off for every team until a lead decides otherwise. To turn them on:
- Open the team and go to Team > Environment.
- Open Previews and switch on Preview new merge requests.
The team’s leads, the person who created the team and workspace admins can change it. Everyone else in the team sees the setting but cannot change it.
Only merge requests opened after you turn previews on get a preview. The ones that were already open are left alone, so nothing starts on your runners that nobody asked for. The setting shows since when previews are on.
To stop, switch the setting off. kanman stops the previews that are still running and starts no new ones. If you turn previews on again later, only merge requests opened from then on get a preview.
What a preview does
- Runs on your runners only. A preview never runs in kanman’s cloud. A team without a runner sees that one is needed.
- Uses your preview settings, never production. The app gets the variables you set for previews. Production secrets are never mounted, and the preview reaches only the hosts you allow under Team > Environment > Internet access.
- Is checked. kanman opens the pages, follows links and API calls, checks accessibility and the story’s acceptance criteria, and compares with the target branch, so only what the merge request broke counts as a failure.
- Reports in the merge request. The result and the link to the preview appear as a comment on the merge request and as a note on the story.
- Is visible to your team only. Only members of the team can open a preview.
- Stops by itself when the merge request is merged or closed, and after a quiet period without visits.
When kanman suggests previews
If a team lead talks to kanman about how a change behaves when it runs, for example a page that broke after a merge or a change nobody could click through in review, kanman may suggest previews in the chat. It suggests them once per team, only to leads, and never turns them on itself: the suggestion has one button that opens the setting. No thanks ends it for good.
Last updated: January 1, 0001
Open kanman