3.4. Service Registry 웹 콘솔을 사용하여 OpenAPI 아티팩트용 클라이언트 SDK 생성
서비스 레지스트리 웹 콘솔을 사용하여 OpenAPI 아티팩트를 위한 클라이언트 소프트웨어 개발 키트(SDK)를 구성, 생성 및 다운로드할 수 있습니다. 그런 다음 생성된 클라이언트 SDK를 사용하여 OpenAPI를 기반으로 특정 플랫폼에 대한 클라이언트 애플리케이션을 빌드할 수 있습니다.
Service Registry는 다음 프로그래밍 언어를 위한 클라이언트 SDK를 생성합니다.
- C#
- Go
- Java
- PHP
- Python
- Ruby
- Swift
- TypeScript
OpenAPI 아티팩트용 클라이언트 SDK 생성은 브라우저에서만 실행되며 API를 사용하여 자동화할 수 없습니다. Service Registry에 새 아티팩트 버전이 추가될 때마다 클라이언트 SDK를 다시 생성해야 합니다.
사전 요구 사항
- 사용자 환경에 서비스 레지스트리가 설치되어 실행 중입니다.
서비스 레지스트리 웹 콘솔에 로그인되어 있습니다.
http://MY_REGISTRY_URL/ui- 웹 콘솔, 명령줄, Maven 플러그인 또는 Java 클라이언트 애플리케이션을 사용하여 OpenAPI 아티팩트가 서비스 레지스트리에 추가되었습니다.
프로세스
- Artifacts 탭에서 Service Registry에 저장된 아티팩트 목록을 찾아보거나 검색 문자열을 입력하여 특정 OpenAPI 아티팩트를 찾습니다. 목록에서 이름, 그룹, 레이블 또는 글로벌 ID와 같은 기준으로 검색할 수 있습니다.
- 목록에서 OpenAPI 아티팩트를 클릭하여 세부 정보를 확인합니다.
버전 메타데이터 섹션에서 클라이언트 SDK 생성 을 클릭하고 대화 상자에서 다음 설정을 구성합니다.
- Language: 클라이언트 SDK를 생성할 프로그래밍 언어(예: Java )를 선택합니다.
-
생성된 클라이언트 클래스 이름: 클라이언트 SDK의 클래스 이름을 입력합니다(예:
MyJavaClientSDK). -
생성된 클라이언트 패키지 이름: 클라이언트 SDK의 패키지 이름을 입력합니다(예:
io.my.example.sdk).
고급 설정 표시를 클릭하여 포함 또는 제외할 선택적 쉼표로 구분된 경로 패턴 목록을 구성합니다.
-
경로 패턴 포함: 클라이언트 SDK를 생성할 때 포함할 특정 경로를 입력합니다(예:
**/.*, **/my-path/*). 이 필드가 비어 있으면 모든 경로가 포함됩니다. 경로 패턴 제외: 클라이언트 SDK를 생성할 때 제외할 특정 경로를 입력합니다(예:
**/my-other-path/*). 이 필드가 비어 있으면 경로가 제외되지 않습니다.그림 3.4. 서비스 레지스트리 웹 콘솔에서 Java 클라이언트 SDK 생성
-
경로 패턴 포함: 클라이언트 SDK를 생성할 때 포함할 특정 경로를 입력합니다(예:
- 대화 상자에서 설정을 구성한 경우 생성 및 다운로드를 클릭합니다.
-
대화 상자에 클라이언트 SDK의 파일 이름(예:
my-client-java.zip)을 입력하고 저장을 클릭하여 다운로드합니다.
추가 리소스
- 서비스 레지스트리는 Microsoft의 Kiota를 사용하여 클라이언트 SDK를 생성합니다. 자세한 내용은 GitHub의 Kiota 프로젝트를 참조하십시오.
- 생성된 SDK를 사용하여 클라이언트 애플리케이션을 빌드하는 방법에 대한 자세한 내용 및 예제는 Kiota 설명서 를 참조하십시오.
