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

Servicios de desarrollo para Apicurio Registry

Si una extensión para el registro de esquemas, como quarkus-apicurio-registry-avro o quarkus-confluent-registry-avro, está presente, los Servicios de Desarrollo para el Registro de Apicurio inician automáticamente una instancia de Registro de Apicurio en modo de desarrollo y cuando se ejecutan pruebas. Además, todos los canales Kafka en SmallRye Reactive Messaging se configuran automáticamente para utilizar este registro. Esta configuración automática sólo se aplica a los serializadores y deserializadores de las librerías serde Apicurio Registry y de las librerías serde Confluent Schema Registry, ya que sus propiedades están configuradas:

# for Apicurio Registry serde
mp.messaging.connector.smallrye-kafka.apicurio.registry.url=http://localhost:8081/apis/registry/v2
# for Confluent Schema Registry serde
mp.messaging.connector.smallrye-kafka.schema.registry.url=http://localhost:8081/apis/ccompat/v6

Activación/desactivación de los servicios de desarrollo para el registro de Apicurio

Los Servicios de Desarrollo para el Registro de Apicurio se activan automáticamente a menos que:

  • quarkus.apicurio-registry.devservices.enabled se ajusta a false

  • mp.messaging.connector.smallrye-kafka.apicurio.registry.url está configurado

  • mp.messaging.connector.smallrye-kafka.apicurio.registry.url está configurado

  • todos los canales de Kafka de Mensajería Reactiva tienen el atributo apicurio.registry.url establecido

Dev Services for Apicurio Registry se basa en Docker para iniciar el registro. Si su entorno no soporta Docker, tendrá que iniciar el registro manualmente, o utilizar un registro ya en funcionamiento. En tal caso, puede configurar la URL del registro para todos los canales Kafka en SmallRye Reactive Messaging con una sola propiedad. Para Apicurio Registry serde, esto es:

mp.messaging.connector.smallrye-kafka.apicurio.registry.url=... your Apicurio Registry URL...

Para Confluent Schema Registry serde, esto es:

mp.messaging.connector.smallrye-kafka.schema.registry.url=... su URL de Confluent Schema Registry...

Registro compartido

La mayoría de las veces se necesita compartir el registro entre aplicaciones. Dev Services for Apicurio Registry implementa un mecanismo de descubrimiento de servicios para que sus múltiples aplicaciones Quarkus que se ejecutan en modo dev compartan un único registro.

Dev Services for Apicurio Registry inicia el contenedor con la etiqueta quarkus-dev-service-apicurio-registry que se utiliza para identificar el contenedor.

Si necesitas varios registros (compartidos), puedes configurar el atributo quarkus.apicurio-registry.devservices.service-name e indicar el nombre del registro. Se busca un contenedor con el mismo valor, o se inicia uno nuevo si no se encuentra ninguno. El nombre de servicio por defecto es apicurio-registry.

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

Ajuste del puerto

Por defecto, Dev Services for Apicurio Registry escoge un puerto al azar y configura la aplicación. Puede establecer el puerto configurando la propiedad quarkus.apicurio-registry.devservices.port.

Tenga en cuenta que los canales Kafka en la mensajería reactiva de SmallRye se configuran automáticamente con el puerto elegido.

Configuración de la imagen

Los servicios de desarrollo para el Registro de Apicurio utilizan imágenes de apicurio/apicurio-registry-mem. Puede seleccionar cualquier versión 2.x de https://hub.docker.com/r/apicurio/apicurio-registry-mem:

quarkus.apicurio-registry.devservices.image-name=apicurio/apicurio-registry-mem:latest-snapshot

Related content