cqse/teamscale-jacoco-agent repository overview

⁠⚠️ DEPRECATION WARNING

This Docker image has been moved to a new location. Future updates and releases will be published at:
👉 cqse/teamscale-java-profiler⁠

Please update your docker pull commands and FROM statements in Dockerfiles to use the new repository.

---

⁠Teamscale JaCoCo Agent

⁠Download

• Binary Distribution⁠
• Docker Container⁠

⁠Documentation

• Teamscale JaCoCo Agent⁠
• Java Web Start Wrapper⁠

⁠Development

⁠Build locally

• Import in Eclipse/IntelliJ as Gradle project
• Command line: ./gradlew assemble
• Local docker build: docker build -f agent/src/docker/Dockerfile .

⁠Debug locally

For IntelliJ, there is a run config SampleApp which profiles the included sample-debugging-app and can be used to debug the agent. This run config omits relocating packages in the shadow jar because with relocating, the package names in the jar would not match with the ones IntelliJ knows from the code and so debugging would not work. The agent is configured in the config file sample-debugging-app/jacocoagent.properties. By default, no upload is configured but the file includes all required options to upload to Teamscale, they are just commented out. Feel free to adapt it to your needs.
If you get an IllegalStateException: Cannot process instrumented class com/example/Main, make sure that you use the built in IntelliJ functionality for building and running instead of gradle (IntelliJ Settings -> Build, Execution, Deplyment -> Build Tools -> Gradle -> Build and run using: IntelliJ IDEA).

⁠Debugging the Gradle plugin

• increase the plugin version in build.gradle and in BuildVersion.kt
• ./gradlew publishToMavenLocal will deploy your checked out version to your local m2 cache
• then you can import this version into any other gradle project by
  • replacing the share.cqse.eu repository with the mavenLocal() repository in the buildscript section of the project's build.gradle
  • adding repositories { mavenLocal(); mavenCentral() } to the body of the build.gradle
  • declaring a plugin dependency on the incremented version of the teamscale plugin
• to debug a build that uses the plugin, run ./gradlew with --no-daemon -Dorg.gradle.debug=true. The build will pause and wait for you to attach a debugger, via IntelliJ's Run > Attach to Process.
• to debug the impacted test engine during a build, run ./gradlew with --no-daemon --debug-jvm and wait for the test phase to start. The build will pause and wait for you to attach a debugger, via IntelliJ's Run > Attach to Process.
• These two debug flags can also be combined. The build will then pause twice.

⁠Contributing

• Create a JIRA issue for changes
• Use pull requests. Complete the "Definition of Done" for every pull request.
• There's a Teamscale project, please fix all findings before submitting your pull request for review. The Teamscale coding guidelines and Definition of Done apply as far as possible with the available tooling.

⁠Publishing

When master has accumulated changes you want to release, please perform the following on master in a single commit:

• Update the changelog⁠ and move all changes from the Next release section to a new version, e.g., 21.3.0.
• Update the build.gradle⁠'s appVersion accordingly.
• Commit and push your changes.
• Create a GitHub Release tag with the same version number and the text from the changelog.
• Once the build for the tag⁠ is successful, inform the release crew on Slack (#release-crew via Slack⁠) that the artifacts can now be promoted to Maven Central.
• The release crew will then Close and Release the staging repository⁠. The credentials are stored in 1Password.

Releases are numbered according to semantic versioning (see full changelog⁠).

All tags are built automatically using Github Actions⁠ and Docker Cloud Build⁠ with the release binaries being uploaded to the GitHub Releases.

Only use GitHub releases in production. This ensures that we always know which code is running in production.

⁠Compiling for a different JaCoCo version

• change ext.jacocoVersion in the build script
• ./gradlew dist
• Do not commit unless you are upgrading to a newer version!