Bamboo CI integration with Dashboard Creation

Abstract

Appvance IQ typically runs using a Docker Linux environment which is natural for ANT tasks, those tasks trigger different parts of the process, the behavior is ruled by parameters that are stated in a build.xml file located in the root of the repository.
In this document, you will find how to implement these ANT tasks using Bamboo.

Bamboo server requirement

Assuming that an existant Bamboo server, the only thing we need to add to the server isthe Apache Ant build scripting language, please follow the installation guide in https://ant.apache.org/manual/install.html, later it will be necessary to reference it in the Bamboo configuration as a server executable providing a label and the full path to the package executables.

Plan Configuration

The native build configuration is based in agents, Dockers configuration are not covered in the present document

Create a Project

Give the project a name and a key as an acronym, optionally you can fill the description with some relevant info.

Create a Plan

Give the plan a name and a key as an acronym, optionally you can fill the description with some relevant info.

Set the repository

Fill the repository credentials fields and the correct branch and click in the Configure Plan button

Fill the repository credentials fields and the correct branch and click in the Configure Plan button

Configuring the plan

It will be redirected to this form

All the necessary jobs for the scenario execution have been created as ant tasks, please modify the paths as per the environment you are setting up and create the following tasks in this order

It is important to have the Force Clean Build option checked to avoid accumulating the results in the Dashboard of each of the plan executions.

Updating necessary dependencies to execute different AppvanceRestClient ant tasks.

Scenario execution as it has been stated in the build.xml file

Based on the results of the scenario execution the dashboard is updated

Windows agent requirements

  1. It is needed to have Appvance IQ completely installed in the agent Run Appvance IQ on Windows using autologon tool and task scheduler (for the IE issue when running as a service). See Runing Appvance IQ on Windows as a Service

  2. Access to a database (MySQL or Oracle) with AIQ schema created, it can be local or remote.

  3. Apache Ant build scripting languaje, please follow the installation guide in https://ant.apache.org/manual/install.html, later it will be necessary to reference it in the Bamboo configuration.