Skip to content

Update dev services guide to use the new builder API#53545

Draft
holly-cummins wants to merge 1 commit intoquarkusio:mainfrom
holly-cummins:update-dev-services-guide-new-api
Draft

Update dev services guide to use the new builder API#53545
holly-cummins wants to merge 1 commit intoquarkusio:mainfrom
holly-cummins:update-dev-services-guide-new-api

Conversation

@holly-cummins
Copy link
Copy Markdown
Contributor

@holly-cummins holly-cummins commented Apr 10, 2026

Summary

  • Replace the deprecated RunningDevService pattern with the DevServicesResultBuildItem.owned() builder API introduced in Quarkus 3.25
  • Add Startable interface implementation example using GenericContainer
  • Document the owned() builder methods (feature(), serviceConfig(), startable(), configProvider(), postStartHook())
  • Add section on discovered() builder for externally-managed services
  • Update re-use guidance: centralized lifecycle via serviceConfig() instead of static fields
  • Add quarkus-devservices runtime dependency requirement

Based on https://quarkus.io/blog/new-dev-services-api/

🤖 Generated with Claude Code

Replace the deprecated RunningDevService pattern with the new
DevServicesResultBuildItem.owned() builder API introduced in Quarkus 3.25.
The guide now shows:
- The Startable interface and GenericContainer implementation pattern
- The owned() builder with configProvider() for runtime config
- The discovered() builder for externally-managed services
- Centralized re-use based on serviceConfig() instead of static fields
- The quarkus-devservices runtime dependency requirement

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@holly-cummins
Copy link
Copy Markdown
Contributor Author

Marking this as draft because I want to edit by hand

@github-actions
Copy link
Copy Markdown

🎊 PR Preview 329f4ff has been successfully built and deployed to https://quarkus-pr-main-53545-preview.surge.sh/version/main/guides/

  • Images of blog posts older than 3 months are not available.
  • Newsletters older than 3 months are not available.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant