Servicios de desarrollo para Apicurio Registry
If an extension for schema registry, such as quarkus-apicurio-registry-avro or quarkus-confluent-registry-avro, is present, Dev Services for Apicurio Registry automatically starts an Apicurio Registry instance in dev mode and when running tests.
Also, all Kafka channels in SmallRye Reactive Messaging are automatically configured to use this registry.
This automatic configuration only applies to serializers and deserializers from Apicurio Registry serde libraries and Confluent Schema Registry serde libraries, because their properties are set:
# 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
Servicios de desarrollo para 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 ejecución. En tal caso, puede configurar la URL del registro para todos los canales Kafka en SmallRye Reactive Messaging con una única propiedad. Para Apicurio Registry serde, es decir:
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=... your Confluent Schema Registry URL...Registro compartido
Most of the time, you need to share the registry between applications. Dev Services for Apicurio Registry implements a service discovery mechanism for your multiple Quarkus applications running in dev mode to share a single registry.
Dev Services for Apicurio Registry starts the container with the quarkus-dev-service-apicurio-registry label, which is used to identify the container.
|
Si necesita varios registros (compartidos), puede configurar el atributo quarkus.apicurio-registry.devservices.service-name e indicar el nombre del registro. Busca un contenedor con el mismo valor o inicia uno nuevo si no encuentra ninguno. El nombre de servicio por defecto es apicurio-registry.
El uso compartido está activado por defecto en modo desarrollo, pero desactivado en el modo de prueba. Puede desactivar el uso compartido con quarkus.apicurio-registry.devservices.shared=false.
Ajuste del puerto
Por defecto, los servicios de desarrollo para Apicurio Registry elige un puerto aleatorio 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
Dev Services para Apicurio Registry utiliza 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=quay.io/apicurio/apicurio-registry-mem:2.6.13.FinalCompose
The Apicurio Dev Services supports Compose Dev Services.
It relies on a compose-devservices.yml, such as:
name: <application name>
services:
apicurio:
image: quay.io/apicurio/apicurio-registry-mem:2.6.13.Final
ports:
- "8080"
