3.2. Service Registry Web コンソールを使用したアーティファクトの追加

手順

1. アーティファクト タブで アーティファクトのアップロード をクリックし、次の詳細を指定します。

   • Group & ID: デフォルトの空の設定を使用して、アーティファクト ID を自動的に生成し、アーティファクトを デフォルト のアーティファクトグループに追加します。または、オプションのアーティファクトグループ名または ID を入力することもできます。

   • Type: デフォルトの Auto-Detect 設定を使用してアーティファクトタイプを自動的に検出し、リストからアーティファクトタイプを選択します (例: Avro Schema または OpenAPI)。

     注記

     Service Registry は、Kafka Connect Schema アーティファクトタイプを自動的に検出できません。このアーティファクトタイプを手動で選択する必要があります。

   • Artifact: 次のいずれかのオプションを使用して、アーティファクトの場所を指定します。

     • ファイルから: Browse をクリックしてファイルを選択するか、ファイルをドラッグアンドドロップします。たとえば、my-openapi.json または my-schema.proto です。
     • URL から: 有効かつアクセス可能な URL を入力し、Fetch をクリックします。例: https://petstore3.swagger.io/api/v3/openapi.json。

2. Upload をクリックし、アーティファクトの詳細を表示します。

   • 概要: 名前、アーティファクト ID、グローバル ID、コンテンツ ID、ラベル、プロパティーなどのアーティファクトバージョンのメタデータを表示します。また、アーティファクトコンテンツに対して設定できる有効性および互換性のルールも表示されます。
   • ドキュメント (OpenAPI および AsyncAPI のみ): 自動生成された REST API ドキュメントを表示します。

   • Content: 全アーティファクトコンテンツの読み取り専用ビューを表示します。JSON コンテンツの場合、JSON または YAML をクリックして、好みの形式を表示できます。

     次の例は、Protobuf スキーマアーティファクトの例を示しています。

     図3.2 Service Registry Web コンソールのアーティファクトの詳細

     

3. Overview タブで、Edit 鉛筆アイコンをクリックして、名前や説明などのアーティファクトメタデータを編集します。

   オプションで、検索用のラベルのコンマ区切りリストを入力したり、アーティファクトに関連付けられた任意のプロパティーのキーと値のペアを追加したりすることもできます。プロパティーを追加するには、次の手順を実行します。

   1. Add property をクリックします。
   2. キー名と値を入力します。
   3. 複数のプロパティーを追加するには、最初の 2 つの手順を繰り返します。
   4. Save をクリックします。
4. アーティファクトの内容を my-protobuf-schema.proto などのローカルファイルに保存するには、ページの最後にある Download をクリックします。
5. 新しいアーティファクトバージョンを追加するには、ページヘッダーで Upload new version をクリックし、ドラッグアンドドロップするか Browse をクリックして、my-avro-schema.json や my-openapi.json などのファイルをアップロードします。

6. アーティファクトを削除するには、ページヘッダーの Delete をクリックします。

   警告

   アーティファクトを削除すると、アーティファクトとそのバージョンがすべて削除され、元に戻すことはできません。アーティファクトバージョンはイミュータブルで、個別に削除できません。