Red Hat Summit4.4. Apicurio Registry REST API コマンドを使用したレジストリーデータのエクスポートとインポート
管理者は、Core Registry API v2 を使用して、ある Apicurio Registry インスタンスからデータをエクスポートし、別の Apicurio Registry インスタンスにインポートできるため、異なるインスタンス間でデータを移行できます。
このセクションでは、Core Registry API v2 を使用して、既存のデータを .zip 形式でエクスポートし、ある Apicurio Registry インスタンスから別のインスタンスにインポートする簡単な curl ベースの例を示します。Apicurio Registry インスタンスに含まれるすべてのアーティファクトデータは、.zip ファイルにエクスポートされます。
別の Apicurio Registry インスタンスからエクスポートされた Apicurio Registry データのみをインポートできます。
前提条件
- Apicurio Registry が環境にインストールされ、実行されています。
Apicurio Registry インスタンスが作成されました。
- データのエクスポート元のソースインスタンスには、1 つ以上のスキーマまたは API アーティファクトが含まれています。
- データをインポートするターゲットインスタンスは、一意の ID を保持するために空です。
手順
既存のソース Apicurio Registry インスタンスから Apicurio Registry データをエクスポートします。
$ curl MY-REGISTRY-URL/apis/registry/v2/admin/export \ -H "Authorization: Bearer $ACCESS_TOKEN" \ --output my-registry-data.zip
MY-REGISTRY-URLは、ソース Apicurio Registry がデプロイされているホスト名です。例:my-cluster-source-registry-myproject.example.com。レジストリーデータをターゲット Apicurio Registry インスタンスにインポートします。
$ curl -X POST "MY-REGISTRY-URL/apis/registry/v2/admin/import" \ -H "Content-Type: application/zip" -H "Authorization: Bearer $ACCESS_TOKEN" \ --data-binary @my-registry-data.zip
MY-REGISTRY-URLは、ターゲットの Apicurio レジストリーがデプロイされているホスト名です。例:my-cluster-target-registry-myproject.example.com。
関連情報
-
詳細は、Apicurio Registry REST API documentation の
adminエンドポイントを参照してください。 - Apicurio Registry バージョン 1.x から 2.x に移行するエクスポートツールの詳細は、Apicurio Registry export utility for 1.x versions を参照してください。
