Skip to content

Commit e8d6efa

Browse files
holly-cumminsholly-cummins
committed
Add page documenting how to migrate to Quarkus
1 parent e38b088 commit e8d6efa

11 files changed

Lines changed: 134 additions & 90 deletions

‎_includes/header-navigation_tertiary.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@
2424
<span href="#">SPRING<i class="fas fa-chevron-down"></i></span>
2525
<ul class="tertiarymenu">
2626
<li><a href="{{site.baseurl}}/spring" class="{% if page.url contains '/spring/' %}active{% endif %}">SPRING ON QUARKUS</a></li>
27-
<li><a href="{{site.baseurl}}/migrate-to-quarkus" class="{% if page.url contains '/migrate-to-quarkus/' %}active{% endif %}">MIGRATE TO QUARKUS</a></li>
27+
<li><a href="{{site.baseurl}}/spring/migrate" class="{% if page.url contains '/spring/migrate' %}active{% endif %}">MIGRATE TO QUARKUS</a></li>
2828
<li><a href="{{site.baseurl}}/java-and-ai" class="{% if page.url contains '/java-and-ai/' %}active{% endif %}">JAVA AND AI</a></li>
2929
</ul>
3030
</li>

‎_includes/spring-breadcrumb.html‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<section class="full-width-version-bg flexfilterbar">
2+
<div class="guideflexcontainer">
3+
<div class="docslink">
4+
<a class="returnlink" href="{{site.baseurl}}/spring"> Back to Using Spring?</a>
5+
</div>
6+
</div>
7+
</section>

‎_includes/spring-migrate-content.html‎

Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,106 @@
1+
<div class="component-wrapper two-column-content-band">
2+
3+
<div class="width-12-12">
4+
<p>There are two paths from Spring to Quarkus. You can use <strong>compatibility libraries</strong> to run your existing Spring code on Quarkus with minimal changes &mdash; same annotations, same patterns, faster runtime. Or you can <strong>migrate</strong> to native Quarkus APIs (Jakarta REST, CDI, Panache) to get the most out of Quarkus. Either way, you don't have to do it all at once: start with compatibility, then migrate incrementally as it suits you. Both paths are supported by tooling and AI to help automate the work.</p>
5+
</div>
6+
7+
<div class="width-12-12">
8+
<h2>Compatibility Libraries</h2>
9+
<h3>Spring APIs that work on Quarkus, out of the box</h3>
10+
<p>Quarkus provides compatibility extensions that let you reuse your Spring knowledge and code. Use familiar annotations like <code>@RestController</code>, <code>@Autowired</code>, and <code>JpaRepository</code> on a leaner, more productive runtime.</p>
11+
<p>To get started: swap in the <a href="{{site.baseurl}}/guides/maven-tooling">Quarkus Maven plugin</a> and BOM, add the compatibility extensions you need, and update your <strong>property names</strong> in <code>application.properties</code> to their Quarkus equivalents.</p>
12+
<div class="grid-wrapper">
13+
<div class="width-6-12 width-12-12-m">
14+
<ul>
15+
<li><a href="{{site.baseurl}}/guides/spring-web">Spring Web</a> &mdash; <code>@RestController</code>, <code>@RequestMapping</code>, <code>@GetMapping</code></li>
16+
<li><a href="{{site.baseurl}}/guides/spring-di">Spring DI</a> &mdash; <code>@Autowired</code>, <code>@Component</code>, <code>@Service</code></li>
17+
<li><a href="{{site.baseurl}}/guides/spring-data-jpa">Spring Data JPA</a> &mdash; <code>JpaRepository</code>, <code>CrudRepository</code>, derived queries</li>
18+
<li><a href="{{site.baseurl}}/guides/spring-data-rest">Spring Data REST</a> &mdash; automatic CRUD endpoints from repositories</li>
19+
<li><a href="{{site.baseurl}}/guides/spring-security">Spring Security</a> &mdash; <code>@Secured</code>, <code>@PreAuthorize</code></li>
20+
</ul>
21+
</div>
22+
<div class="width-6-12 width-12-12-m">
23+
<ul>
24+
<li><a href="{{site.baseurl}}/guides/spring-tx">Spring Transactions</a> &mdash; <code>@Transactional</code></li>
25+
<li><a href="{{site.baseurl}}/guides/spring-cache">Spring Cache</a> &mdash; <code>@Cacheable</code>, <code>@CacheEvict</code></li>
26+
<li><a href="{{site.baseurl}}/guides/spring-boot-properties">Spring Boot Properties</a> &mdash; <code>@ConfigurationProperties</code></li>
27+
<li><a href="{{site.baseurl}}/guides/spring-scheduled">Spring Scheduled</a> &mdash; <code>@Scheduled</code> for periodic tasks</li>
28+
<li><a href="{{site.baseurl}}/guides/spring-cloud-config-client">Spring Cloud Config</a> &mdash; read config from a Spring Cloud Config Server</li>
29+
</ul>
30+
</div>
31+
</div>
32+
<p>These extensions cover the most widely used Spring APIs, but not all of them. If your application uses Spring features that aren't listed here, you'll need to migrate those parts to their Quarkus equivalents &mdash; the tooling and AI resources below can help with that.</p>
33+
<p class="textCTA"><i class="fa fa-chevron-right"></i><a href="{{site.baseurl}}/guides/#q=spring">Browse all Spring guides</a></p>
34+
</div>
35+
36+
<div class="width-12-12">
37+
<h2>Migrate</h2>
38+
<h3>From analysis to automation</h3>
39+
40+
<h3>Tooling</h3>
41+
<div class="grid-wrapper">
42+
<div class="width-6-12 width-12-12-m">
43+
<div class="imagetext-container">
44+
<div class="imagetext-text">
45+
<h5>Migration Toolkit for Applications (MTA)</h5>
46+
<p>Red Hat's rule-based analysis tool, built on the <a href="https://www.konveyor.io/">Konveyor</a> open source project. MTA analyses your Spring Boot application and produces detailed reports highlighting what needs to change, with guidance on how to fix each issue. Available as a web console, CLI, Maven plugin, or IDE plugin.</p>
47+
<p class="textCTA"><i class="fa fa-chevron-right"></i><a href="{{site.baseurl}}/blog/migrating-existing-apps-to-quarkus-with-mta/">Read the MTA migration story</a></p>
48+
</div>
49+
</div>
50+
</div>
51+
<div class="width-6-12 width-12-12-m">
52+
<div class="imagetext-container">
53+
<div class="imagetext-text">
54+
<h5>OpenRewrite</h5>
55+
<p>The <code>SpringBootToQuarkus</code> composite recipe automates dependency swaps, annotation changes, and configuration migration. Run it via Maven, Gradle, or the CLI with no build changes needed.</p>
56+
<p class="textCTA"><i class="fa fa-chevron-right"></i><a href="https://docs.openrewrite.org/recipes/quarkus/spring/springboottoquarkus">OpenRewrite Spring-to-Quarkus recipes</a></p>
57+
</div>
58+
</div>
59+
</div>
60+
</div>
61+
<div class="grid-wrapper">
62+
<div class="width-6-12 width-12-12-m">
63+
<div class="imagetext-container">
64+
<div class="imagetext-text">
65+
<h5>Snowdrop Migration Guide</h5>
66+
<p>A structured guide with rules and decision flowcharts for migrating Spring Boot 3.x to Quarkus 3.x. Supports two paths: full Quarkus (Jakarta REST/CDI) or Spring compatibility (quarkus-spring-* extensions). Includes Konveyor analysis rules.</p>
67+
<p class="textCTA"><i class="fa fa-chevron-right"></i><a href="https://github.com/snowdrop/springboot-to-quarkus-migration-guide">Snowdrop migration guide on GitHub</a></p>
68+
</div>
69+
</div>
70+
</div>
71+
</div>
72+
73+
<h3>AI</h3>
74+
<div class="grid-wrapper">
75+
<div class="width-6-12 width-12-12-m">
76+
<div class="imagetext-container">
77+
<div class="imagetext-text">
78+
<h5>AI-Assisted Migration</h5>
79+
<p>Modern AI coding assistants understand both Spring and Quarkus patterns well. They can help translate controllers, services, repositories, configuration files, build files, and tests &mdash; giving you a head start on each file you need to migrate. For a <a href="https://www.the-main-thread.com/p/spring-to-quarkus-migration-guide">hands-on walkthrough</a> of what a full migration looks like step by step, see Markus Eisele's guide on The Main Thread.</p>
80+
</div>
81+
</div>
82+
</div>
83+
<div class="width-6-12 width-12-12-m">
84+
<div class="imagetext-container">
85+
<div class="imagetext-text">
86+
<h5>Konveyor AI (Kai)</h5>
87+
<p>Combines generative AI with static code analysis to assist migration directly in your IDE. Uses a RAG-based approach with historical migration data to provide context-specific guidance, without requiring model fine-tuning.</p>
88+
<p class="textCTA"><i class="fa fa-chevron-right"></i><a href="https://konveyor.github.io/components/kai/">Learn about Konveyor AI</a></p>
89+
</div>
90+
</div>
91+
</div>
92+
</div>
93+
<div class="grid-wrapper">
94+
<div class="width-6-12 width-12-12-m">
95+
<div class="imagetext-container">
96+
<div class="imagetext-text">
97+
<h5>Quarkus Spring Migration Skill</h5>
98+
<p>A Claude Code skill that guides an AI agent through a full Spring Boot to Quarkus migration &mdash; from reading the codebase to committing the result and opening a draft PR. It inspects your project and decides which modules apply, adapting to your chosen strategy: Spring Compatibility or Native Quarkus.</p>
99+
<p class="textCTA"><i class="fa fa-chevron-right"></i><a href="https://github.com/quarkusio/quarkus-skills">Quarkus Skills on GitHub</a></p>
100+
</div>
101+
</div>
102+
</div>
103+
</div>
104+
</div>
105+
106+
</div>

‎_includes/spring-migrate-main.html‎

Lines changed: 0 additions & 54 deletions
This file was deleted.

‎_includes/spring-roles-band.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ <h4>Boost your Java productivity</h4>
6565
</div>
6666
<div class="imagetext-text"><H5>Using Spring now? you don’t have to start over.</h5>
6767
<p>Quarkus speaks fluent Spring. Reuse your @RestController, @Autowired, and JpaRepository code with Spring compatibility extensions. You get the same familiar APIs, now backed by a faster, more modern runtime.</p>
68-
<p><a href="{{site.baseurl}}/guides/#q=spring">Start your journey with these excellent Spring guides</a></p>
68+
<p><a href="{{site.baseurl}}/spring/migrate">Ready to migrate? See our migration guide</a></p>
6969
</div>
7070
</div>
7171
<div class="imagetext-container">

‎_layouts/contentwithbreadcrumb.html‎

Lines changed: 0 additions & 19 deletions
This file was deleted.

‎_layouts/migratetoquarkus.html‎

Lines changed: 0 additions & 8 deletions
This file was deleted.

‎_layouts/spring-migrate.html‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
layout: base
3+
---
4+
5+
{% include spring-breadcrumb.html %}
6+
{% include springtitle-band.html %}
7+
8+
{% include spring-migrate-content.html %}

‎_redirects/migrate-to-quarkus.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
permalink: /migrate-to-quarkus/
3+
newUrl: /spring/migrate
4+
---

‎migrate-to-quarkus.md‎

Lines changed: 0 additions & 7 deletions
This file was deleted.

0 commit comments

Comments
 (0)