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/v6Activació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.enabledse ajusta afalse -
mp.messaging.connector.smallrye-kafka.apicurio.registry.urlestá configurado -
mp.messaging.connector.smallrye-kafka.apicurio.registry.urlestá configurado -
todos los canales de Kafka de Mensajería Reactiva tienen el atributo
apicurio.registry.urlestablecido
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
