Installing / Upgrading Cover Reports
- Choose a location
- Deploy Cover Reports
- Version number
- Pre-loaded sample project
- Stopping the service
- Upgrading Cover Reports
Cover Reports is a web application that is installed using docker.
Therefore, before installation the following must be installed:
- docker-compose (
docker-composeis included in docker-desktop if you are using macOS or Windows. For Linux please download docker-compose separately).
Choose a location
Also, the chosen host must be accessible by:
- Cover CLI
- Users who want to view reports
Diffblue recommends using the default port of 8080.
Should you need to change the port, edit
docker-compose.ymland change the default from 8080 to the port you want to serve Cover Reports on.
Deploy Cover Reports
- Log in to your chosen host (e.g. docker-hub)
Navigate to the directory where the installation is to be made. This will be the home directory of Cover Reports e.g.:
- Copy the Cover Reports
Start the application in the home directory of Cover Reports using:
docker-compose up -d
The application is now installed and deployed. Once docker has run, you can open your selected host - default http://localhost:8080/ to see a page similar to this:
docker-compose in the background, add the
The version number is at the bottom of the window, on the left.
Pre-loaded sample project
An example project is included with Cover Reports as part of the installation, to help users get started quickly. Click on the Open Demo Project button.
The next step is to use Cover to upload your report bundles into Cover Reports.
Stopping the service
Please use the command:
Upgrading Cover Reports
Cover Reports is designed to perform upgrades automatically upon deployment. This means there are no actions required to trigger an upgrade. However, since Cover Reports is already installed, there are a few additional steps needed to replace the current installation.
On the Cover Reports host machine:
- Navigate into the directory on the host machine where Cover Reports is installed
- To stop the current system, run:
- Rename the
docker-compose.ymlto include the current installation release version in its name, e.g.
docker-compose-2022.09.01.yml. (In future, this (and the associated docker TAR file, if used) can be archived.)
- Copy the new release
docker-compose.ymlinto the same directory
- If using the docker TAR file, install the docker images into the local repository as before, e.g.:
docker load -i cover-reports.tar.gz
- To start the application, run:
docker-compose up -d.
During startup the need to upgrade will be determined. If required, the upgrade process will run. This may take some time, especially where the database has a large number of project runs. It will not be possible to upload new project runs until this upgrade has completed. During this time, viewing reports may also be limited.
The completion of the upgrade will result in the application being up and running and able to upload new project runs. Currently, this can only be determined from the docker logs for the report-web image, which should contain “Upgrade completed successfully”.
Because the upgrade process can take time and the system will be unavailable at this time, it is best to perform the upgrade when there are no users on the system.