OpenShift에 Apicurio 레지스트리 설치 및 배포


Red Hat build of Apicurio Registry 3.0

Apicurio Registry 3.0 설치, 배포 및 구성

Red Hat Integration Documentation Team

초록

이 가이드에서는 AMQ Streams 또는 PostgreSQL 데이터베이스의 데이터 스토리지 옵션을 사용하여 OpenShift에 Apicurio Registry를 설치하고 배포하는 방법을 설명합니다. 이 가이드에서는 Apicurio 레지스트리 배포를 보안, 구성 및 관리하고 Apicurio Registry 및 Apicurio Registry Operator에 대한 구성 참조를 제공합니다.

머리말

Red Hat 문서에 대한 피드백 제공

문서 개선을 위한 의견에 감사드립니다.

개선 사항을 제안하려면 Jira 문제를 열고 제안된 변경 사항을 설명합니다. 귀하의 요청을 신속하게 처리할 수 있도록 가능한 한 자세한 정보를 제공하십시오.

사전 요구 사항

  • Red Hat 고객 포털 계정이 있어야 합니다. 이 계정을 사용하면 Red Hat Jira Software 인스턴스에 로그인할 수 있습니다.
    계정이 없는 경우 계정을 생성하라는 메시지가 표시됩니다.

프로세스

  1. 다음 링크를 클릭합니다. 문제 생성.
  2. 요약 텍스트 상자에 문제에 대한 간략한 설명을 입력합니다.
  3. 설명 텍스트 상자에 다음 정보를 입력합니다.

    • 문제를 발견한 페이지의 URL입니다.
    • 문제에 대한 자세한 설명입니다.
      다른 필드에 있는 정보는 기본값에 따라 그대로 둘 수 있습니다.
  4. 생성 을 클릭하여 Jira 문제를 문서 팀에 제출합니다.

피드백을 제공하기 위해 시간을 내어 주셔서 감사합니다.

1장. Service Registry Operator 빠른 시작

CRD(Custom Resource Definitions)를 사용하여 명령줄에서 Service Registry Operator를 빠르게 설치할 수 있습니다.

빠른 시작 예제에서는 SQL 데이터베이스에 스토리지가 있는 서비스 레지스트리 인스턴스를 배포합니다.

참고

프로덕션 환경에 권장되는 설치 옵션은 OpenShift OperatorHub입니다. 권장 스토리지 옵션은 성능, 안정성 및 데이터 관리를 위한 SQL 데이터베이스입니다.

1.1. 빠른 시작 서비스 레지스트리 Operator 설치

다운로드한 설치 파일 세트 및 예제 CRD를 사용하여 Operator Lifecycle Manager 없이 명령줄에서 Service Registry Operator를 빠르게 설치하고 배포할 수 있습니다.

사전 요구 사항

  • 관리자 액세스 권한을 사용하여 OpenShift 클러스터에 로그인되어 있습니다.
  • OpenShift oc 명령줄 클라이언트가 설치되어 있어야 합니다. 자세한 내용은 OpenShift CLI 설명서를 참조하십시오.

프로세스

  1. Red Hat 소프트웨어 다운로드 로 이동하여 제품 버전을 선택하고 서비스 레지스트리 CRD .zip 파일에서 예제를 다운로드합니다.
  2. 다운로드한 CRD .zip 파일을 추출하고 apicurio-registry-install-examples 디렉터리로 변경합니다.
  3. Service Registry Operator 설치에 대한 OpenShift 프로젝트를 생성합니다. 예를 들면 다음과 같습니다.

    export NAMESPACE="apicurio-registry"
    oc new-project "$NAMESPACE"
    Copy to Clipboard Toggle word wrap
  4. 다음 명령을 입력하여 install/install.yaml 파일에 예제 CRD를 적용합니다.

    cat install/install.yaml | sed "s/apicurio-registry-operator-namespace/$NAMESPACE/g" | oc apply -f -
    Copy to Clipboard Toggle word wrap
  5. oc get deployment 를 입력하여 Service Registry Operator의 준비 상태를 확인합니다. 예를 들어 출력은 다음과 같아야 합니다.

    NAME                     	READY   UP-TO-DATE  AVAILABLE   AGE
    apicurio-registry-operator  1/1 	1        	1       	XmYs
    Copy to Clipboard Toggle word wrap

1.2. 빠른 시작 서비스 레지스트리 인스턴스 배포

Service Registry 인스턴스 배포를 생성하려면 예제 CR을 사용합니다.

사전 요구 사항

  • Service Registry Operator가 설치되어 있는지 확인합니다.
  • OpenShift 클러스터에서 연결할 수 있는 PostgreSQL 데이터베이스가 있습니다.

프로세스

  1. Red Hat 소프트웨어 다운로드 로 이동하여 제품 버전을 선택하고 서비스 레지스트리 CRD .zip 파일에서 예제를 다운로드합니다.
  2. 배포 예제를 선택합니다.
  3. 다음 명령을 입력하여 Service Registry Operator를 사용하여 네임스페이스에 업데이트된 ApicurioRegistry3 CR을 적용하고 Service Registry 인스턴스가 배포될 때까지 기다립니다.

    oc project "$NAMESPACE"
    oc apply -f <example-yaml>
    Copy to Clipboard Toggle word wrap
  4. oc get deployment 를 입력하여 Service Registry 인스턴스의 준비 상태를 확인합니다. 예를 들어 출력은 다음과 같아야 합니다.

    NAME                     	        READY UP-TO-DATE AVAILABLE AGE
    example-apicurioregistry-sql-deployment 1/1   1          1         XmYs
    Copy to Clipboard Toggle word wrap
  5. oc get routes 를 입력하여 브라우저에서 서비스 레지스트리 웹 콘솔을 시작하려면 HOST/PORT URL을 가져옵니다. 예를 들면 다음과 같습니다.

    example-apicurioregistry-sql.apicurio-registry.router-default.apps.mycluster.myorg.mycompany.com
    Copy to Clipboard Toggle word wrap

2장. OpenShift에 서비스 레지스트리 설치

이 장에서는 OpenShift Container Platform에 서비스 레지스트리를 설치하는 방법을 설명합니다.

2.1. OpenShift OperatorHub에서 서비스 레지스트리 설치

OperatorHub에서 OpenShift 클러스터에 Service Registry Operator를 설치할 수 있습니다. OperatorHub는 OpenShift Container Platform 웹 콘솔에서 사용할 수 있으며 클러스터 관리자가 Operator를 검색하고 설치할 수 있는 인터페이스를 제공합니다. 자세한 내용은 OperatorHub 이해 를 참조하십시오.

참고

환경에 따라 서비스 레지스트리의 복제본을 두 개 이상 설치할 수 있습니다. 복제본 수는 서비스 레지스트리에 저장된 아티팩트 수 및 선택한 스토리지 옵션에 따라 다릅니다.

사전 요구 사항

  • OpenShift 클러스터에 대한 클러스터 관리자 액세스 권한이 있어야 합니다.

프로세스

  1. OpenShift Container Platform 웹 콘솔에서 클러스터 관리자 권한이 있는 계정을 사용하여 로그인합니다.
  2. 새 OpenShift 프로젝트를 생성합니다.

    1. 왼쪽 탐색 메뉴에서 ,프로젝트 를 클릭한 다음 프로젝트 만들기를 클릭합니다.
    2. 프로젝트 이름(예: my-project )을 입력하고 생성 을 클릭합니다.
  3. 왼쪽 탐색 메뉴에서 Operator를 클릭한 다음 OperatorHub 를 클릭합니다.
  4. 키워드로 필터링 텍스트 상자에 레지스트리 를 입력하여 Apicurio Registry 3 Operator의 Red Hat 빌드 를 찾습니다.
  5. Operator에 대한 정보를 읽고 설치를 클릭하여 Operator 서브스크립션 페이지를 표시합니다.
  6. 서브스크립션 설정을 선택합니다. 예를 들면 다음과 같습니다.
  7. 서브스크립션 설정을 선택합니다. 예를 들면 다음과 같습니다.

    • 업데이트 채널: 3.x 를 선택합니다.
    • 설치 모드: 다음 중 하나를 선택합니다.

      • 클러스터의 모든 네임스페이스(기본값)
      • 클러스터의 특정 네임스페이스my-project
    • 승인 전략: 자동 또는 수동선택
  8. 설치를 클릭하고 Operator를 사용할 준비가 될 때까지 몇 분 정도 기다립니다.

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

이 장에서는 서비스 레지스트리에서 사용할 수 있는 구성 옵션에 대한 참조 정보를 제공합니다.

추가 리소스

3.1. 서비스 레지스트리 구성 옵션

다음 서비스 레지스트리 구성 옵션은 각 구성 요소 범주에 사용할 수 있습니다.

== . 구성 옵션

Expand
이름유형기본에서 사용 가능설명

apicurio.app.date

string

 

3.0.4

 

apicurio.app.description

string

 

3.0.4

 

apicurio.app.name

string

 

3.0.4

 

apicurio.app.version

string

 

3.0.4

 

3.1.1. api

Expand
표 3.1. API 구성 옵션
이름유형기본에서 사용 가능설명

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 비활성화

3.1.2. auth

Expand
표 3.2. 인증 구성 옵션
이름유형기본에서 사용 가능설명

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

인증 서버 토큰 끝점.

3.1.3. 캐시

Expand
표 3.3. 캐시 구성 옵션
이름유형기본에서 사용 가능설명

apicurio.config.cache.enabled

boolean

true

2.2.2.Final

레지스트리 캐시 활성화

3.1.4. ccompat

Expand
표 3.4. ccompat 구성 옵션
이름유형기본에서 사용 가능설명

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)

3.1.5. 다운로드

Expand
표 3.5. 구성 옵션 다운로드
이름유형기본에서 사용 가능설명

apicurio.download.href.ttl.seconds

롱 [dynamic]

30

2.1.2.Final

링크 만료 다운로드

3.1.6. GitOps

Expand
표 3.6. GitOps 구성 옵션
이름유형기본에서 사용 가능설명

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 작업 디렉터리의 경로입니다.

3.1.7. 상태

Expand
표 3.7. 상태 구성 옵션
이름유형기본에서 사용 가능설명

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

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

3.1.8. 가져오기

Expand
표 3.8. 구성 옵션 가져오기
이름유형기본에서 사용 가능설명

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

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

3.1.9. limits

Expand
표 3.9. 제한 구성 옵션
이름유형기본에서 사용 가능설명

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

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

3.1.10. 리디렉션

Expand
표 3.10. 구성 옵션 리디렉션
이름유형기본에서 사용 가능설명

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을 생성하는 데 사용되는 포트를 재정의합니다.

3.1.11. rest

Expand
표 3.11. 나머지 구성 옵션
이름유형기본에서 사용 가능설명

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

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

3.1.12. semver

Expand
표 3.12. semver 구성 옵션
이름유형기본에서 사용 가능설명

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)을 준수하는지 확인합니다.

3.1.13. storage

Expand
표 3.13. 스토리지 구성 옵션
이름유형기본에서 사용 가능설명

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 상태로 아티팩트 버전 건너뛰기

3.1.14. ui

Expand
표 3.14. UI 구성 옵션
이름유형기본에서 사용 가능설명

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 경로에 대한 탐색 접두사

3.2. Service Registry 버전 2에서 버전 3 구성 변경

Service Registry v3에서는 구성 옵션을 단순화하여 중복을 제거하고 일관성을 개선했습니다. 대부분의 옵션의 경우 유일한 변경 사항은 레지스트리에서 apicurio 로 접두사를 ssrenaming하는 것입니다(예: registry.kafkasql.bootstrap.serversapicurio.kafkasql.bootstrap.servers 로 변경 ).

참고

각 구성 속성에 대해 해당 환경 변수(예: APICURIO_KAFKASQL_BOOTSTRAP_SERVERS.s)를 사용하여 값을 재정의할 수 있습니다.

3.2.1. api

Expand
표 3.15. API 구성 옵션
이름새로운 옵션

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

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

registry.disable.apis

apicurio.disable.apis

3.2.2. auth

Expand
표 3.16. 인증 구성 옵션
이름새로운 옵션

registry.auth.admin-override.claim

apicurio.auth.admin-override.claim

registry.auth.admin-override.claim-value

apicurio.auth.admin-override.claim-value

registry.auth.admin-override.enabled

apicurio.auth.admin-override.enabled

registry.auth.admin-override.from

apicurio.auth.admin-override.from

registry.auth.admin-override.role

apicurio.auth.admin-override.role

registry.auth.admin-override.type

apicurio.auth.admin-override.type

registry.auth.anonymous-read-access.enabled

apicurio.auth.anonymous-read-access.enabled

registry.auth.audit.log.prefix

apicurio.authn.audit.log.prefix

registry.auth.authenticated-read-access.enabled

apicurio.auth.authenticated-read-access.enabled

registry.auth.basic-auth-client-credentials.cache-expiration

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

registry.auth.basic-auth-client-credentials.cache-expiration-offset

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

registry.auth.basic-auth-client-credentials.enabled

apicurio.authn.basic-client-credentials.enabled

registry.auth.basic-auth.scope

apicurio.authn.basic.scope

registry.auth.client-id

quarkus.oidc.client-id

registry.auth.client-secret

quarkus.oidc.client-secret

registry.auth.enabled

quarkus.oidc.tenant-enabled

registry.auth.owner-only-authorization

apicurio.auth.owner-only-authorization

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

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

registry.auth.role-based-authorization

apicurio.auth.role-based-authorization

registry.auth.role-source

apicurio.auth.role-source

registry.auth.role-source.header.name

apicurio.auth.role-source.header.name

registry.auth.roles.admin

apicurio.auth.roles.admin

registry.auth.roles.developer

apicurio.auth.roles.developer

registry.auth.roles.readonly

apicurio.auth.roles.readonly

registry.auth.tenant-owner-is-admin.enabled

제거됨

registry.auth.token.endpoint

quarkus.oidc.token-path

3.2.3. 캐시

Expand
표 3.17. 캐시 구성 옵션
이름새로운 옵션

registry.config.cache.enabled

apicurio.config.cache.enabled

3.2.4. ccompat

Expand
표 3.18. ccompat 구성 옵션
이름새로운 옵션

registry.ccompat.legacy-id-mode.enabled

apicurio.ccompat.legacy-id-mode.enabled

registry.ccompat.max-subjects

apicurio.ccompat.max-subjects

registry.ccompat.use-canonical-hash

apicurio.ccompat.use-canonical-hash

3.2.5. 다운로드

Expand
표 3.19. 구성 옵션 다운로드
이름새로운 옵션

registry.download.href.ttl

apicurio.download.href.ttl.seconds

3.2.6. 이벤트

Expand
표 3.20. 이벤트 구성 옵션
이름새로운 옵션

registry.events.ksink

제거됨

3.2.7. 상태

Expand
표 3.21. 상태 구성 옵션
이름새로운 옵션

registry.liveness.errors.ignored

apicurio.liveness.errors.ignored

registry.metrics.PersistenceExceptionLivenessCheck.counterResetWindowDurationSec

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

registry.metrics.PersistenceExceptionLivenessCheck.disableLogging

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

registry.metrics.PersistenceExceptionLivenessCheck.errorThreshold

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

registry.metrics.PersistenceExceptionLivenessCheck.statusResetWindowDurationSec

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

registry.metrics.PersistenceTimeoutReadinessCheck.counterResetWindowDurationSec

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

registry.metrics.PersistenceTimeoutReadinessCheck.errorThreshold

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

registry.metrics.PersistenceTimeoutReadinessCheck.statusResetWindowDurationSec

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

registry.metrics.PersistenceTimeoutReadinessCheck.timeoutSec

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

registry.metrics.ResponseErrorLivenessCheck.counterResetWindowDurationSec

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

registry.metrics.ResponseErrorLivenessCheck.disableLogging

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

registry.metrics.ResponseErrorLivenessCheck.errorThreshold

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

registry.metrics.ResponseErrorLivenessCheck.statusResetWindowDurationSec

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

registry.metrics.ResponseTimeoutReadinessCheck.counterResetWindowDurationSec

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

registry.metrics.ResponseTimeoutReadinessCheck.errorThreshold

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

registry.metrics.ResponseTimeoutReadinessCheck.statusResetWindowDurationSec

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

registry.metrics.ResponseTimeoutReadinessCheck.timeoutSec

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

registry.storage.metrics.cache.check-period

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

3.2.8. 가져오기

Expand
표 3.22. 구성 옵션 가져오기
이름새로운 옵션

registry.import.url

apicurio.import.url

3.2.9. kafka

Expand
표 3.23. Kafka 구성 옵션
이름새로운 옵션

registry.events.kafka.topic

apicurio.events.kafka.topic

registry.events.kafka.topic-partition

제거됨

3.2.10. limits

Expand
표 3.24. 제한 구성 옵션
이름새로운 옵션

registry.limits.config.max-artifact-labels

apicurio.limits.config.max-artifact-labels

registry.limits.config.max-artifact-properties

apicurio.limits.config.max-artifact-properties

registry.limits.config.max-artifacts

apicurio.limits.config.max-artifact

registry.limits.config.max-description-length

apicurio.limits.config.max-description-length

registry.limits.config.max-label-size

apicurio.limits.config.max-label-size

registry.limits.config.max-name-length

apicurio.limits.config.max-name-length

registry.limits.config.max-property-key-size

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

registry.limits.config.max-property-value-size

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

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

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

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

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

registry.limits.config.max-total-schemas

apicurio.limits.config.max-total-schemas

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

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

registry.storage.metrics.cache.max-size

apicurio.storage.metrics.cache.max-size

3.2.11. 리디렉션

Expand
표 3.25. 구성 옵션 리디렉션
이름새로운 옵션

registry.enable-redirects

apicurio.redirects.enabled

registry.redirects

apicurio.redirects

registry.url.override.host

apicurio.url.override.host

registry.url.override.port

apicurio.url.override.port

3.2.12. rest

Expand
표 3.26. 나머지 구성 옵션
이름새로운 옵션

registry.rest.artifact.deletion.enabled

apicurio.rest.artifact.deletion.enabled

registry.rest.artifact.download.maxSize

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

registry.rest.artifact.download.skipSSLValidation

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

3.2.13. Store

Expand
표 3.27. 저장소 구성 옵션
이름새로운 옵션

artifacts.skip.disabled.latest

artifacts.skip.disabled.latest

registry.sql.init

apicurio.sql.init

3.2.14. ui

Expand
표 3.28. UI 구성 옵션
이름새로운 옵션

registry.ui.config.auth.oidc.client-id

apicurio.ui.auth.oidc.client-id

registry.ui.config.auth.oidc.redirect-url

apicurio.ui.auth.oidc.redirect-uri

registry.ui.config.auth.oidc.url

quarkus.oidc.auth-server-url

registry.ui.config.uiContextPath

apicurio.ui.contextPath

registry.ui.features.readOnly

apicurio.ui.features.read-only.enabled

registry.ui.features.settings

apicurio.ui.features.settings

부록 A. 서브스크립션 사용

서비스 레지스트리는 소프트웨어 서브스크립션을 통해 제공됩니다. 서브스크립션을 관리하려면 Red Hat 고객 포털에서 계정에 액세스하십시오.

계정 액세스

  1. access.redhat.com 으로 이동합니다.
  2. 계정이 없는 경우 계정을 생성합니다.
  3. 계정에 로그인합니다.

서브스크립션 활성화

  1. access.redhat.com 으로 이동합니다.
  2. 내 서브스크립션 으로 이동합니다.
  3. 서브스크립션 활성화로 이동하여 16자리 활성화 번호를 입력합니다.

ZIP 및 TAR 파일 다운로드

ZIP 또는 TAR 파일에 액세스하려면 고객 포털을 사용하여 다운로드할 관련 파일을 찾습니다. RPM 패키지를 사용하는 경우 이 단계는 필요하지 않습니다.

  1. 브라우저를 열고 Red Hat Customer Portal 제품 다운로드 페이지에 access.redhat.com/downloads.
  2. 통합 및 자동화 카테고리에서 Red Hat Integration 항목을 찾습니다.
  3. 원하는 Service Registry 제품을 선택합니다. 소프트웨어 다운로드 페이지가 열립니다.
  4. 구성 요소에 대한 다운로드 링크를 클릭합니다.

2025-05-15에 최종 업데이트된 문서

법적 공지

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat
맨 위로 이동