Share
Embed
Accelerating Maven Builds From Snail's Pace ๐ to Rocket Speed ๐ (JUGย Noord)
Are you tired of watching Maven builds crawl at a snailโs pace, wasting precious development time? Spending too much time at the coffee machine, or fighting battles with wooden swords under the excuse โmy codeโs compilingโ?
Join us to learn how to supercharge your Maven build! Weโll cover three main steps to start speeding up your project build. Learn how each speeds up your build, when they provide the biggest gains, and what pitfalls await.
So take the next step in boosting your developer productivity by learning practical tips to decrease context switching and increase development speed and feedback cycle. Your journey from snailโs pace to rocket speed begins today!
Maarten Mulders
November 14, 2024
Transcript
51 slides
-
ACCELERATING MAVEN BUILDS FROM SNAIL'S PACE TO ROCKET SPEED #Maven
#SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
, licensed under CC BY-NC 2.5, adopted to match the
dark background and not hurt your eyes. "Compiling" by Randall Munroe #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
(Hans Dockter, Gradle Inc.) โ We havenโt seen a company
yet where investing into more ef cient builds was not leading to a signi cant return on investment. The most successful software teams on the planet are the ones with an ef cient build infrastructure. Quantifying the Costs of Builds #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
HOW TO ACCELERATE? โฑ Measure ฬ Analyse a Improve #Maven
#SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
MEASURE YOUR BUILD MEASURE YOUR BUILD MEASURE YOUR BUILD MEASURE
YOUR BUILD MEASURE YOUR BUILD #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
THE OPENTELEMETRY MAVEN EXTENSION Time execution recorder for Maven Log
time taken by each Mojo in the build lifecycle Comes as a "Plugin on steroids": replaces or hooks into Maven core features Maven extension #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
INSTALL THE EXTENSION 1. Create .mvn/extensions.xml in your project 2.
Register the extension 3. Start an OpenTelemetry collector (such as Jaeger "all-in-one") โ <extensions> <extension> <groupId>io.opentelemetry.contrib groupId> <artifactId>opentelemetry maven extension artifactId> <version>1.36.0-alpha version> extension> extensions> Simpler alternatives #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
ACTIVATE THE EXTENSION Run Maven as you did before, but
add -Dotel.traces.exporter=otlp When done, open OpenTelemetry #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
DEMO | โ OpenTelemetry Screenshot #Maven #SnailToRocket Benjamin Marwell (@bmarwell)
& Maarten Mulders (@mthmulders) -
PARALLEL TEST EXECUTION PARALLEL TEST EXECUTION PARALLEL TEST EXECUTION PARALLEL
TEST EXECUTION PARALLEL TEST EXECUTION #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
WHAT IS IT? Parallel execution of tests inside a module.
#Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
WHEN TO APPLY If you have idle cores or tests
waiting for I/O. 1. Executes large number of tests in parallel 2. Executes long-running tests in parallel #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
โ CAVEATS 1. Tests must be parallelizable Non-thread safe tests
will make the build will fail miserably. a Fix the tests a Add @Execute(SAME_THREAD) (JUnit speci c) 2. Can bottleneck the build Use resources that would've built another Maven module. a Disable parallel test execution for speci c modules Applies to parallel builds - more on that later. #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
HOW TO EXECUTE TESTS IN PARALLEL? 1. Through Sure re
2. Through JUnit #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
1. USING MAVEN'S SUREFIRE PLUGIN Specify what to run in
parallel using the parallel parameter: 1. none 2. methods 3. classes 4. classesAndMethods 5. all #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
1. USING MAVEN'S SUREFIRE PLUGIN (CTD.) Command line: mvn -Dparallel=classesAndMethods
verify . In pom.xml : <plugin> <groupId>org.apache.maven.plugins groupId> <artifactId>maven suref re plugin artifactId> <version>3.2.5 version> <conf guration> <parallel>classesAndMethods parallel> conf guration> plugin> #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
PROS AND CONS Advantages: Supports both JUnit 4 and TestNG.
Maintained by the Maven core team Disadvantages: All tests in a module need to be thread-safe. Con guration can be repetitive / verbose. Does not apply to JUnit Jupiter. #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
2. USING JUNIT JUPITER 1. Using src/test/resources/junit-platform.properties 2. Using system
properties through argLine parameter 3. Using Java annotations #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
Using src/test/resources/junit-platform.properties # activation of parallel test execution junit.jupiter.execution.parallel.enabled =
true # tests per class (but classes in sequence) junit.jupiter.execution.parallel.mode.default = concurrent # classes in parallel junit.jupiter.execution.parallel.mode.classes.default = concurrent # both options can be combined! #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
Using system properties through argLine parameter <plugin> <groupId>org.apache.maven.plugins groupId> <artifactId>maven
suref re plugin artifactId> <version>3.2.5 version> <conf guration> <argLine> -Djunit.jupiter.execution.parallel.enabled=true -Djunit.jupiter.execution.parallel.mode.default=concurrent argLine> conf guration> plugin> #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
Using Java annotations @Execution(CONCURRENT) class MyServiceTest { test methods are
now being executed in parallel } #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
PROS AND CONS Advantages: Finer granularity of test executions Run
single tests selectively in sequence Maintained by the JUnit Jupiter team Great IDE support w/ property les and annotations Disadvantages: Speci c to JUnit Jupiter, not in TestNG, Spock and others Harder to control from the command line #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
WITH SEQUENTIAL TESTS #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten
Mulders (@mthmulders) -
WITH PARALLEL TESTS #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten
Mulders (@mthmulders) -
MAVEN DAEMON MAVEN DAEMON MAVEN DAEMON MAVEN DAEMON MAVEN DAEMON
#Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
WHAT IS IT? Provides faster Maven builds using a daemon
process. #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
HOW DOES IT HELP? 1. Keeps the JVM and plugins
"warm". 2. Runs multi-threaded by default without cluttering output. 3. Improved parallelism compared to "vanilla" Maven. Uses to build in topological order. Takari Smart builder #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
WHEN TO APPLY? 1. Large project. 2. Many plugins. 3.
"Heavy" plugins. #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
โ CAVEATS 1. Multi-threaded by default Non-threadsafe plugins may make
build fail miserably. a Circumvent by specifying -T 1 a Address the root cause: x the plugin(s) 2. Re-implements some parts of Maven Parsing .mvn/maven.config has some bugs: , . apache/maven-mvnd#913 apache/maven-mvnd#917 #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
HOW? 1. Install Maven Daemon 2. Retrain nger gymnastics: mvn
โ mvnd #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
HOW? (CTD.) A few new tricks: Use mvnd --status to
inspect details of the daemon process. Add -Dmvnd.buildTime=true for simple timing report. Add -Dsmartbuilder.profiling=true for advanced timing report. #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
DEMO Screenshots: | Maven Maven Daemon #Maven #SnailToRocket Benjamin Marwell
(@bmarwell) & Maarten Mulders (@mthmulders) -
PARALLELIZING YOUR BUILD PARALLELIZING YOUR BUILD PARALLELIZING YOUR BUILD PARALLELIZING
YOUR BUILD PARALLELIZING YOUR BUILD ! MAVEN MODULES EVERYWHERE ! #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
CASE STUDY: HEXAGONAL ARCHITECTURE #Maven #SnailToRocket Benjamin Marwell (@bmarwell) &
Maarten Mulders (@mthmulders) -
INITIAL MAVEN MODULES #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten
Mulders (@mthmulders) -
REFACTORED MAVEN MODULES #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten
Mulders (@mthmulders) -
EVALUATION PROS Faster builds when there are enough modules with
few, distinct dependencies (Almost) no need for ArchUnit or alike Easier to exclude transient dependencies via Maven CONS Could hinder navigation between classes and modules Needs awareness of runtime vs compile dependencies May not be suitable for libraries #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
TO DO OR NOT TO DO? As always: it depends!
Pro ts vs. added complexity For libraries: impact for consumers? For applications: does it impact architecture? #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
DEMO This is what happens when you do not have
any long-running tests: SHIRO W/ 62 MODULES (2:01 MIN) SHIRO W/ 58 MODULES (1:59 MIN) #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
MAVEN BUILD CACHE EXTENSION MAVEN BUILD CACHE EXTENSION MAVEN BUILD
CACHE EXTENSION MAVEN BUILD CACHE EXTENSION MAVEN BUILD CACHE EXTENSION #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
HOW DOES THE BUILD CACHE WORK? Reduces build time by
skipping parts of the build which don't need to be executed. 1. Only execute parts of the build which changed. 2. Build subtrees of a multi-module project in isolation. 3. Normalize the version to avoid rebuilding across forks. 4. Project state restoration (e.g. artifacts) #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
1. WHICH PARTS HAVE CHANGED? A. MODIFICATIONS TO THE POM
Changing dependencies, modifying plugins or executions, will invalidate the cache. B. MODIFICATION OF SOURCE CODE Use content ngerprinting to invalidate cache when source code changes. #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
WHEN TO USE THE CACHE EXTENSION? 1. You use Maven
3.9 or Maven 4. 2. Your project does not rely on 'quirks'. 3. You want to speed up 1. local developer build, and/or 2. CI builds (PRs), and/or 3. want to share cache with co-workers. 4. You are willing to invest time to make the cache portable. #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
INSTALL THE EXTENSION 1. Create .mvn/extensions.xml in your project. 2.
Register the extension by adding the following content: 3. (Optional) extend the default cache con guration <extensions> <extension> <groupId>org.apache.maven.extensions groupId> <artifactId>maven build cache extension artifactId> <version>1.2.0 version> extension> extensions> #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
DEMO DEMO DEMO DEMO DEMO #Maven #SnailToRocket Benjamin Marwell (@bmarwell)
& Maarten Mulders (@mthmulders) -
โ CAVEATS 1. Con gure relevant input les 2. Add
plugin parameters for reconciliation 3. Filter non-essential les (IDE, etc) 4. Expect your tests not to run 5. Remote cache not used (OS, pro les...) 6. Cache eviction #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
HONOURABLE MENTIONS HONOURABLE MENTIONS HONOURABLE MENTIONS HONOURABLE MENTIONS HONOURABLE MENTIONS
We did not cover: Reduce logging (Logback, Log4J, mvn -q ) โ try it! Christian Stein's "junit5-looming" (showcase): JUnit 5 test engine with virtual thread support Virus and threat protection User home directory on network drive #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
WHAT DID WE LEARN? WHAT DID WE LEARN? WHAT DID
WE LEARN? WHAT DID WE LEARN? WHAT DID WE LEARN? 1. Measure your builds 2. Parallel test execution per module 3. Using the Maven Daemon 4. Feed mvnd with architecture improvements 5. Maven Build Cache Extension #Maven #SnailToRocket Benjamin Marwell (@bmarwell) & Maarten Mulders (@mthmulders) -
REFERENCES bit.ly/snail-pace-rocket-speed-demos blog.bmarwell.de maarten.mulders.it @bmarwell @mthmulders #Maven #SnailToRocket Benjamin Marwell
(@bmarwell) & Maarten Mulders (@mthmulders)