Skip to main content

Overview: Preparing for Spring Boot migration

Spring Boot migrations are rarely just a version bump. You need to understand your repositories, identify hidden dependencies, align build tooling, and plan release waves so downstream services can upgrade safely. This workshop walks you through a realistic, end-to-end prep flow using the Moderne Platform and CLI so you can move into a Spring Boot 4 migration with fewer surprises.

Throughout the workshop, you will see screenshot placeholders and collapsible Reference output sections. Use them as quick sanity checks to confirm you are on the right path. Do not worry if your output differs slightly (CLI versions, repository counts, and file paths can vary).

What you'll learn​

  • How to perform a dry run and understand what failed
  • How to find which Java and Spring Boot versions you're using
  • How to plan upgrade waves using dependency data
  • How to set a stable baseline before major upgrades
  • How to diagnose third-party blockers like QueryDSL with mod search
  • How to build custom recipes with AI assistance

Prerequisites​

To get the most out of this workshop, you should:

  • Have intermediate Java knowledge, including Maven dependency management
  • Be familiar with Spring Boot fundamentals
  • Be comfortable running CLI commands and managing git changes

You will also need:

  • A Moderne Platform account with access to the Moderne - Training organization (your workshop facilitator will provide access)
  • Moderne CLI (version 4.x recommended), authenticated against the Moderne Platform (mod config moderne edit)
  • A JDK installed locally (Java 17 or higher recommended)
  • Git installed locally
  • Python 3 and uv (optional, for the wave planning notebook in Module 2)

Workshop modules​