4.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 データをエクスポートします。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow curl MY-REGISTRY-URL/apis/registry/v2/admin/export \ -H "Authorization: Bearer $ACCESS_TOKEN" \ --output my-registry-data.zip
$ 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 インスタンスにインポートします。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 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
$ 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 Registry がデプロイされているホスト名です。例: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 を参照してください。