4.2. Service Registry REST API 명령을 사용하여 스키마 및 API 아티팩트 버전 관리

프로세스

1. /groups/{group}/artifacts 작업을 사용하여 레지스트리에 아티팩트 버전을 추가합니다. 다음 예제 curl 명령은 공유 가격 애플리케이션에 대한 간단한 아티팩트를 추가합니다.

   $ curl -X POST -H "Content-Type: application/json; artifactType=AVRO" \
     -H "X-Registry-ArtifactId: my-share-price" -H "X-Registry-Version: 1.1.1" \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     --data '{"type":"record","name":" p","namespace":"com.example", \
      "fields":[{"name":"symbol","type":"string"},{"name":"price","type":"string"}]}' \
      MY-REGISTRY-URL/apis/registry/v2/groups/my-group/artifacts

   • 이 예제에서는 my-share- price 및 버전 1.1.1 의 아티팩트 ID를 사용하여 Avro 스키마 아티팩트를 추가합니다. 버전을 지정하지 않으면 Service Registry에서 기본 버전 1 을 자동으로 생성합니다.
   • MY-REGISTRY-URL 은 서비스 레지스트리가 배포된 호스트 이름입니다. 예: my-cluster-service-registry-myproject.example.com.
   • 이 예제에서는 API 경로에 my-group 의 그룹 ID를 지정합니다. 고유한 그룹 ID를 지정하지 않으면 API 경로에 ../groups/default 를 지정해야 합니다.

2. 응답에 사용자 정의 아티팩트 버전이 추가되었는지 확인하는 예상 JSON 본문이 포함되어 있는지 확인합니다. 예를 들면 다음과 같습니다.

   {"createdBy":"","createdOn":"2021-04-16T10:51:43+0000","modifiedBy":"",
   "modifiedOn":"2021-04-16T10:51:43+0000","id":"my-share-price","version":"1.1.1",
   "type":"AVRO","globalId":3,"state":"ENABLED","groupId":"my-group","contentId":3}

   • 아티팩트를 추가할 때 1.1.1 의 사용자 지정 버전이 지정되었습니다.
   • 이는 레지스트리에 추가된 세 번째 아티팩트이므로 글로벌 ID 및 콘텐츠 ID의 값은 3 입니다.

3. API 경로에서 아티팩트 ID 및 버전을 사용하여 레지스트리에서 아티팩트 콘텐츠를 검색합니다. 이 예에서 지정된 ID는 my-share- price 이고 버전은 1.1.1 입니다.

   $ curl -H "Authorization: Bearer $ACCESS_TOKEN" \
   MY-REGISTRY-URL/apis/registry/v2/groups/my-group/artifacts/my-share-price/versions/1.1.1
   {"type":"record","name":"price","namespace":"com.example",
     "fields":[{"name":"symbol","type":"string"},{"name":"price","type":"string"}]}