Exchange へのカスタムポリシーのアップロード

カスタムポリシーの開発サイクルでは、ポリシーを Exchange にアップロードして新しい Exchange アセットを作成し、ポリシーのバージョンを管理したり、他のユーザーに配布したりできます。Exchange についての詳細は、Anypoint Exchange の概要を参照してください。

ローカルモードで実行されるカスタムポリシーは、Exchange にパブリッシュする必要はありません。ただし、Exchange は便利なバージョン管理ツールとして利用できます。ローカルモードで使用するカスタムポリシーを配布するのは自分の責任となります。

ポリシーを Exchange にアップロードする際には、以下のいずれかを選択できます。

  • カスタムポリシーのパブリッシュ
    ポリシーのバージョンがまだ開発中の段階でポリシーをパブリッシュします。これにより、ポリシーバージョンをテストして編集できます。

  • カスタムポリシーのリリース
    ポリシーをリリースして、ポリシーの確定版を作成します。ポリシーをリリースした後でポリシーを編集するには、新しいポリシーバージョンを作成する必要があります。

ポリシーをパブリッシュまたはリリースするたびに、Exchange に新しい​安定状態の​アセットが作成されます。​安定​状態のアセットの詳細については、​「Stable State Assets (安定状態のアセット)」​を参照してください。

ポリシーを Exchange にアップロードしたら、see カスタムポリシーの適用を参照してください。

始める前に

カスタムポリシーをパブリッシュする

カスタムポリシーをパブリッシュするには、ポリシーのルートフォルダーから ​make publish​ コマンドを実行します。

make publish

アセットをパブリッシュすると、​DEV​ という表示ラベルの付いたアセットが Exchange に表示されます。

DEV という表示ラベルが付いて Exchange に表示されたポリシー。

アセットのグループ ID、アセット ID、アセットバージョン (GAV) が次のように表示されます。

  • groupID​: <organizationId>

  • assetID​: my-custom-policy-dev

    ポリシーをパブリッシュすると、​assetID​ の後ろに ​-dev​ が付加されます。

  • version​: 1.0.0-20230618115723

    ポリシーをパブリッシュすると、​version​ の後ろにタイムスタンプが付加されます。

publish コマンドを再実行すると、ポリシーアセットの新しい場合が作成され、更新されたタイムスタンプが付加されます。以前にパブリッシュしたポリシーバージョンも引き続き使用できます。

カスタムポリシーをリリースする

カスタムポリシーをリリースするには、ポリシーのルートフォルダーから ​make release​ コマンドを実行します。

make release

リリースされたポリシーには ​DEV​ は付加されません。アセットの GAV は次のようになります。

  • groupID​: <organizationId>

  • assetID​: my-custom-policy

    リリースされたポリシーの ​assetID​ の後ろには ​-dev​ は付加されません。

  • version​: 1.0.0

    リリースされたポリシーの ​assetID​ の後ろにはタイムスタンプは付加されません。

アセットのリリース後に ​make release​ コマンドを再実行すると、競合エラーが発生します。

ポリシーの次のバージョンの作業を開始するには、​Cargo.toml​ ファイルでバージョン番号を更新してください。

たとえば、最新バージョンが ​1.0.0​ であれば、​Cargo.toml​ ファイルを次のように更新してマイナーリリースの作業を開始します。

name = "my-custom-policy"
version = "1.1.0"