第11章 Maven プラグインを使用した Service Registry コンテンツの管理

手順

• Maven pom.xml ファイルを更新して、 apicurio-registry-maven-plugin を使用してアーティファクトを登録します。以下の例は、Apache Avro スキーマの登録を示しています。

  <plugin>
    <groupId>io.apicurio</groupId>
    <artifactId>apicurio-registry-maven-plugin</artifactId>
    <version>${registry.version}</version>
    <executions>
      <execution>
        <phase>generate-sources</phase>
        <goals>
          <goal>register</goal> 1
        </goals>
        <configuration>
          <registryUrl>http://my-cluster-service-registry-myproject.example.com/api</registryUrl> 2
          <artifactType>AVRO</artifactType>
          <artifacts>
            <schema1>${project.basedir}/schemas/schema1.avsc</schema1> 3
          </artifacts>
        </configuration>
      </execution>
    </executions>
  </plugin>

  1

  スキーマアーティファクトをレジストリーにアップロードするための実行目標として register を指定します。

  2

  /api エンドポイントで Service Registry URL を指定する必要があります。

  3

  アーティファクト ID と場所を使用して複数のアーティファクトをアップロードできます。

手順

• Maven pom.xml ファイルを更新して、apicurio-registry-maven-plugin を使用してアーティファクトをダウンロードします。以下の例は、アーティファクト ID による単一のスキーマのダウンロードを示しています。

  <plugin>
  <groupId>io.apicurio</groupId>
  <artifactId>apicurio-registry-maven-plugin</artifactId>
  <version>${registry.version}</version>
  <executions>
    <execution>
      <phase>generate-sources</phase>
      <goals>
        <goal>download</goal> 1
      </goals>
      <configuration>
        <registryUrl>http://my-cluster-service-registry-myproject.example.com/api</registryUrl> 2
        <ids>
          <param1>schema1</param1> 3
        </ids>
        <artifactExtension>.avsc</artifactExtension> 4
        <outputDirectory>${project.build.directory}</outputDirectory>
     </configuration>
   </execution>
  </executions>
  </plugin>

  1

  実行目標として download を指定します。

  2

  /api エンドポイントで Service Registry URL を指定する必要があります。

  3

  アーティファクト ID を使用すると、複数のアーティファクトを指定したディレクトリーにダウンロードできます。

  4

  プラグインは適切なファイル拡張子の選択を自動的に試みますが、< artifactExtension> を使用して上書きできます。

手順

• Maven pom.xml ファイルを更新して、 apicurio-registry-maven-plugin を使用してアーティファクトをテストします。Apache Avro スキーマのテストの例を以下に示します。

  <plugin>
    <groupId>io.apicurio</groupId>
    <artifactId>apicurio-registry-maven-plugin</artifactId>
    <version>${registry.version}</version>
    <executions>
      <execution>
        <phase>generate-sources</phase>
        <goals>
          <goal>test-update</goal> 1
        </goals>
        <configuration>
          <registryUrl>http://my-cluster-service-registry-myproject.example.com/api</registryUrl> 2
          <artifactType>AVRO</artifactType>
          <artifacts>
            <schema1>${project.basedir}/schemas/schema1.avsc</schema1> 3
          </artifacts>
        </configuration>
      </execution>
    </executions>
  </plugin>

  1

  スキーマアーティファクトをテストするための実行目標として test-update を指定します。

  2

  /api エンドポイントで Service Registry URL を指定する必要があります。

  3

  アーティファクト ID と場所を使用して複数のアーティファクトをテストできます。

関連情報

• Service Registry Maven プラグインの詳細は、「Registry demonstration example」を参照してください。