Basic workflow with Snake CI from the developer perspective
Snake CI consists of two parts — the add-on and the runner. The add-on is what provides the UI for users in your Bitbucket Server / Data Center. The runner is what is going to handle your workload and execute the pipelines you give.
There is a little bit of requirements for the add-on to be up and running.
You need a recent version of Bitbucket Server (we recommend version 6.0 or later) to get up and running.
To run your pipeline jobs, you also need a Docker host or Kubernetes cluster to create and manage containers.
While you can use the same system where you host Bitbucket, we encourage you to use a different host because it is much easier to scale and manage.
You need a recent version of Docker daemon up and running on any supported OS such as Linux, Windows or macOS. Check the official guide for details.
There are two ways to ship the add-on for your Bitbucket Server / Data Center:
- Navigate to Bitbucket admin panel → Find new apps → Search for Snake CI → and click Install.
- Download JAR file from the Atlassian Marketplace page: Snake CI Add-on.
Snake Runner can be installed on Linux, Windows or macOS. Read the comprehensive guide on how to set up Snake Runner in Docker.
Ensure runner is connected
Navigate to Bitbucket admin panel → CI/CD section → Runners. There, you will see a list of every runner and its status.
The runner must have the online status to receive jobs and execute them.
Is everything up and running? Follow this basic workflow to set up your first pipeline.
Installation and configuration of the Snake CI add-on for Bitbucket Server & Data Center
Setup and run Snake Runner to handle your workload.