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

절차

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

   • Group & ID: 기본 빈 설정을 사용하여 아티팩트 ID를 자동으로 생성하고 기본 아티팩트 그룹에 아티팩트를 추가합니다. 또는 선택적 아티팩트 그룹 이름 또는 ID를 입력할 수 있습니다.
   • type : 기본 Auto-Detect 설정을 사용하여 아티팩트 유형을 자동으로 감지하거나 목록에서 아티팩트 유형을 선택합니다(예: Avro Schema 또는 OpenAPI ). 자동으로 감지할 수 없는 Kafka Connect Schema 아티팩트 유형을 수동으로 선택해야 합니다.

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

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

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

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

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

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

     그림 3.2. Service Registry 웹 콘솔의 아티팩트 세부 정보

     

     View larger image

     

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

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

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

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

   주의

   아티팩트를 삭제하면 아티팩트 및 해당 버전이 모두 삭제되며 취소할 수 없습니다.