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

Servicios de desarrollo para AMQP

Los servicios de desarrollo para AMQP inician automáticamente un broker AMQP 1.0 en modo desarrollo y al ejecutar pruebas. Por lo tanto, no tiene que iniciar un broker manualmente. La aplicación se configura automáticamente.

Activación/desactivación de los servicios de desarrollo para AMQP

Los servicios de desarrollo para AMQP se activan automáticamente a menos que:

  • quarkus.amqp.devservices.enabled se ajusta a false

  • el amqp-host o amqp-port está configurado

  • todos los canales AMQP de Mensajería Reactiva tienen establecidos los atributos host o port

Los servicios de desarrollo para AMQP se basan en Docker para iniciar el broker. Si su entorno no soporta Docker, tendrá que iniciar el broker manualmente, o conectarse a un broker ya en ejecución. Puede configurar el acceso al broker utilizando las propiedades amqp-host , amqp-port , amqp-user y amqp-password.

Broker compartido

La mayoría de las veces necesitará compartir el broker entre aplicaciones. Los servicios de desarrollo para AMQP implementa un mecanismo de descubrimiento de servicios para que sus múltiples aplicaciones Quarkus ejecutadas en modo dev compartan un único broker.

Los servicios de desarrollo para AMQP inicia el contenedor con la etiqueta quarkus-dev-service-amqp que se utiliza para identificar el contenedor.

Si necesita varios corredores (compartidos), puede configurar el atributo quarkus.amqp.devservices.service-name e indicar el nombre del corredor. Éste buscará un contenedor con el mismo valor o iniciará uno nuevo si no encuentra ninguno. El nombre de servicio por defecto es amqp.

El uso compartido está activado por defecto en el modo desarrollo, pero desactivado en el modo de prueba. Puede desactivar el uso compartido con quarkus.amqp.devservices.shared=false.

Configuración del puerto

Por defecto, Dev Services para AMQP elige un puerto aleatorio y configura la aplicación. Puede establecer el puerto configurando la propiedad quarkus.amqp.devservices.port.

Configuración de la imagen

Los servicios de desarrollo para AMQP utiliza las imágenes activemq-artemis-broker. Puede configurar la imagen y la versión utilizando la propiedad quarkus.amqp.devservices.image-name:

quarkus.amqp.devservices.image-name=quay.io/artemiscloud/activemq-artemis-broker:latest
La imagen configurada debe ser compatible con la de activemq-artemis-broker. El contenedor se lanza con las variables de entorno AMQ_USER , AMQ_PASSWORD y AMQ_EXTRA_ARGS. Los puertos 5672 y 8161 (consola web) están expuestos.

Referencia de configuración

Configuration property fixed at build time - All other configuration properties are overridable at runtime

Configuration property

Tipo

Por defecto

If Dev Services for AMQP has been explicitly enabled or disabled. Dev Services are generally enabled by default, unless there is an existing configuration present. For AMQP, Dev Services starts a broker unless amqp-host or amqp-port are set or if all the Reactive Messaging AMQP channel are configured with host or port.

Environment variable: QUARKUS_AMQP_DEVSERVICES_ENABLED

Show more

boolean

Optional fixed port the dev service will listen to.

If not defined, the port will be chosen randomly.

Environment variable: QUARKUS_AMQP_DEVSERVICES_PORT

Show more

int

The image to use. Note that only ActiveMQ Artemis images are supported. Specifically, the image repository must end with artemiscloud/activemq-artemis-broker.

Check the activemq-artemis-broker on Quay page to find the available versions.

Environment variable: QUARKUS_AMQP_DEVSERVICES_IMAGE_NAME

Show more

string

quay.io/artemiscloud/activemq-artemis-broker:1.0.25

The value of the AMQ_EXTRA_ARGS environment variable to pass to the container. For ActiveMQ Artemis Broker ⇐ 1.0.21, set this property to --no-autotune --mapped --no-fsync --relax-jolokia --http-host 0.0.0.0

Environment variable: QUARKUS_AMQP_DEVSERVICES_EXTRA_ARGS

Show more

string

--no-autotune --mapped --no-fsync --relax-jolokia

Indicates if the AMQP broker managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for AMQP starts a new container.

The discovery uses the quarkus-dev-service-amqp label. The value is configured using the service-name property.

Container sharing is only used in dev mode.

Environment variable: QUARKUS_AMQP_DEVSERVICES_SHARED

Show more

boolean

true

The value of the quarkus-dev-service-aqmp label attached to the started container. This property is used when shared is set to true. In this case, before starting a container, Dev Services for AMQP looks for a container with the quarkus-dev-service-amqp label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise, it starts a new container with the quarkus-dev-service-amqp label set to the specified value.

This property is used when you need multiple shared AMQP brokers.

Environment variable: QUARKUS_AMQP_DEVSERVICES_SERVICE_NAME

Show more

string

amqp

Environment variables that are passed to the container.

Environment variable: QUARKUS_AMQP_DEVSERVICES_CONTAINER_ENV__ENVIRONMENT_VARIABLE_NAME_

Show more

Map<String,String>

Related content