Flex Gateway新着情報
Governance新着情報
Monitoring API Manager
このバージョンの Mule は、拡張サポートが終了する 2023 年 5 月 2 日にその すべてのサポートが終了しました。 このバージョンの Mule を使用する CloudHub には新しいアプリケーションをデプロイできなくなります。許可されるのはアプリケーションへのインプレース更新のみになります。 標準サポートが適用されている最新バージョンの Mule 4 にアップグレードすることをお勧めします。これにより、最新の修正とセキュリティ機能強化を備えたアプリケーションが実行されます。 |
Mule Maven プラグインバージョン 3.0.0、3.1.0、3.1.1、3.1.2、3.1.3、3.1.4、3.1.5、3.1.6、3.1.7 は非推奨です。 |
Anypoint Studio、Anypoint Runtime Manager、または Anypoint Platform CLI を使用してアプリケーションをオンプレミスでデプロイすることに加えて、Mule Maven プラグインを使用して Mule アプリケーションをデプロイすることもできます。これを行うには、特定の前提条件を満たし、目的のデプロイメント戦略をプロジェクトの pom.xml
ファイルで定義する必要があります。
Mule Maven プラグインを使用してアプリケーションをオンプレミスにデプロイする場合、3 つの異なるデプロイメント方法を選択できます。
スタンドアロンデプロイメント
この方法を使用して、オンプレミス Mule インスタンスに Mule アプリケーションを手動でデプロイします。
Runtime Manager REST API デプロイメント
この方法を使用すると、Runtime Manager REST API を使用してアプリケーションをデプロイできます。これにより、オンプレミス Mule インスタンスが Anypoint Runtime Manager アカウントにリンクされ、デプロイしたアプリケーションをさらに管理および監視できます。
Runtime Manager エージェントデプロイメント
この方法を使用すると、Runtime Manager エージェントを使用してアプリケーションをデプロイできます。これにより、ローカル API が公開され、その API をコールして、デプロイしたアプリケーションを管理および監視できます。
スタンドアロンデプロイメント戦略または Runtime Manager エージェントデプロイメント戦略を使用する場合、Mule Maven プラグインはドメインのデプロイもサポートします。
追加の操作により、複数のアプリケーションを並列にデプロイしたり、実行時にアプリケーションを更新したりできます。
Mule Maven プラグインをプロジェクトに追加する
手順については、「Mule Maven プラグインを Mule プロジェクトに追加する」を参照してください。
plugin
要素内にスタンドアロンデプロイメント用の設定を追加し、プレースホルダーの値をローカルの Mule Runtime Engine 情報で置き換えます。
<plugin>
Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::example$mmp-concept-config.xml[]
<configuration>
<standaloneDeployment>
<muleHome>${mule.home.test}</muleHome>
<muleVersion>${app.runtime}</muleVersion>
</standaloneDeployment>
</configuration>
</plugin>
プロジェクトのフォルダーのコマンドラインから、アプリケーションをパッケージ化してデプロイゴールを実行します。
mvn clean package deploy -DmuleDeploy
パラメーター | 説明 | 必須 |
---|---|---|
|
最上位要素。 |
はい Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] |
|
ローカルマシンで実行する Mule インスタンスのリリースバージョン。 |
はい |
|
ローカルマシンにおける Mule インスタンスの場所。 |
はい Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] |
Mule Maven プラグインを使用すると、Runtime Manager REST API を使用してローカルの Mule インスタンスに Mule アプリケーションをデプロイできます。
Runtime Manager で作成されたサーバー、サーバーグループ、またはクラスターが必要です。
サーバーを作成するには、「サーバーの追加」を参照してください。
サーバーグループを作成するには、「サーバーグループの作成」を参照してください。
クラスターを作成するには、「クラスターの作成」を参照してください。
plugin
要素内に Runtime Manager デプロイメント用の設定を追加し、プレースホルダーの値を Runtime Manager 情報で置き換えます。
<plugin>
Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::example$mmp-concept-config.xml[]
<configuration>
<armDeployment>
<muleVersion>${app.runtime}</muleVersion>
<uri>https://anypoint.mulesoft.com</uri>
<target>${target}</target>
<targetType>${target.type}</targetType>
<username>${username}</username>
<password>${password}</password>
<environment>${environment}</environment>
<properties>
<key>value</key>
</properties>
</armDeployment>
</configuration>
</plugin>
プロジェクトのフォルダーのコマンドラインから、アプリケーションをパッケージ化してデプロイゴールを実行します。
mvn clean package deploy -DmuleDeploy
Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[]
Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[]
設定パラメーターの詳細は、「Runtime Manager REST API デプロイメントのパラメーターリファレンス」を参照してください。
パラメーター | 説明 | 必須 |
---|---|---|
|
最上位要素。 |
はい Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] |
|
アプリケーションをデプロイメント対象で実行するために必要な Mule Runtime Engine のバージョン。 |
はい |
|
Anypoint Platform URI。Anypoint Platform PCE を使用している場合、Anypoint Platform インストールの URI を使用してこのパラメーターを指定します。 |
いいえ |
|
Mule インスタンスをインストールするサーバーのサーバー名。 |
はい |
|
デプロイ先の対象の種別。 有効な値:
|
はい |
|
Mule インスタンスをインストールするサーバーのユーザー名。 |
Anypoint Platform ログイン情報を使用してログインする場合のみ。 |
|
Mule インスタンスをインストールするサーバーのパスワード。 |
Anypoint Platform ログイン情報を使用してログインする場合のみ。 |
|
Mule インスタンスをインストールするサーバーの環境名。この値は、Runtime Manager アカウントで設定されたいずれかの環境に一致する必要があります。
|
はい Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] |
Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[]
+
<plugin>
...
<configuration>
...
<armDeployment>
...
<server>my.anypoint.credentials</server>
...
</armDeployment>
...
</configuration>
...
<plugin>
+ NOTE: ユーザー名とパスワードがデプロイメント設定で設定されていると、定義されたサーバー ID が上書きされるため、設定されていないことを確認してください。
Anypoint Platform Private Cloud Edition インストールの Runtime Manager のインスタンスに接続しようとすると、プラグインはそのサーバーのログイン情報を検証します。トラストストアにサーバーログイン情報をインストールしていない場合、SSL エラーが発生します。この問題を回避するために、非セキュアモードでプラグインを実行できます。このモードでは、セキュリティ検証がスキップされます。armInsecure タグまたは arm.insecure システムプロパティを使用できます。
非セキュア接続を有効にするのは危険です。実行内容を理解し、オンプレミスインストールがローカルネットワークに隔離されている場合を除き、使用しないでください。 |
下の設定例を参照してください。
<plugin>
Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::example$mmp-concept-config.xml[]
<configuration>
<armDeployment>
<target>${target}</target>
<targetType>${target.type}</targetType>
<username>${username}</username>
<password>${password}</password>
<environment>${environment}</environment>
<armInsecure>true</armInsecure>
</armDeployment>
</configuration>
</plugin>
plugin
要素内に Runtime Manager エージェントデプロイメント用の設定を追加し、URI の値をリモートサーバー情報で置き換えます。
<plugin>
Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::example$mmp-concept-config.xml[]
<configuration>
<agentDeployment>
<uri>http://localhost:9999/</uri>
</agentDeployment>
</configuration>
</plugin>
プロジェクトのフォルダーのコマンドラインから、アプリケーションをパッケージ化してデプロイゴールを実行します。
mvn clean package deploy -DmuleDeploy
パラメーター | 説明 | 必須 |
---|---|---|
|
最上位要素。 |
はい Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] |
|
アプリケーションをデプロイメント対象で実行するために必要な Mule Runtime Engine のバージョン。 |
はい |
|
Mule インスタンスをインストールするサーバーの URI。 |
はい Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::partial$mmp-concept.adoc[] |
スタンドアロンデプロイメント戦略または Runtime Manager エージェントデプロイメント戦略を使用する場合のみ、Mule Maven プラグインはドメインのデプロイをサポートします。
ドメインをデプロイするには、アプリケーションのデプロイ時に使用するものと同じ設定とデプロイメント手順を使用します。たとえば、スタンドアロンインスタンスにドメインをデプロイするには、次の手順を実行します。
plugin
要素内にスタンドアロンデプロイメント用の設定を追加し、プレースホルダーの値をローカルの Mule Runtime Engine 情報で置き換えます。
<plugin>
Unresolved include directive in modules/ROOT/pages/deploy-on-premises.adoc - include::mule-runtime::example$mmp-concept-config.xml[]
<configuration>
<standaloneDeployment>
<muleHome>${mule.home.test}</muleHome>
<muleVersion>${app.runtime}</muleVersion>
</standaloneDeployment>
</configuration>
</plugin>
プロジェクトのフォルダーのコマンドラインから、ドメインをパッケージ化してデプロイゴールを実行します。
mvn clean package deploy -DmuleDeploy
オンプレミス Mule インスタンスに複数のアプリケーションを並列にデプロイできます。多数のアプリケーションをデプロイする場合は、並列にデプロイすると起動時間を短縮できます。起動順序は不特定であるため、デプロイメントが失敗しないように、アプリケーションが相互連動していないことを確認します。
並列デプロイを有効にする手順は次のとおりです。
Mule アプリケーションを Mule Runtime Engine インスタンスの /apps
ディレクトリにパッケージ (エクスポート) します。
-M-Dmule.deployment.parallel
オプションを使用して Mule を起動します。
mule -M-Dmule.deployment.parallel
これらの手順を実行すると、Mule は /apps
ディレクトリにあるすべてのアプリケーションを並列にデプロイします。
実行時の Mule アプリケーションの更新は、クラスの変更、エンドポイントの変更 (ポートの変更など)、フローの再設定を伴う複雑な変更になる場合があります。アプリケーションの更新では、最初にアプリケーションを適切にシャットダウンしてから、数秒以内にバックグラウンドでアプリケーションを再設定します。このプロセスは、ユーザーに対して透過的に行われます。
アプリケーションは、2 つの方法で更新できます。
展開された既存のアプリケーションフォルダーに変更を追加して、メイン設定ファイル (デフォルトではアプリケーションルートディレクトリにある mule-config.xml
) を操作する。
更新されたバージョンのアプリケーションを含む新しい jar
を $MULE_HOME/apps
ディレクトリに追加する。Mule は、jar
を既存アプリケーションの更新バージョンとして検出し、アプリケーションのクリーンな再デプロイを実行します。
Mule は、古いアプリケーションフォルダーへの変更を破棄します。新しいアプリケーションフォルダーは、jar
から展開されたクリーンなアプリケーションフォルダーです。
どちらの方法も、既存のビルドツールと適切に統合されます。