3장. 서비스 레지스트리 구성 참조

apicurio.api.errors.include-stack-in-response

boolean

false

2.1.4.Final

오류 응답에 스택 추적 포함

apicurio.apis.v3.base-href

string

_

2.5.0.Final

API 기본 href (URI)

apicurio.disable.apis

optional<list<string>>

2.0.0.Final

API 비활성화

apicurio.auth.admin-override.claim

string

org-admin

2.1.0.Final

인증 관리자 덮어쓰기 클레임

apicurio.auth.admin-override.claim-value

string

true

2.1.0.Final

인증 관리자 덮어쓰기 클레임 값

apicurio.auth.admin-override.enabled

boolean

false

2.1.0.Final

인증 관리자 덮어쓰기 활성화

apicurio.auth.admin-override.from

string

token

2.1.0.Final

의 인증 관리자 덮어쓰기

apicurio.auth.admin-override.role

string

sr-admin

2.1.0.Final

인증 관리자 덮어쓰기 역할

apicurio.auth.admin-override.type

string

role

2.1.0.Final

인증 관리자 덮어쓰기 유형

apicurio.auth.admin-override.user

string

admin

3.0.0

인증 관리자 덮어쓰기 사용자 이름

apicurio.auth.anonymous-read-access.enabled

boolean [dynamic]

false

2.1.0.Final

익명 읽기 액세스

apicurio.auth.authenticated-read-access.enabled

boolean [dynamic]

false

2.1.4.Final

인증된 읽기 액세스

apicurio.auth.owner-only-authorization

boolean [dynamic]

false

2.0.0.Final

아티팩트 소유자 전용 권한 부여

apicurio.auth.owner-only-authorization.limit-group-access

boolean [dynamic]

false

2.1.0.Final

아티팩트 그룹 소유자 전용 권한 부여

apicurio.auth.role-based-authorization

boolean

false

2.1.0.Final

역할 기반 권한 부여 활성화

apicurio.auth.role-source

string

token

2.1.0.Final

인증 역할 소스

apicurio.auth.role-source.header.name

string

2.4.3.Final

헤더 권한 부여 이름

apicurio.auth.roles.admin

string

sr-admin

2.0.0.Final

인증 역할 관리자

apicurio.auth.roles.developer

string

sr-developer

2.1.0.Final

인증 역할 개발자

apicurio.auth.roles.readonly

string

SR-readonly

2.1.0.Final

인증 역할 읽기 전용

apicurio.authn.audit.log.prefix

string

audit

2.2.6

애플리케이션 감사 로깅에 사용되는 접두사입니다.

apicurio.authn.basic-client-credentials.cache-expiration

integer

10

2.2.6.Final

기본 클라이언트 인증 정보 토큰 만료 시간(분)입니다.

apicurio.authn.basic-client-credentials.cache-expiration-offset

integer

10

2.5.9.Final

JWT 만료 시간(초)의 클라이언트 인증 정보 토큰 만료 오프셋입니다.

apicurio.authn.basic-client-credentials.enabled

boolean [dynamic]

false

2.1.0.Final

기본 인증 클라이언트 인증 정보 활성화

apicurio.authn.basic.scope

optional<string>

2.5.0.Final

클라이언트 인증 정보 범위.

quarkus.http.auth.basic

boolean

false

3.0.0

기본 인증 활성화

quarkus.oidc.client-id

string

2.0.0.Final

인증을 위해 서버에서 사용하는 클라이언트 식별자입니다.

quarkus.oidc.client-secret

optional<string>

2.1.0.Final

인증에 서버에서 사용하는 클라이언트 시크릿입니다.

quarkus.oidc.tenant-enabled

boolean

false

2.0.0.Final

인증 활성화

quarkus.oidc.token-path

string

2.1.0.Final

인증 서버 토큰 끝점.

apicurio.config.cache.enabled

boolean

true

2.2.2.Final

레지스트리 캐시 활성화

apicurio.ccompat.group-concat.enabled

boolean

false

2.6.2.Final

적용 대상(호환 API)에서 연결을 통해 그룹 지원 활성화

apicurio.ccompat.group-concat.separator

string

:

2.6.2.Final

그룹 연결을 활성화할 때 사용할 구분 기호(호환성 API)

apicurio.ccompat.legacy-id-mode.enabled

boolean [dynamic]

false

2.0.2.Final

레거시 ID 모드(호환성 API)

apicurio.ccompat.max-subjects

integer [dynamic]

1000

2.4.2.Final

반환되는 최대 주체 수(호환성 API)

apicurio.ccompat.use-canonical-hash

boolean [dynamic]

false

2.3.0.Final

표준 해시 모드 (호환성 API)

apicurio.download.href.ttl.seconds

롱 [dynamic]

30

2.1.2.Final

링크 만료 다운로드

apicurio.gitops.id

string

3.0.0

이 레지스트리 인스턴스의 식별자입니다. 이 식별자를 참조하는 데이터만 로드됩니다.

apicurio.gitops.repo.origin.branch

string

main

3.0.0

로드할 데이터가 포함된 원격 Git 리포지토리의 분기 이름입니다.

apicurio.gitops.repo.origin.uri

string

3.0.0

로드할 데이터가 포함된 원격 git 리포지토리의 URI입니다.

apicurio.gitops.workdir

string

/tmp/apicurio-registry-gitops

3.0.0

로컬 Git 리포지토리를 저장하는 데 사용되는 GitOps 작업 디렉터리의 경로입니다.

apicurio.liveness.errors.ignored

optional<list<string>>

1.2.3.Final

무시된 활성 오류

apicurio.metrics.persistence-exception-liveness-check.counter-reset-window-duration.seconds

integer

60

1.0.2.Final

지속성 활성 검사의 카운터 재설정 창 기간

apicurio.metrics.persistence-exception-liveness-check.error-threshold

integer

1

1.0.2.Final

지속성 활성 점검 오류 임계값

apicurio.metrics.persistence-exception-liveness-check.logging.disabled

boolean

false

2.0.0.Final

지속성 활성 점검 로깅 비활성화

apicurio.metrics.persistence-exception-liveness-check.status-reset-window-duration.seconds

integer

300

1.0.2.Final

지속성 활성 검사 상태 재설정 창 기간

apicurio.metrics.persistence-timeout-readiness-check.error-threshold

integer

5

1.0.2.Final

지속성 준비 상태 점검 오류 임계값

apicurio.metrics.persistence-timeout-readiness-check.timeout.seconds

integer

15

1.0.2.Final

지속성 준비 상태 점검 시간 제한

apicurio.metrics.persitence-timeout-readiness-check.status-reset-window-duration.seconds

integer

300

1.0.2.Final

지속성 준비 상태 점검의 상태 재설정 창 기간

apicurio.metrics.resonse-error-liveness-check.counter-reset-window-duration.seconds

integer

60

1.0.2.Final

응답 활성 검사의 카운터 재설정 창 기간

apicurio.metrics.response-error-liveness-check.counter-reset-window-duration.seconds

integer

60

1.0.2.Final

지속성 준비 상태 점검의 카운터 재설정 창 기간

apicurio.metrics.response-error-liveness-check.disabled

boolean

false

2.0.0.Final

응답 활성 점검의 로깅 비활성화

apicurio.metrics.response-error-liveness-check.error-threshold

integer

1

1.0.2.Final

응답 활성 검사의 오류 임계값

apicurio.metrics.response-error-liveness-check.status-reset-window-duration.seconds

integer

300

1.0.2.Final

응답 활성 검사의 상태 재설정 창 기간

apicurio.metrics.response-timeout-readiness-check.counter-reset-window-duration.seconds

instance<integer>

60

1.0.2.Final

응답 준비 상태 점검의 카운터 재설정 창 기간

apicurio.metrics.response-timeout-readiness-check.error-threshold

instance<integer>

1

1.0.2.Final

응답 준비 상태 점검의 오류 임계값

apicurio.metrics.response-timeout-readiness-check.timeout.seconds

instance<integer>

10

1.0.2.Final

응답 준비 상태 점검 시간 초과

apicurio.metrics.response-timeout-rediness-check.status-reset-window-duration.seconds

instance<integer>

300

1.0.2.Final

응답 준비 상태 점검의 상태 재설정 창 기간

apicurio.storage.metrics.cache.check-period.ms

long

30000

2.1.0.Final

스토리지 메트릭 캐시 검사 기간

apicurio.import.preserveContentId

boolean

true

3.0.0

true로 설정하면 가져오기 파일의 콘텐츠 ID가 사용됩니다(다른 새 ID가 생성됩니다). 기본값은 'true'입니다.

apicurio.import.preserveGlobalId

boolean

true

3.0.0

true로 설정하면 가져오기 파일의 글로벌 ID가 사용됩니다(다른 새 ID가 생성됩니다). 기본값은 'true'입니다.

apicurio.import.requireEmptyRegistry

boolean

true

3.0.0

true로 설정하면 레지스트리가 비어 있는 경우에만 데이터 가져오기가 작동합니다. 기본값은 'true'입니다.

apicurio.import.url

optional<url>

2.1.0.Final

가져오기 URL

apicurio.import.work-dir

string

3.0.0

데이터를 가져올 때 사용할 임시 작업 디렉터리입니다.

apicurio.limits.config.max-artifact-labels

long

-1

2.2.3.Final

최대 아티팩트 레이블

apicurio.limits.config.max-artifact-properties

long

-1

2.1.0.Final

최대 아티팩트 속성

apicurio.limits.config.max-artifacts

long

-1

2.1.0.Final

최대 아티팩트 수

apicurio.limits.config.max-description-length

long

-1

2.1.0.Final

최대 아티팩트 설명 길이

apicurio.limits.config.max-label-size.bytes

long

-1

2.1.0.Final

최대 아티팩트 레이블 크기

apicurio.limits.config.max-name-length

long

-1

2.1.0.Final

최대 아티팩트 이름 길이

apicurio.limits.config.max-property-key-size.bytes

long

-1

2.1.0.Final

최대 아티팩트 속성 키 크기

apicurio.limits.config.max-property-value-size.bytes

long

-1

2.1.0.Final

최대 아티팩트 속성 값 크기

apicurio.limits.config.max-requests-per-second

long

-1

2.2.3.Final

초당 최대 아티팩트 요청 수

apicurio.limits.config.max-schema-size.bytes

long

-1

2.2.3.Final

최대 스키마 크기(바이트)

apicurio.limits.config.max-total-schemas

long

-1

2.1.0.Final

최대 총 스키마 수

apicurio.limits.config.max-versions-per-artifact

long

-1

2.1.0.Final

아티팩트당 최대 버전

apicurio.storage.metrics.cache.max-size

long

1000

2.4.1.Final

스토리지 지표 캐시 최대 크기입니다.

apicurio.redirects

map<string, string>

2.1.2.Final

레지스트리 리디렉션

apicurio.redirects.enabled

boolean

2.1.2.Final

리디렉션 활성화

apicurio.url.override.host

optional<string>

2.5.0.Final

외부에서 액세스할 수 있는 URL을 생성하는 데 사용되는 호스트 이름을 재정의합니다. 호스트 및 포트 덮어쓰기는 HTTPS 패스스루 Ingress 또는 경로를 사용하여 레지스트리를 배포할 때 유용합니다. 이러한 경우 리디렉션에 다시 사용되는 요청 URL(및 포트)은 요청이 프록시되므로 클라이언트에서 사용하는 실제 외부 URL에 속하지 않습니다. 대상 URL에 연결할 수 없기 때문에 리디렉션이 실패합니다.

apicurio.url.override.port

optional<integer>

2.5.0.Final

외부 액세스 가능한 URL을 생성하는 데 사용되는 포트를 재정의합니다.

apicurio.rest.artifact.download.max-size.bytes

int

1000000

2.2.6

URL에서 다운로드할 수 있는 아티팩트의 최대 크기

apicurio.rest.artifact.download.ssl-validation.disabled

boolean

false

2.2.6

URL에서 아티팩트를 다운로드할 때 SSL 검증 건너뛰기

apicurio.rest.deletion.artifact-version.enabled

boolean [dynamic]

false

2.4.2

아티팩트 버전 삭제 활성화

apicurio.rest.deletion.artifact.enabled

boolean [dynamic]

false

3.0.0

아티팩트 삭제 활성화

apicurio.rest.deletion.group.enabled

boolean [dynamic]

false

3.0.0

그룹 삭제 활성화

apicurio.rest.mutability.artifact-version-content.enabled

boolean [dynamic]

false

3.0.2

아티팩트 버전 변경 기능 활성화

apicurio.rest.search-results.labels.max-size.bytes

int

512

3.0.3

검색 결과 내에서 항목당 라벨(바이트)의 최대 크기

apicurio.semver.branching.coerce

boolean [dynamic]

false

3.0.0

true인 경우 유효하지 않은 버전은 가능한 경우 Semantic Versioning 2 형식(https://semver.org)으로 강제 적용됩니다.

apicurio.semver.branching.enabled

boolean [dynamic]

false

3.0.0

주요('A.x') 및 마이너('A.B.x') 아티팩트 버전에 대한 분기를 자동으로 생성하거나 업데이트합니다.

apicurio.semver.validation.enabled

boolean [dynamic]

false

3.0.0

모든 아티팩트 버전이 Semantic Versioning 2 형식(https://semver.org)을 준수하는지 확인합니다.

apicurio.datasource.blue.db-kind

string

h2

3.0.0

GitOps BlueSource db 종류

apicurio.datasource.blue.jdbc.initial-size

string

20

3.0.0

GitOps Blue 데이터 소스 풀 초기 크기

apicurio.datasource.blue.jdbc.max-size

string

100

3.0.0

GitOps Blue 데이터 소스 풀 최대 크기

apicurio.datasource.blue.jdbc.min-size

string

20

3.0.0

GitOps Blue 데이터 소스 풀 최소 크기

apicurio.datasource.blue.jdbc.url

string

jdbc:h2:mem:registry_db

3.0.0

GitOps blue datasource jdbc url

apicurio.datasource.blue.password

string

sa

3.0.0

GitOps Blue 데이터 소스 암호

apicurio.datasource.blue.username

string

sa

3.0.0

GitOps Blue 데이터 소스 사용자 이름

apicurio.datasource.green.db-kind

string

h2

3.0.0

GitOps 녹색 데이터 소스 db 종류

apicurio.datasource.green.jdbc.initial-size

string

20

3.0.0

GitOps 녹색 데이터 소스 풀 초기 크기

apicurio.datasource.green.jdbc.max-size

string

100

3.0.0

GitOps 녹색 데이터 소스 풀 최대 크기

apicurio.datasource.green.jdbc.min-size

string

20

3.0.0

GitOps 녹색 데이터 소스 풀 최소 크기

apicurio.datasource.green.jdbc.url

string

jdbc:h2:mem:registry_db

3.0.0

GitOps 녹색 데이터 소스 jdbc url

apicurio.datasource.green.password

string

sa

3.0.0

GitOps 녹색 데이터 소스 암호

apicurio.datasource.green.username

string

sa

3.0.0

GitOps 녹색 데이터 소스 사용자 이름

apicurio.events.kafka.topic

string

registry-events

스토리지 이벤트 주제

apicurio.kafkasql.bootstrap.servers

string

Kafka sql 스토리지 부트스트랩 서버

apicurio.kafkasql.consumer.group-prefix

string

apicurio-

소비자 그룹 이름에 대한 Kafka sql 스토리지 접두사

apicurio.kafkasql.consumer.poll.timeout

integer

5000

Kafka sql 스토리지 소비자 폴링 시간 초과

apicurio.kafkasql.coordinator.response-timeout

integer

30000

Kafka sql 스토리지 조정기 응답 시간 초과

apicurio.kafkasql.security.protocol

optional<string>

Kafka sql 스토리지 보안 프로토콜

apicurio.kafkasql.security.sasl.client-id

string

Kafka sql 스토리지 sasl 클라이언트 식별자

apicurio.kafkasql.security.sasl.client-secret

string

Kafka sql 스토리지 sasl 클라이언트 시크릿

apicurio.kafkasql.security.sasl.enabled

boolean

false

Kafka sql 스토리지 sasl 사용

apicurio.kafkasql.security.sasl.login.callback.handler.class

string

Kafka sql 스토리지 sasl 로그인 콜백 처리기

apicurio.kafkasql.security.sasl.mechanism

string

Kafka sql 스토리지 sasl 메커니즘

apicurio.kafkasql.security.sasl.token.endpoint

string

Kafka sql 스토리지 sasl 토큰 끝점

apicurio.kafkasql.security.ssl.truststore.location

optional<string>

Kafka sql 스토리지 ssl 신뢰 저장소 위치

apicurio.kafkasql.security.ssl.truststore.type

optional<string>

Kafka sql 스토리지 ssl truststore 유형

apicurio.kafkasql.snapshot.every.seconds

string

86400s

3.0.0

Kafka sql 저널 주제 스냅샷 모든

apicurio.kafkasql.snapshots.topic

string

kafkasql-snapshots

3.0.0

Kafka sql 스토리지 주제 이름

apicurio.kafkasql.ssl.key.password

optional<string>

Kafka sql 스토리지 ssl 키 암호

apicurio.kafkasql.ssl.keystore.location

optional<string>

Kafka sql 스토리지 ssl 키 저장소 위치

apicurio.kafkasql.ssl.keystore.password

optional<string>

Kafka sql 스토리지 ssl 키 저장소 암호

apicurio.kafkasql.ssl.keystore.type

optional<string>

Kafka sql 스토리지 ssl 키 저장소 유형

apicurio.kafkasql.ssl.truststore.password

optional<string>

Kafka sql 스토리지 ssl truststore 암호

apicurio.kafkasql.topic

string

kafkasql-journal

Kafka sql 스토리지 주제 이름

apicurio.kafkasql.topic.auto-create

boolean

true

Kafka sql 스토리지 주제 자동 생성

apicurio.sql.db-schema

string

*

3.0.6

데이터베이스 스키마 이름(여러 스키마에서 동일한 데이터베이스에 대해 레지스트리의 두 인스턴스를 실행할 때만 필요)

apicurio.sql.init

boolean

true

2.0.0.Final

SQL init

apicurio.storage.kind

string

3.0.0

애플리케이션 스토리지 변형(예: sql, kafkasql 또는 gitops)

apicurio.storage.read-only.enabled

boolean [dynamic]

false

2.5.0.Final

레지스트리 스토리지 읽기 전용 모드 활성화

apicurio.storage.snapshot.location

string

./

3.0.0

Kafka sql 스냅샷 저장소 위치

apicurio.storage.sql.kind

string

h2

3.0.0

애플리케이션 데이터 소스 데이터베이스 유형

artifacts.skip.disabled.latest

boolean

true

2.4.2

최신 아티팩트 버전을 검색할 때 DISABLED 상태로 아티팩트 버전 건너뛰기

apicurio.ui.auth.oidc.client-id

string

apicurio-registry-ui

3.0.0

OIDC clientId

apicurio.ui.auth.oidc.logout-url

string

f5

3.0.0

OIDC 로그 아웃 URL

apicurio.ui.auth.oidc.redirect-uri

string

/

3.0.0

OIDC redirectUri

apicurio.ui.auth.oidc.scope

string

OpenID 프로필 이메일

3.0.8

UI 인증 OIDC 범위 값

apicurio.ui.contextPath

string

/

3.0.0

UI의 컨텍스트 경로

apicurio.ui.docsUrl

string

/docs/

3.0.0

문서 구성 요소의 URL

apicurio.ui.features.breadcrumbs

string

true

3.0.0

UI에서 이동 경로를 표시하는 활성화

apicurio.ui.features.read-only.enabled

string

false

3.0.0

UI를 읽기 전용 모드로 설정하는 데 사용 가능

apicurio.ui.features.settings

string

true

3.0.0

UI의 설정 탭을 표시하도록 활성화

apicurio.ui.navPrefixPath

string

/

3.0.0

모든 UI 경로에 대한 탐색 접두사