The English version of quarkus.io is the official project site. Translated sites are community supported on a best-effort basis.
Edit this Page

How dev mode differs from a production application

This document explains how the dev mode in Quarkus differs from a production application.

Introducción

Quarkus provides a dev mode (explained in more detail here and here) which greatly aids during development but should NEVER be used in production.

Diferencias arquitectónicas

Feature sets aside, the Quarkus application that is run under dev mode differs architecturally from the production application (i.e. the one that is run using java -jar …​).

In dev mode, Quarkus uses a ClassLoader hierarchy (explained in detail here) that enables the live reload of user code without requiring a rebuild and restart of the application.

En una aplicación de producción, la mencionada infraestructura de carga de clases está totalmente ausente - hay un único ClassLoader construido a propósito que carga (casi) todas las clases y dependencias.

Características del modo de desarrollo

In keeping with the mantra of providing developer joy, Quarkus provides a host of features when dev mode is enabled. The most important features are:

Recarga en vivo

This mightily important feature needs no introduction and has already been mentioned in the architectural differences section.

Interfaz de usuario

Quarkus provides a very useful UI accessible from the browser at /q/dev-ui. This UI allows a developer to see the state of the application, but also provides access to various actions that can change that state (depending on the extensions that are present). Examples of such operations are:

  • Modificación de los valores de configuración

  • Ejecución de scripts de migración de bases de datos

  • Borrado de cachés

  • Ejecución de operaciones programadas

  • Construir un contenedor

Páginas de error

In an effort to make development errors very easy to diagnose, Quarkus provides various detailed error pages when running in dev mode.

Scripts de importación de bases de datos

The quarkus-hibernate-orm extension will run the import.sql script in src/main/resources when Quarkus is running in dev mode. More details can be found here.

Servicios de desarrollo

When testing or running in dev mode Quarkus can even provide you with a zero config database out of the box, a feature we refer to as Dev Services. More information can be found here.

Interfaz de usuario de Swagger

The quarkus-smallrye-openapi extension will expose the Swagger UI when Quarkus is running in dev mode. Additional information can be found here.

GraphQL UI

The quarkus-smallrye-graphql extension will expose the GraphQL UI when Quarkus is running in dev mode. More details can be found here.

IU de la Salud

The quarkus-smallrye-health extension will expose the Health UI when Quarkus is running in dev mode. This section provides additional information.

Simulacro de envío de correo

The quarkus-mailer extension will enable an in-memory mock mail server when Quarkus is running in dev mode. See this for more details.

gRPC

  • El servicio gRPC Reflection está activado por defecto en el modo dev. Esto le permite utilizar herramientas como grpcurl. En el modo de producción, el servicio de reflexión está desactivado. Puedes habilitarlo explícitamente usando quarkus.grpc-server.enable-reflection-service=true.

  • In dev mode, quarkus.grpc.server.instances has no effect.

Otros

There might be other configuration properties (depending on the extensions added to the application) that have no effect in dev mode.

Implicaciones del rendimiento

In dev mode, minimizing the runtime footprint of the application is not the primary objective (although Quarkus still starts plenty fast and consumes little memory) - the primary objective is enabling developer joy. Therefore, many more classes are loaded and build time operations also take place every time a live-reload is performed.

In contrast, in a production application the main objective for Quarkus is to consume the least amount of memory and startup in the smallest amount of time. Thus, when running the production application, build time operations are not performed (by definition) and various infrastructure classes needed at build time are not present at all at runtime. Furthermore, the purpose built ClassLoader that comes with the fast-jar package type ensures that class lookup is done as fast as possible while also keeping the minimum amount of jars in memory.

Since optimal performance is never an objective of dev mode, in the interest of improving startup time, the JVM’s C2 compiler is disabled in dev mode.

Implicaciones de seguridad

Perhaps the most important reason why dev mode applications should not be run in production is that the dev mode allows reading information that could be confidential (via the Dev-UI) while also giving access to operations that could be destructive (either by exposing endpoints that should not be available in production application or via the Dev-UI).

Ejecución nativa

Cuando se crea un ejecutable nativo (explicado en detalle aquí), siempre se construye a partir de una aplicación de producción.

Related content