Projects Builds

Projects and Builds

This page describes how Superblocks handles organization projects and automates their builds.

Overview

A Project is a connection between Superblocks and GitHub. Each project can be linked to one or more GitHub repositories.
Once linked to a repository and configured according to Superblocks specifications, every associated code commit automatically triggers a build in Superblocks.

Creating a Project

On the Landing page, access the Projects sub-section by clicking the button.

Access Projects

If you don’t have any projects set up, you will see a button called Create Project otherwise, on the top right corner, press the Create Project button. Fill in a valid Project name and optionally add a Description, which will be presented in the organization projects list. Finally, press the Create Project button.

Create Project

On the top right corner, press the Create Project button. Fill in a valid Project name and assign the project to an existing workspace or create a new one. Finally, press the Create Project button. Create Project

Connecting to a repository

In case an empty project already exists, the Setup new build which can be found in the Builds section of the side menu option leads to the Setup your Build Pipeline screen. Setup your Build Pipeline

After creating or selecting an existing project, find the repository you would like to connect to by browsing the repositories list. Use the Filter projects and the drop-down menu on the right side of the search bar to further limit the results.
Then, press the Select repository button. Select repository

You will be redirected to the project Builds.
Empty Builds screen

Viewing Builds

Inside the project Builds view, the contents are displayed on a per-repository basis. Inside each connected repository, there are two sections: Pipelines and Configuration. Each one lists all entries resulted by actions performed by Superblocks.

Pipeline and Configuration entries describe the last output status, the unique identifier, branch and commit references to the connected repository, as well as the elapsed time and creation date.