Mule ゲートウェイ PDK ポリシーの作成

Flex Gateway ポリシー開発キット (PDK) では、環境を強化する Mule ゲートウェイポリシーの作成がサポートされています。

  • ポリシーの作成

  • 設定スキーマの定義

  • Exchange へのポリシーのデプロイ

PDK Anypoint CLI プラグインでは、必要なすべてのポリシーファイルが含まれるカスタムポリシーフォルダーが生成されます。PDK のフォルダーには、ポリシー UI をビルドしたり、Exchange にデプロイしたりするコマンドと共に Makefile が含まれます。

Mule カスタムポリシーを作成する手順は、次のとおりです。

始める前に

始める前に、次の前提条件を満たしていることを確認してください。

  • PDK でサポートされていて、Make がインストールされているオペレーティングシステム

  • Anypoint CLI

  • Java

    サポートされている Java バージョンについての詳細は、Java サポートを参照してください。

  • Apache Maven

    Apache Maven は ​Mule Maven Plugin. PDK Mule Policy projects include an embedded Mule Maven Plugin so downloading the plugin is not required. To ensure your Maven version is compatible with the latest plugin, see Mule Maven Plugin Release Notes​の前提条件です。

  • MuleSoft の Maven アーキタイプ

    Maven の ​settings.xml​ ファイルに次のコードセクションを追加して、MuleSoft の Maven アーキタイプを設定します。

     <profiles>
       <profile>
         <id>archetype-repository</id>
         <repositories>
           <repository>
             <id>archetype</id>
             <name>Mule Repository</name>
             <url>https://repository.mulesoft.org/nexus/content/repositories/public</url>
             <releases>
               <enabled>true</enabled>
               <checksumPolicy>fail</checksumPolicy>
             </releases>
             <snapshots>
               <enabled>true</enabled>
               <checksumPolicy>warn</checksumPolicy>
             </snapshots>
           </repository>
         </repositories>
       </profile>
     </profiles>

PDK を使用して Mule カスタムポリシーを作成する

カスタムポリシーを作成するには、次のコマンドを実行します。

pdk policy-project create --name <policy-name> --implementation-technology mule4

このコマンドを実行すると、ポリシー名でカスタムポリシーフォルダーが生成されます。フォルダーには、ポリシー開発ライフサイクルで必要になるすべての呼び出し可能なアクションを提供する makefile が含まれます。

ポリシースキーマを定義する

ポリシープロジェクト内の ​gcl.yaml​ ファイルを使用して、ポリシーのスキーマを定義します。PDK では、スキーマ定義で定義されたパラメーターに基づいてポリシーの UI json が生成されます。これにより、これまで手動で行っていた ​config.json​ スキーマファイルの作成が不要になります。

スキーマの定義については、ポリシースキーマ定義の作成を参照してください。​template.xml​ ファイルで参照するスキーマにすべてのパラメーターを含めます。

Mule ゲートウェイカスタムポリシーでは、Dataweave 形式はサポートされますが、DataWeave バインドはサポートされません。詳細は、​「DataWeave 式」​を参照してください。

ポリシーロジックを定義する

template.xml​ ファイルのポリシーロジックを定義します。

デフォルトでは、​template.xml​ ファイルには、返される HTTP 応答ペイロードを「Hello World!」メッセージに設定する基本的なポリシーのロジックが含まれます。ファイルを表示してロジックを確認します。

その他のポリシーロジックの例については、以下を参照してください。

ポリシーをパブリッシュおよびリリースする

PDK では、Mule ゲートウェイと Flex Gateway のポリシーは同じ方法でパブリッシュされます。

ポリシーをパブリッシュおよびリリースするには、Publishing Unified-Model Policies to Exchangeを参照してください。