1. Homepage
  2. Flex Gateway ポリシー開発キット (PDK) (1.3)

  3. Flex Gateway ポリシー開発キット (PDK) の前提条件 (1.3)

Flex Gateway ポリシー開発キット (PDK) の前提条件

Flex Gateway ポリシー開発キット (PDK) の使用を開始する前に、以下の前提条件を確認します。

Flex Gateway

PDK のチュートリアルでは、​Flex Gateway がダウンロード済み​で、製品に関する予備知識があることを前提としています。

Policies created with PDK might be compatible with Flex Gateway versions that aren’t compatible with PDK’s integration testing framework. The Flex Gateway version used for testing doesn’t affect the functionality of the policy when deployed to a different Flex Gateway version. See the following table to ensure your Flex Gateway’s compatibility:

Component Minimum Flex Gateway Version Maximum Flex Gateway Version

Policies

1.6.1

Latest

Testing Framework

1.6.1

Latest

PDK を使用するための Rust の要件

  1. Git

    ダウンロードとインストールの方法は、 「Installing Git (Git のインストール)」​を参照してください。

  2. Rust プログラミング言語バージョン v1.74.0 ～ v1.83.0:

    1. Rust をインストールまたは更新するには、次の curl コマンドを実行します。

      curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
      curl がインストールされていない場合は、 「Install curl (curl のインストール)」​を参照してください。

    2. PDK で使用される ​wasm32-wasi​ コンパイルターゲットは Rust v1.84.0 で非推奨になるため、Rust を最新の互換性のある最新バージョンにダウングレードします。

      rustup default 1.83.0

  3. Rust WebAssembly システムインターフェース (WASI) クレート

    Rust WASI をインストールまたは更新するには、次のコマンドを実行します。

    rustup target add wasm32-wasi

  4. Cargo Generate

    Cargo Generate をインストールまたは更新するには、次のコマンドを実行します。

    cargo install --locked cargo-generate@0.22.0

サポートされているオペレーティングシステム

  • macOS

  • Ubuntu

    Ubuntu を使用するには、​PDK を使用するための Rust の要件​ をインストールした後で、以下のコマンドを使用して必要なパッケージをインストールします。

    sudo apt install -y build-essential
sudo apt install -y pkg-config
sudo apt install -y libssl-dev

  • Windows

    PDK では、カスタムポリシーの開発とテストでのみ Windows をサポートしています。ただし、Flex Gateway は本番環境では Windows をサポートしていません。

    PDK で提供されている ​make​ コマンドを実行するには、以下をインストールします。

    1. Windows の PowerShell

    2. 次のいずれかの Make:

Anypoint CLI

PDK 用の Anypoint CLI を設定する手順は、次のとおりです。

  1. Anypoint CLI 4.x v1.4.4 以降をインストールします​。

    自分の Anypoint CLI 4.x バージョンを確認するには、​「Verify the Core Package Version (コアパッケージバージョンを確認する)」​を参照してください。

  2. 接続アプリケーション​を使用して、​Anypoint Platform CLI に対して認証します​。

    接続アプリケーションで認証を行うには、アプリケーションのクライアント ID とクライアントシークレットを提供します。

    Anypoint Platform に対する認証では、​[View Organization (組織の表示)]​ および ​[View Environment (環境の表示)]​ スコープに加えて、Exchange へのカスタムポリシーのアップロードを完了するために、接続アプリケーションに ​[Exchange Contributor (Exchange コントリビュータ)]​ スコープを適用しておく必要があります。

  3. Anypoint CLI PDK プラグインをインストールまたは更新するには、次のコマンドを実行します。

    anypoint-cli-v4 plugins:install anypoint-cli-pdk-plugin

Docker

Docker は、PDK で用意されている​ローカルデバッグ環境​と​インテグレーションテストフレームワーク​を使用するために必要です。Docker がなくてもポリシーのビルドとパブリッシュは可能です。

Docker をインストールするには、 「Install Docker (Docker のインストール)」​を参照してください。

ポリシーの開発とテストのみが目的であれば、Windows の Docker で Flex Gateway をローカルモードで実行することもできます。ただし、Flex Gateway は本番環境では Windows をサポートしていません。

Visual Studio (推奨 IDE)

PDK は、 Rust in Visual Studio Code プラグイン​がインストールされていれば、 Microsoft Visual Studio​ など、どの IDE やテキストエディターでも使用できます。

関連情報