第3章 Web コンソールを使用した Apicurio Registry コンテンツの管理

手順

1. 以下で Apicurio Registry Web コンソールに接続します。

   http://MY_REGISTRY_URL/ui

2. Upload artifact をクリックし、以下の項目を指定します。

   • Group & ID: デフォルトの空の設定を使用して ID および default グループを自動的に生成するか、オプションのアーティファクトグループまたは ID を入力します。

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

     注記

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

   • Artifact: ドラッグアンドドロップまたは Browse をクリックして、 my-schema.json や my-openapi.json などのファイルをアップロードします。

3. Upload をクリックし、Artifact Details を表示します。

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

   
   • info: アーティファクト名とオプションのグループ、説明、ライフサイクルのステータス、作成時、および最終更新日を表示します。Edit Artifact Metadata 鉛筆アイコンをクリックしてアーティファクト名と説明を編集するか、ラベルを追加し、Download をクリックしてアーティファクトファイルをローカルにダウンロードします。また、有効化および設定できるアーティファクトコンテンツルールも表示します。
   • ドキュメント (OpenAPI のみ): 自動生成される REST API ドキュメントを表示します。
   • Content: 全アーティファクトコンテンツの読み取り専用ビューを表示します。
4. Content Rules で Enable をクリックして Validity Rule または Compatibility Rule を設定し、ドロップダウンから適切なルール設定を選択します。詳細は 9章Apicurio Registry アーティファクトの参照 を参照してください。
5. Upload new version をクリックして新しいアーティファクトバージョンを追加し、ドラッグアンドドロップまたは Browse をクリックしてファイル (my-schema.json や my-openapi.json など) をアップロードします。

6. アーティファクトを削除するには、Upload new versio の横にあるゴミ箱アイコンをクリックします。

   警告

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