5장. Maven 플러그인을 사용하여 서비스 레지스트리 콘텐츠 관리

프로세스

1. apicurio-registry-maven-plugin 을 사용하여 아티팩트를 등록하도록 Maven pom.xml 파일을 업데이트합니다. 다음 예제에서는 Apache Avro 및 GraphQL 스키마를 등록하는 방법을 보여줍니다.

   <plugin>
     <groupId>io.apicurio</groupId>
     <artifactId>apicurio-registry-maven-plugin</artifactId>
     <version>${apicurio.version}</version>
     <executions>
         <execution>
           <phase>generate-sources</phase>
           <goals>
               <goal>register</goal>  1
           </goals>
           <configuration>
               <registryUrl>MY-REGISTRY-URL/apis/registry/v2</registryUrl> 2
               <authServerUrl>MY-AUTH-SERVER</authServerUrl>
               <clientId>MY-CLIENT-ID</clientId>
               <clientSecret>MY-CLIENT-SECRET</clientSecret> 3
               <clientScope>MY-CLIENT-SCOPE</clientScope>
               <artifacts>
                   <artifact>
                       <groupId>TestGroup</groupId> 4
                       <artifactId>FullNameRecord</artifactId>
                       <file>${project.basedir}/src/main/resources/schemas/record.avsc</file>
                       <ifExists>FAIL</ifExists>
                   </artifact>
                   <artifact>
                       <groupId>TestGroup</groupId>
                       <artifactId>ExampleAPI</artifactId> 5
                       <type>GRAPHQL</type>
                       <file>${project.basedir}/src/main/resources/apis/example.graphql</file>
                       <ifExists>RETURN_OR_UPDATE</ifExists>
                       <canonicalize>true</canonicalize>
                   </artifact>
               </artifacts>
           </configuration>
       </execution>
     </executions>
    </plugin>

   1

   서비스 레지스트리에 스키마 아티팩트를 업로드하는 실행 목표로 register 를 지정합니다.

   2

   ../apis/registry/v2 끝점을 사용하여 서비스 레지스트리 URL을 지정합니다.

   3

   인증이 필요한 경우 인증 서버 및 클라이언트 자격 증명을 지정할 수 있습니다.

   4

   Service Registry 아티팩트 그룹 ID를 지정합니다. 고유한 그룹 ID를 사용하지 않으려면 기본 그룹을 지정할 수 있습니다.

   5

   지정된 그룹 ID, 아티팩트 ID 및 위치를 사용하여 여러 아티팩트를 등록할 수 있습니다.

2. 예를 들어 mvn package 명령을 사용하여 Maven 프로젝트를 빌드합니다.