2장. 서비스 레지스트리 콘텐츠 규칙


이 장에서는 서비스 레지스트리 콘텐츠를 관리하는 데 사용되는 선택적 규칙을 소개하고 사용 가능한 규칙 구성에 대한 세부 정보를 제공합니다.

2.1. 규칙을 사용하여 서비스 레지스트리 콘텐츠 관리

서비스 레지스트리에 추가된 아티팩트 컨텐츠의 진화를 제어하기 위해 선택적 규칙을 구성할 수 있습니다. 새 아티팩트 버전을 서비스 레지스트리에 업로드하기 전에 구성된 모든 글로벌 규칙 또는 아티팩트 규칙을 전달해야 합니다. 구성된 아티팩트 규칙은 구성된 모든 글로벌 규칙을 재정의합니다.

이러한 규칙의 목표는 잘못된 콘텐츠가 서비스 레지스트리에 추가되지 않도록 하는 것입니다. 예를 들어 다음과 같은 이유로 콘텐츠가 유효하지 않을 수 있습니다.

  • 지정된 아티팩트 유형에 대한 잘못된 구문 (예: AVRO 또는 PROTOBUF)
  • 유효한 구문이지만 의미 체계는 사양을 위반
  • 비호환성 - 새 콘텐츠에 현재 아티팩트 버전에 대한 변경 중단이 포함된 경우

Service Registry 웹 콘솔, REST API 명령 또는 Java 클라이언트 애플리케이션을 사용하여 선택적 콘텐츠 규칙을 활성화할 수 있습니다.

2.1.1. 규칙이 적용되는 경우

규칙은 Service Registry에 콘텐츠가 추가된 경우에만 적용됩니다. 여기에는 다음 REST 작업이 포함됩니다.

  • 아티팩트 추가
  • 아티팩트 업데이트
  • 아티팩트 버전 추가

규칙을 위반하는 경우 서비스 레지스트리는 HTTP 오류를 반환합니다. 응답 본문에는 위반된 규칙과 무엇이 잘못되었는지 보여주는 메시지가 포함됩니다.

2.1.2. 규칙 우선순위

글로벌 수준 및 아티팩트 수준에서 서비스 레지스트리 콘텐츠 규칙을 구성할 수 있습니다. 우선순위 순서는 다음과 같습니다.

  • 아티팩트 규칙과 동등한 글로벌 규칙을 활성화하면 아티팩트 규칙이 글로벌 규칙을 덮어씁니다.
  • 아티팩트 규칙을 비활성화하고 동등한 글로벌 규칙을 활성화하면 글로벌 규칙이 적용됩니다.
  • 아티팩트 수준에서 규칙을 비활성화하고 글로벌 수준에서 모든 아티팩트에 대한 규칙을 비활성화합니다.
  • 아티팩트 수준에서 규칙 값을 NONE 으로 설정하면 활성화된 글로벌 규칙을 덮어씁니다. 이 경우 아티팩트 규칙 값 NONE 은 이 아티팩트에 대해 우선하지만 활성화된 글로벌 규칙은 아티팩트 수준에서 규칙이 비활성화된 다른 아티팩트에 계속 적용됩니다.

2.1.3. 규칙 작동 방식

각 규칙에는 이름 및 구성 정보가 있습니다. 서비스 레지스트리는 각 아티팩트 및 글로벌 규칙 목록을 유지 관리합니다. 목록의 각 규칙은 규칙 구현에 대한 이름과 구성으로 구성됩니다.

규칙은 현재 아티팩트 버전의 콘텐츠(있는 경우) 및 추가되는 아티팩트의 새 버전과 함께 제공됩니다. 규칙 구현은 아티팩트가 규칙을 전달하는지 여부에 따라 true 또는 false를 반환합니다. 그렇지 않은 경우 서비스 레지스트리는 HTTP 오류 응답에서 이유를 보고합니다. 일부 규칙은 이전 버전의 콘텐츠를 사용하지 않을 수 있습니다. 예를 들어 호환성 규칙은 이전 버전을 사용하지만 구문 또는 의미 체계 유효성 규칙은 그렇지 않습니다.

2.1.4. 콘텐츠 규칙 구성

각 아티팩트에 대해 개별적으로 규칙을 구성하고 전역적으로 구성할 수 있습니다. 서비스 레지스트리는 특정 아티팩트에 대해 구성된 규칙을 적용합니다. 해당 수준에서 규칙이 구성되지 않은 경우 서비스 레지스트리는 전역적으로 구성된 규칙을 적용합니다. 글로벌 규칙이 구성되지 않은 경우 규칙이 적용되지 않습니다.

아티팩트 규칙 구성

서비스 레지스트리 웹 콘솔 또는 REST API를 사용하여 아티팩트 규칙을 구성할 수 있습니다. 자세한 내용은 다음을 참조하십시오.

글로벌 규칙 구성

다음과 같은 다양한 방법으로 글로벌 규칙을 구성할 수 있습니다.

  • REST API에서 /rules 작업 사용
  • 서비스 레지스트리 웹 콘솔 사용
  • 서비스 레지스트리 애플리케이션 속성을 사용하여 기본 글로벌 규칙 설정

기본 글로벌 규칙 구성

글로벌 규칙을 활성화하거나 비활성화하려면 애플리케이션 수준에서 서비스 레지스트리를 구성할 수 있습니다. 다음 애플리케이션 속성 형식을 사용하여 설치 후 구성 없이 설치 시 기본 글로벌 규칙을 구성할 수 있습니다.

registry.rules.global.<ruleName>
Copy to Clipboard Toggle word wrap

현재 다음과 같은 규칙 이름이 지원됩니다.

  • 호환성
  • validity

애플리케이션 속성의 값은 구성 중인 규칙과 관련된 유효한 구성 옵션이어야 합니다.

참고

이러한 애플리케이션 속성을 Java 시스템 속성으로 구성하거나 Quarkus application.properties 파일에 포함할 수 있습니다. 자세한 내용은 Quarkus 설명서 를 참조하십시오.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat