A sample Java application to showcase ExplorViz as a Service, based on Spring PetClinic.
ExplorViz is an open source research monitoring and visualization approach, which uses dynamic analysis techniques to provide a live trace visualization of large software landscapes.
ExplorViz as a Service (EaaS) allows you to collect build artifacts and run them in ExplorViz instances on-demand.
When submitting builds to EaaS, they need to be wrapped inside a docker image that runs both the application and, if necessary, some load to create more interesting visualizations.
This repository serves as an example how to create such images (by using EaaS-base-image) and submit them to your EaaS instance.
This will merely run Spring PetClinic; to see EaaS in action see below.
git clone https://github.com/ExplorViz/EaaS-demo-application.git
cd EaaS-demo-application
./mvnw package
java -jar target/*.jar --server.port=8090
You can then access the application here: http://localhost:8090/
Or you can run it from Maven directly using the Spring Boot Maven plugin. If you do this it will pick up changes that you make in the project immediately (changes to Java source files require a compile as well - most people use an IDE for this):
./mvnw spring-boot:run
First, run an instance of ExplorViz as a Service on a server reachable from the internet. Create a project using any name you want.
Fork this repository on GitHub and enable GitHub Actions. A workflow is included (.github/workflows/build.yml
) that will build this project and submit a build artifact to an EaaS instance whenever changes are pushed to the repository.
Then configure the workflow by creating secrets in the GitHub repository settings:
EAAS_URL
: Set this to the URL where your EaaS instance can be reached from the internet (Important: no trailing /)EAAS_PROJECT
: Set this to the ID of the EaaS project, you can find it on the projects settings pageEAAS_SECRET
: You can obtain one from the projects secrets page
You can then make changes to the application and push them to the repository and the GitHub Action will automatically create a build and submit it to the configured EaaS instance. You can see and run these builds through the EaaS webinterface.
Fork this repository on GitHub and login on Travis, make sure Travis can see the repository. A travis configuration is included (.travis.yml
) that will build this project and submit a build artifact to an EaaS instance.
Then configure some environment variables in Travis:
EAAS_URL
: Set this to the URL where your EaaS instance can be reached from the internet (Important: no trailing /)EAAS_PROJECT
: Set this to the ID of the EaaS project, you can find it on the projects settings pageEAAS_SECRET
: You can obtain one from the projects secrets page. This should be set to hidden
You can then make changes to the application and push them to the repository and Travis will automatically create a build and submit it to the configured EaaS instance. You can see and run these builds through the EaaS webinterface.
EaaS-demo-application is released under version 2.0 of the Apache License.