Trigger and Rollback

As a developer you may want to trigger a new build or rollback to a previous build generation. The BUILDS allow you to do that.

In the BUILDS page select the particular build from the build list and click on SHOW MORE, this will open the Details tab of the selected build. It displays information on the build, current build generation number, git repository etc.

Suppose the current build generation number is i. If you update the source code in the git repository, you may want to trigger a new build to reflect the new code changes. As a result, a new build generation number (i+1) is generated. To trigger a new build, select the particular build and click Trigger build for that build.

You may always Trigger a new build irrespective of the status of the previous build. That is you can trigger a new build from either a Complete build or an Error build.

Packages which have builds that are in Complete status are suitable for a deployment. The InProgress and Failed builds are unfit for deployment.

You may also view details such as the git repository URL where the source code is hosted, the latest commit SHA number, the commit message and the commit owner’s name by clicking View details/logs in the Build history tab of the build.

View details or logs

You may also Rollback to a previous build generation number if there is any, irrespective of the previous build status. Rollbacking to a previous build does not restart the build process. Instead, on using the build in next deployment it would run the corresponding docker image that was generated for that build generation.

The Current build generation number (Gen) is shown below the build ID.

Current build generation number

The builds are automatically restarted on platform internal failures. Click Refresh if you observe that the build logs are abruptly disconnected or stopped

When a build fails, it is recommended to check the corresponding build logs to debug. It can be due to multiple reasons like:

  1. Repository access issue
  2. Incorrect context directory path
  3. Incorrect catkin parameters
  4. Incorrect dockerfile path