第4章 Service Registry でのアーティファクトの管理
本章では、Service Registry でアーティファクトを管理するさまざまな方法について説明します。
4.1. Registry REST API を使用したアーティファクトの管理
Registry REST API を使用すると、クライアントアプリケーションが実稼働環境にデプロイされた CI/CD パイプラインなどでレジストリーのアーティファクトを管理できます。この REST API は、レジストリーに保存されているアーティファクト、バージョン、メタデータ、およびルールの作成、読み取り、更新、および削除の操作を提供します。
REST API を使用して Service Registry でアーティファクトを作成する場合、一意のアーティファクト ID を指定しない場合、Service Registry は UUID として自動的に生成します。
本章では、レジストリー REST API を使用してレジストリーで Apache Avro スキーマアーティファクトを作成および取得する簡単な curl ベースの例を紹介します。
前提条件
- 「Registry REST API」を参照してください。
- Service Registry が環境にインストールされ、実行されている。詳細は、3章Service Registry のインストール を参照してください。
手順
/artifacts
操作を使用してレジストリーにアーティファクトを作成します。以下のcurl
コマンドの例では、価格アプリケーションの単純なアーティファクトを作成します。$ curl -X POST -H "Content-type: application/json; artifactType=AVRO" -H "X-Registry-ArtifactId: share-price" --data '{"type":"record","name":"price","namespace":"com.example","fields":[{"name":"symbol","type":"string"},{"name":"price","type":"string"}]}' http://MY-REGISTRY-HOST/artifacts
以下の例は、
共有価格
のアーティファクト ID を持つ Avro スキーマアーティファクトを作成する方法を示しています。MY-REGISTRY-HOST
は、Service Registry がデプロイされているホスト名です。例:my-cluster-service-registry-myproject.example.com
。応答に、アーティファクトが作成されたことを確認するには、想定される JSON ボディーが含まれていることを確認します。以下に例を示します。
{"createdOn":1578310374517,"modifiedOn":1578310374517,"id":"share-price","version":1,"type":"AVRO","globalId":8}
アーティファクト ID を使用してレジストリーからアーティファクトを取得します。たとえば、この場合は、指定の ID が
share-price
になります。$ curl https://MY-REGISTRY-URL/artifacts/share-price '{"type":"record","name":"price","namespace":"com.example","fields":[{"name":"symbol","type":"string"},{"name":"price","type":"string"}]}
関連情報
- REST API のサンプル要求の詳細は、Registry REST API のドキュメント を参照してください。