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 을 클릭하여 원하는 형식을 표시할 수 있습니다.

   • references: 이 아티팩트에서 참조하는 모든 아티팩트의 읽기 전용 보기를 표시합니다. 이 아티팩트를 참조하는 아티팩트 보기를 클릭할 수도 있습니다. Service Registry Maven 플러그인 또는 REST API만 사용하여 아티팩트 참조를 추가할 수 있습니다.

     다음 예제에서는 OpenAPI 아티팩트 예제를 보여줍니다.

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

     

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

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

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

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

   주의

   아티팩트를 삭제하면 아티팩트와 모든 버전이 삭제되며 실행 취소할 수 없습니다.