Instances & Console

Merging branches between stages

How to merge an instance branch into a target branch to promote work between development, staging, and production.

What the Merge action does

Every instance in CICDoo is tied to a git branch. When work on one branch is ready to move forward, you merge it into another branch. The instance running the target branch then picks up the merged code through a deployment.

How to merge

  1. Open the instance whose branch you want to merge (the source).
  2. In the quick actions row under the instance header, click Merge.
  3. In the Merge Branch dialog, type the target branch name (for example, main).
  4. Click Merge.

The merge runs as a job in the queue. Open the Queue tab to watch its status and read the log, see Deployments and the job queue.

Typical flow: development to staging to production

A common promotion flow looks like this:

  • Build and test a feature on a Development instance.
  • Merge the development branch into your Staging branch and verify the result on the staging instance.
  • When staging looks good, merge the staging branch into your Production branch to release it.

The Merge dialog is a free text field, so double-check the target branch name before confirming. Merging into the wrong branch triggers a deployment on whatever instance runs that branch.

Plan and permission requirements

  • Plan gating: branch merging is not included in the Free plan. It is available on Pro and Enterprise plans. Current prices are on the pricing page at cicdoo.com.
  • Workspace permissions: in a workspace, the Merge button is only shown to members who have the instance merge permission. If you do not see it, ask the workspace owner.

After the merge

The target instance deploys the merged code. If you also want modules upgraded on the target instance, run a Soft Restart there, see Restarting, stopping and removing an instance. If the merge job fails, open its log from the Queue tab to see the reason (for example, a merge conflict that has to be resolved in git).

If you get stuck, open a support ticket from the Tickets page or the chat widget.

Still stuck? Open a ticket from the app or talk to an engineer.