Flex Gateway新着情報
Governance新着情報
Monitoring API ManagerAPI プロキシを CloudHub、Runtime Fabric、またはハイブリッドクラウド環境にデプロイできます。プロキシアプリケーションに割り当てられるリソースは、使用しているプロキシの種別によって異なります。たとえば、CloudHub プロキシには、デフォルトで 0.1 vCore の CPU と 500 MB のメモリが含まれています。
必要に応じて、Runtime Manager からリソースの割り当てを変更します。
Runtime Fabric またはハイブリッドクラウド環境で作業する場合は、API プロキシをデプロイする前に、次の要件を満たしてください。
Runtime Fabric
アカウントで「Manage APIs Configuratio (API 設定の管理)」および「Deploy API Proxies (API プロキシのデプロイ)」権限を取得する。
Mule バージョン 3.8.7、3.9.1, 4.1.2、またはそれ以降を使用する。
Hybrid:
非公開サーバーの場合、組織用に設定された Mule Runtime Engine (Mule) インスタンスへのアクセス権を取得する。
Mule インスタンスをサーバーとして設定する方法についての詳細は、「Runtime Manager へのサーバーの追加」を参照してください。
Mule インスタンスと互換性のある Mule エージェントを使用して非公開サーバーを登録する。
Mule バージョン 3.8 以降の場合は、Mule エージェント 1.9.0 を使用します。Mule 4.x の場合はリリースノートで指定された Mule Agent を使用します。
プロキシをデプロイするには、以下の手順を完了します。
[Anypoint Platform] > [API Manager] に移動します。
[API Administration (API 管理)] で、[Add API (API を追加)] をクリックし、[Add new API (新しい API を追加)] をクリックします。
ランタイムとして [Mule Gateway (Mule ゲートウェイ)] を選択します。
[Proxy type (プロキシ種別)] で [Deploy a proxy application (プロキシアプリケーションをデプロイ)] を選択します。
プロキシアプリケーションのデプロイを選択した場合は、以下のオプションから対象種別を選択します。
CloudHub 2.0: コンテナベースのクラウドインフラストラクチャで MuleSoft によってホストされている Mule Runtime を使用する場合は、このオプションを選択します。CloudHub 2.0 プロキシには、デフォルトで 0.1 vCore の CPU が含まれています。
CloudHub: MuleSoft によってクラウドでホストされている Mule Runtime を使用する場合は、このオプションを選択します。CloudHub プロキシには、デフォルトで 0.1 vCore の CPU と 500 MB のメモリが含まれています。
[Runtime Version (ランタイムバージョン)] で、次の操作を実行します。
[Runtime Channel (ランタイムチャネル)] を選択します。
Mule Runtime の [Version (バージョン)] を選択します。
[Java version (Java バージョン)] を選択します。
[Proxy app name (プロキシアプリケーション名)] を入力します。
Hybrid (ハイブリッド): Runtime Manager に登録されているオンプレミスサーバーで実行される Mule Runtime インスタンスを使用する場合、このオプションを選択します。
詳細は、「Runtime Manager でのサーバーの登録」を参照してください。
リストから接続先を選択するか、[Add server (サーバーを追加)] をクリックします。
[Proxy app name (プロキシアプリケーション名)] を入力します。
Self-managed Server (自己管理型サーバー): JAR ファイルを作成して、Runtime Manager に登録されていないオンプレミスサーバーで実行される Mule Runtime インスタンスに API プロキシをデプロイする場合、このオプションを選択します。詳細は、On-Premises Deployment Modelを参照してください。
API Manager で API プロキシを自己管理型サーバーにデプロイしても、プロキシはオンプレミスサーバーにデプロイされません。API Manager でプロキシをデプロイした後に、プロキシをオンプレミスサーバーにデプロイします。 . 新しい API プロキシ JAR ファイルをダウンロードします。 . JAR ファイルをオンプレミスサーバーにデプロイします。
Runtime Fabric: Runtime Fabric で管理された Mule Runtime Engine に API プロキシをデプロイする場合、[Runtime Fabric] を選択します。 詳細は、「Runtime Fabric への API プロキシのデプロイ」を参照してください。
リストから対象を選択します。
[Runtime Version (ランタイムバージョン)] で、次の操作を実行します。
[Runtime Channel (ランタイムチャネル)] を選択します。
Mule Runtime の [Version (バージョン)] を選択します。
[Java version (Java バージョン)] を選択します。
[Proxy app name (プロキシアプリケーション名)] を入力します。
以下のオプションから API を選択します。
管理する API を Exchange を介して共有している場合、[Select API from Exchange (Exchange から API を選択)] をクリックします。
[Select API (API を選択)] の下のリストから API をクリックします。必要に応じて、特定の API を検索できます。
最新バージョンを使用していない場合は、[Asset type (アセットタイプ)]、[API version (API バージョン)]、および [Asset version (アセットバージョン)] を更新します。
Exchange でのバージョンについての詳細は、アセットバージョンを参照してください。
[RAML/OAS] アセットタイプを選択した場合は、API の [Conformance Status (準拠状況)] を表示して、API が準拠していることを確認します。[Conformance Status (準拠状況)] が非準拠の場合、デプロイ後にガバナンスレポートを表示して、準拠の問題を見つけて修正します。ガバナンスレポートについての詳細は、API インスタンスの管理を参照してください。
[Create new API (新しい API を作成)] をクリックします。
新しい API アセットの名前を入力します。
以下のオプションからアセットタイプを選択します。
REST API: アセットに含める RAML または OAS API 定義ファイルがある場合は、このオプションを選択します。
REST API の RAML または OAS ファイルをアップロードします。バージョン 2.0.0 以降ではネイティブ OAS サポートが追加されるので、OAS または RAML 仕様に推奨されるバージョンです。OAS API 仕様を API プロキシバージョン 1.0 以前にアップロードすると、API 仕様は RAML に変換されます。
HTTP API: アセットに含める API 定義ファイルがない場合は、このオプションを選択します。
SOAP API: WSDL API 定義ファイルまたはファイルへの外部リンクがある場合は、このオプションを選択します。
SOAP API の WSDL ファイルをアップロードするか、ファイルへのリンクを追加します。
このオプションは、現時点では Flex Gateway ランタイムでは使用できません。
最新バージョンを使用していない場合は、[Asset type (アセットタイプ)]、[API version (API バージョン)]、および [Asset version (アセットバージョン)] を更新します。
Exchange でのバージョンについての詳細は、アセットバージョンを参照してください。
[RAML/OAS] アセットタイプを選択した場合は、API の [Conformance Status (準拠状況)] を表示して、API が準拠していることを確認します。[Conformance Status (準拠状況)] が非準拠の場合、デプロイ後にガバナンスレポートを表示して、準拠の問題を見つけて修正します。ガバナンスレポートについての詳細は、API インスタンスの管理を参照してください。
[Next (次へ)] をクリックします。
ダウンストリーム設定を定義します。
| 項目名 | 説明 | 必須 | 注意事項 | 
|---|---|---|---|
Protocol (プロトコル)  | 
検証に HTTP と HTTPS のどちらを使用するかを指定します。  | 
はい  | 
HTTPS を選択する場合、インバウンドトラフィックの TLS コンテキストを指定します。  | 
Inbound TLS (インバウンド TLS)  | 
インバウンドトラフィックを保護するための TLS コンテキストを指定します。  | 
いいえ  | 
Mule 4 以降でのみ使用できます。コンテキストを表示できない場合は、適切な権限があることを確認してください。Mule 3 環境で HTTPS を有効にするには、「Mule 3x での HTTPS の有効化」を参照してください。  | 
Port (ポート)  | 
表示されたポートが正しくない場合に使用する番号を指定します。  | 
はい  | 
|
Base Path (ベースパス)  | 
ホストルートに相対的なすべての API パスの URL プレフィックスを指定します。スラッシュ   | 
はい  | 
|
Instance label (インスタンス表示ラベル)  | 
API の表示ラベルを指定します。  | 
いいえ  | 
同じ API の複数の管理インスタンスがある場合、各インスタンスを他のインスタンスと区別するための表示ラベルを追加します。  | 
Advanced Options (詳細オプション)  | 
|||
Consumer endpoint (コンシューマーエンドポイント)  | 
コンシューマーが要求の送信に使用するプロキシアプリケーションのアドレスを指定します。  | 
いいえ  | 
|
Client provider (クライアントプロバイダー)  | 
API のクライアントプロバイダーを指定します。  | 
はい  | 
Anypoint Platform はデフォルトではクライアントプロバイダーとして機能します。外部クライアントプロバイダーを設定するには、「クライアントプロバイダー」を参照してください。  | 
Request Timeout (要求タイムアウト)  | 
要求がタイムアウトするまでの期間を指定します。  | 
いいえ  | 
|
Proxy Version (プロキシバージョン)  | 
エンドポイントに使用するプロキシのバージョンを指定します。  | 
いいえ  | 
|
Service Name (サービス名)  | 
WSDL サービスの名前。  | 
はい  | 
WSDL API でのみ使用できます。  | 
Service Port (サービスポート)  | 
WSDL サービスのポート。  | 
はい  | 
WSDL API でのみ使用できます。  | 
Service Namespace (サービス名前空間)  | 
WSDL サービスの名前空間。  | 
はい  | 
WSDL API でのみ使用できます。  | 
Enable Console (コンソールを有効化)  | 
API 仕様を公開およびテストできるかどうかを指定します。  | 
いいえ  | 
[Console Path (コンソールパス)] に別のパス (  | 
Validations (検証)  | 
提供された仕様に対してインバウンド要求を検証するかどうかを指定します。  | 
いいえ  | 
関連付けられた API 定義がある場合にのみ使用できます。Mule 3 以降でのみ使用できます。  | 
厳格な検証 (省略可能)  | 
クエリパラメーターに対してインバウンド要求を検証するかどうかを指定します。  | 
いいえ  | 
関連付けられた API 定義がある場合にのみ使用できます。Mule 3 以降でのみ使用できます+  | 
User Domain (ユーザードメイン)  | 
API ゲートウェイドメインを使用するかどうかを指定します。  | 
いいえ  | 
設定で以前にプロキシデプロイメント対象として [Hybrid (ハイブリッド)] を選択した場合は、必ずこのオプションを選択してください。Mule 3.8 以降の API ゲートウェイドメインをインストールする必要があります。  | 
[Next (次へ)] をクリックします。
アップストリーム設定を定義します。
| 項目名 | 説明 | 必須 | 注意事項 | 
|---|---|---|---|
Upstream URL (アップストリーム URL)  | 
プロキシまたは API にアクセスするための URL。  | 
はい  | 
たとえば、Exchange の API アセットの URL を使用できます。  | 
Outbound TLS (アウトバウンド TLS)  | 
アウトバウンドトラフィックを保護するための TLS コンテキストを指定します。  | 
いいえ  | 
Mule 4 以降でのみ使用できます。コンテキストを表示できない場合は、適切な権限があることを確認してください。  | 
[Next (次へ)] をクリックします。
選択内容を確認し、必要に応じて編集します。
デプロイする準備ができたら、[Save & Deploy (保存してデプロイ)] をクリックします。または、[Save (保存)] を選択して API インスタンスを保存し、後でデプロイします。