8.2. Service Registry serializer/deserializer 구성 속성

SCHEMA_RESOLVER

apicurio.registry.schema-resolver

serializer 및 deserializers에서 사용합니다. SchemaResolver 를 구현하는 정규화된 Java 클래스 이름입니다.

문자열

io.apicurio.registry.resolver.DefaultSchemaResolver

REGISTRY_URL

apicurio.registry.url

serializer 및 deserializers에서 사용합니다. 레지스트리 API에 액세스할 URL입니다.

문자열

없음

AUTH_SERVICE_URL

apicurio.auth.service.url

serializer 및 deserializers에서 사용합니다. 인증 서비스의 URL입니다. OAuth 클라이언트 인증 정보 흐름을 사용하여 보안 레지스트리에 액세스하는 경우 필요합니다.

문자열

없음

AUTH_TOKEN_ENDPOINT

apicurio.auth.service.token.endpoint

serializer 및 deserializers에서 사용합니다. 토큰 끝점의 URL입니다. 보안 레지스트리에 액세스하는 경우 필수 항목이며 AUTH_SERVICE_URL 은 지정되지 않습니다.

문자열

없음

AUTH_REALM

apicurio.auth.realm

serializer 및 deserializers에서 사용합니다. 인증 서비스에 액세스할 영역입니다. OAuth 클라이언트 인증 정보 흐름을 사용하여 보안 레지스트리에 액세스하는 경우 필요합니다.

문자열

없음

AUTH_CLIENT_ID

apicurio.auth.client.id

serializer 및 deserializers에서 사용합니다. 인증 서비스에 액세스하기 위한 클라이언트 ID입니다. OAuth 클라이언트 인증 정보 흐름을 사용하여 보안 레지스트리에 액세스하는 경우 필요합니다.

문자열

없음

AUTH_CLIENT_SECRET

apicurio.auth.client.secret

serializer 및 deserializers에서 사용합니다. 인증 서비스에 액세스하기 위한 클라이언트 시크릿입니다. OAuth 클라이언트 인증 정보 흐름을 사용하여 보안 레지스트리에 액세스하는 경우 필요합니다.

문자열

없음

AUTH_USERNAME

apicurio.auth.username

serializer 및 deserializers에서 사용합니다. 사용자 이름을 사용하여 레지스트리에 액세스합니다. HTTP 기본 인증을 사용하여 보안 레지스트리에 액세스하는 경우 필수 항목입니다.

문자열

없음

AUTH_PASSWORD

apicurio.auth.password

serializer 및 deserializers에서 사용합니다. 레지스트리에 액세스하기 위한 암호입니다. HTTP 기본 인증을 사용하여 보안 레지스트리에 액세스하는 경우 필수 항목입니다.

문자열

없음

ARTIFACT_RESOLVER_STRATEGY

apicurio.registry.artifact-resolver-strategy

serialize자만 사용합니다. ArtifactReferenceResolverStrategy 를 구현하고 각 Kafka 메시지를 ArtifactReference (groupId,artifactId 및 버전)에 매핑하는 정규화된 Java 클래스 이름입니다. 예를 들어 기본 전략에서는 주제 이름을 schema artifactId 로 사용합니다.

문자열

io.apicurio.registry.serde.strategy.TopicIdStrategy

EXPLICIT_ARTIFACT_GROUP_ID

apicurio.registry.artifact.group-id

serialize자만 사용합니다. 아티팩트를 쿼리하거나 생성하는 데 사용되는 groupId 를 설정합니다. ArtifactResolverStrategy 에서 반환된 groupId 를 덮어씁니다.

문자열

없음

EXPLICIT_ARTIFACT_ID

apicurio.registry.artifact.artifact-id

serialize자만 사용합니다. 아티팩트를 쿼리하거나 생성하는 데 사용되는 artifactId 를 설정합니다. ArtifactResolverStrategy 에서 반환된 artifactId 를 덮어씁니다.

문자열

없음

EXPLICIT_ARTIFACT_VERSION

apicurio.registry.artifact.version

serialize자만 사용합니다. 아티팩트를 쿼리하거나 생성하는 데 사용되는 아티팩트 버전을 설정합니다. ArtifactResolverStrategy 에서 반환한 버전을 재정의합니다.

문자열

없음

FIND_LATEST_ARTIFACT

apicurio.registry.find-latest

serialize자만 사용합니다. serializer가 해당 그룹 ID 및 아티팩트 ID의 레지스트리에서 최신 아티팩트를 찾는지 여부를 지정합니다.

boolean

false

AUTO_REGISTER_ARTIFACT

apicurio.registry.auto-register

serialize자만 사용합니다. serializer가 레지스트리에 아티팩트를 만들 것인지 여부를 지정합니다. JSON Schema serializer는 이 기능을 지원하지 않습니다.

부울, 부울 문자열

false

AUTO_REGISTER_ARTIFACT_IF_EXISTS

apicurio.registry.auto-register.if-exists

serialize자만 사용합니다. 아티팩트가 이미 있으므로 아티팩트를 생성하는 충돌이 있을 때 클라이언트의 동작을 구성합니다. 사용 가능한 값은 FAIL,UPDATE, RETURN _OR_UPDATE 입니다.

문자열

RETURN_OR_UPDATE

CHECK_PERIOD_MS

apicurio.registry.check-period-ms

serializer 및 deserializers에서 사용합니다. 자동eviction(밀리초) 전에 아티팩트를 캐시하는 기간을 지정합니다. 0으로 설정하면 매번 아티팩트가 가져옵니다.

java.time.Duration, 음수가 아닌 숫자 또는 정수 문자열

30000

RETRY_BACKOFF_MS

apicurio.registry.retry-backoff-ms

serializer 및 deserializers에서 사용합니다. 레지스트리에서 스키마를 검색할 수 없는 경우 여러 번 재시도할 수 있습니다. 이 구성 옵션은 재시도 시도(밀리초) 간 지연을 제어합니다.

java.time.Duration, 음수가 아닌 숫자 또는 정수 문자열

300

RETRY_COUNT

apicurio.registry.retry-count

serializer 및 deserializers에서 사용합니다. 레지스트리에서 스키마를 검색할 수 없는 경우 여러 번 재시도할 수 있습니다. 이 구성 옵션은 재시도 시도 횟수를 제어합니다.

음수가 아닌 숫자 또는 정수 문자열

3

USE_ID

apicurio.registry.use-id

serializer 및 deserializers에서 사용합니다. 지정된 IdOption 을 아티팩트 식별자로 사용하도록 구성합니다. 옵션은 globalId 및 contentId 입니다. 직렬화기에서 Kafka에 지정된 ID를 쓰고 deserialize자에게 이 ID를 사용하여 스키마를 찾도록 지시합니다.

문자열

globalId

ENABLE_HEADERS

apicurio.registry.headers.enabled

serializer 및 deserializers에서 사용합니다. 는 메시지 페이로드 대신 Kafka 메시지 헤더에 아티팩트 식별자를 읽고 쓰도록 구성합니다.

boolean

true

HEADERS_HANDLER

apicurio.registry.headers.handler

serializer 및 deserializers에서 사용합니다. HeadersHandler 를 구현하고 Kafka 메시지 헤더에서 아티팩트 식별자를 쓰기/읽는 완전한 Java 클래스 이름입니다.

문자열

io.apicurio.registry.serde.headers.DefaultHeadersHandler

ID_HANDLER

apicurio.registry.id-handler

serializer 및 deserializers에서 사용합니다. IdHandler 를 구현하고 메시지 페이로드에서 아티팩트 식별자를 쓰기/읽는 클래스의 정규화된 Java 클래스 이름입니다. apicurio.registry.headers.enabled 가 false 로 설정된 경우에만 사용됩니다.

문자열

io.apicurio.registry.serde.DefaultIdHandler

ENABLE_CONFLUENT_ID_HANDLER

apicurio.registry.as-confluent

serializer 및 deserializers에서 사용합니다. IdHandler 의 레거시 Confluent와 호환되는 구현을 가능하게 하는 바로 가기입니다. apicurio.registry.headers.enabled 가 false 로 설정된 경우에만 사용됩니다.

boolean

true

FALLBACK_ARTIFACT_PROVIDER

apicurio.registry.fallback.provider

역직자만 사용합니다. deserialization에 사용된 아티팩트를 해결하기 위해 FallbackArtifactProvider 의 사용자 지정 구현을 설정합니다. FallbackArtifactProvider 는 조회가 실패하는 경우 레지스트리에서 가져올 대체 아티팩트를 구성합니다.

문자열

io.apicurio.registry.serde.fallback.DefaultFallbackArtifactProvider

FALLBACK_ARTIFACT_ID

apicurio.registry.fallback.artifact-id

deserialize자만 사용합니다. deserialization에 사용되는 아티팩트를 확인하기 위한 폴백으로 사용되는 artifactId 를 설정합니다.

문자열

없음

FALLBACK_ARTIFACT_GROUP_ID

apicurio.registry.fallback.group-id

deserialize자만 사용합니다. 역직렬화에 사용되는 그룹을 확인하기 위해 폴백으로 사용되는 groupId 를 설정합니다.

문자열

없음

FALLBACK_ARTIFACT_VERSION

apicurio.registry.fallback.version

deserialize자만 사용합니다. deserialization에 사용되는 아티팩트를 해결하기 위한 폴백으로 사용되는 버전을 설정합니다.

문자열

없음