3.2. 서비스 레지스트리 웹 콘솔을 사용하여 아티팩트 추가

프로세스

1. Artifacts 탭에서 아티팩트 업로드 를 클릭하고 다음 세부 정보를 지정합니다.

   • Group & ID: 기본 빈 설정을 사용하여 아티팩트 ID를 자동으로 생성하고 기본 아티팩트 그룹에 아티팩트를 추가합니다. 또는 선택적 아티팩트 그룹 이름 또는 ID를 입력할 수 있습니다.

   • 유형: 기본 자동 감지 설정을 사용하여 아티팩트 유형을 자동으로 감지하거나 목록에서 아티팩트 유형을 선택합니다(예: Avro Schema 또는 OpenAPI ).

     참고

     서비스 레지스트리는 Kafka Connect 스키마 아티팩트 유형을 자동으로 감지할 수 없습니다. 이 아티팩트 유형을 수동으로 선택해야 합니다.

   • artifact: 다음 옵션 중 하나를 사용하여 아티팩트 위치를 지정합니다.

     • 파일: 찾아보기 를 클릭하고 파일을 선택하거나 파일을 드래그 앤 드롭합니다. 예를 들어 my-openapi.json 또는 my-schema.proto.
     • URL에서: 유효하고 액세스 가능한 URL을 입력하고 Fetch 를 클릭합니다. 예: https://petstore3.swagger.io/api/v3/openapi.json.

2. 업로드 를 클릭하고 아티팩트 세부 정보를 확인합니다.

   • 개요: 이름, 아티팩트 ID, 글로벌 ID, 콘텐츠 ID, 라벨 및 속성과 같은 아티팩트 버전 메타데이터를 표시합니다. 또한 아티팩트 콘텐츠에 대해 구성할 수 있는 유효성 및 호환성에 대한 규칙을 표시합니다.
   • 문서 (OpenAPI 및 AsyncAPI만 해당): 자동으로 생성된 REST API 문서를 표시합니다.

   • Content: 전체 아티팩트 콘텐츠의 읽기 전용 보기를 표시합니다. JSON 콘텐츠의 경우 JSON 또는 YAML 을 클릭하여 원하는 형식을 표시할 수 있습니다.

     다음 예제에서는 Protobuf 스키마 아티팩트 예제를 보여줍니다.

     그림 3.2. 서비스 레지스트리 웹 콘솔의 아티팩트 세부 정보

     

     View larger image

     

3. 개요 탭에서 연필 편집 아이콘을 클릭하여 이름 또는 설명과 같은 아티팩트 메타데이터를 편집합니다.

   검색할 레이블의 선택적 쉼표로 구분된 목록을 입력하거나 아티팩트와 연결된 임의의 속성의 키-값 쌍을 추가할 수도 있습니다. 속성을 추가하려면 다음 단계를 수행합니다.

   1. 속성 추가를 클릭합니다.
   2. 키 이름과 값을 입력합니다.
   3. 처음 두 단계를 반복하여 여러 속성을 추가합니다.
   4. 저장을 클릭합니다.
4. 아티팩트 내용을 로컬 파일에 저장하려면 my-protobuf-schema.proto 를 클릭하여 페이지 끝에 있는 다운로드를 클릭합니다.
5. 새 아티팩트 버전을 추가하려면 페이지 헤더에 새 버전 업로드 를 클릭하고 드래그 앤 드롭을 클릭하여 파일을 업로드합니다(예: my-avro-schema.json 또는 my-openapi.json ).

6. 아티팩트를 삭제하려면 페이지 헤더에서 삭제 를 클릭합니다.

   주의

   아티팩트를 삭제하면 아티팩트와 모든 버전이 삭제되며 실행 취소할 수 없습니다. 아티팩트 버전은 변경할 수 없으며 개별적으로 삭제할 수 없습니다.