Mule Maven プラグインを使用した Runtime Fabric へのアプリケーションのデプロイ

Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[]

可能な場合は、Equality の会社の値に一致するように、含めない用語を変更しました。顧客の実装に対する影響を回避するために、一部の用語は変更されていません。

Anypoint Runtime Manager を使用してアプリケーションを Anypoint Runtime Fabric にデプロイすることに加えて、Mule Maven プラグインを使用してアプリケーションをデプロイすることもできます。これを行うには、特定の前提条件を満たし、Runtime Fabric デプロイメント戦略をプロジェクトの pom.xml ファイルで定義する必要があります。

別の方法を使用して Runtime Fabric にアプリケーションをデプロイする場合は、以下を参照してください。

Runtime Manager を使用した Runtime Fabric へのアプリケーションのデプロイ

前提条件

Mule Maven プラグインがプロジェクトに追加されていることを確認する

手順については、「Mule Maven プラグインを Mule プロジェクトに追加する」を参照してください。
Runtime Fabric へのデプロイに必要なリソースの数を理解し、使用できる
詳細は、『Allocating Resources for Application Deployment on Runtime Fabric』を参照してください。
アプリケーションが Exchange ですでにパブリッシュされている
「Maven を使用した Exchange アセットのパブリッシュとデプロイ」を参照してください。

Runtime Fabric デプロイメント戦略の設定

plugin 要素内に Runtime Fabric デプロイメント用の設定を追加し、次のプレースホルダーの値を Runtime Fabric 情報で置き換えます。

<plugin>
Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::example$mmp-concept-config.xml[]
  <configuration>
    <runtimeFabricDeployment>
      <uri>https://anypoint.mulesoft.com</uri>
      <muleVersion>4.3.0</muleVersion>
      <username>user</username>
      <password>pass</password>
      <applicationName>newapp</applicationName>
      <target>rtf</target>
      <environment>Sandbox</environment>
      <provider>MC</provider>
      <replicas>1</replicas>
      <properties>
        <key>value</key>
      </properties>
      <deploymentSettings>
        <enforceDeployingReplicasAcrossNodes>false</enforceDeployingReplicasAcrossNodes>
        <updateStrategy>recreate</updateStrategy>
        <clustered>false</clustered>
        <forwardSslSession>false</forwardSslSession>
        <lastMileSecurity>false</lastMileSecurity>
        <resources>
          <cpu>
            <reserved>20m</reserved>
            <limit>1500m</limit>
          </cpu>
          <memory>
            <reserved>700Mi</reserved>
          </memory>
        </resources>
        <http>
          <inbound>
            <publicUrl>url</publicUrl>
          </inbound>
        </http>
      </deploymentSettings>
    </runtimeFabricDeployment>
  </configuration>
</plugin>xml
コンテンツを展開する

Runtime Fabric へのデプロイ

プロジェクトのフォルダーのコマンドラインから、アプリケーションをパッケージ化してデプロイゴールを実行します。

mvn clean package deploy -DmuleDeploybash

Exchange のスナップショットアセット

Exchange のスナップショットアセットを Runtime Fabric にデプロイすることもできます。

開発フェーズとテストフェーズで Anypoint Exchange の SNAPSHOT バージョンアセットを使用して、些細な変更でアプリケーションのバージョン番号を増分することを回避できます。SNAPSHOT バージョンのアプリケーションが Anypoint Exchange で上書きされたら、Mule Maven プラグインを使用して SNAPSHOT バージョンのアプリケーションを Runtime Fabric に再デプロイし、最新の変更をデプロイできます。

スナップショットアセットを Anypoint Exchange にパブリッシュする方法についての詳細は、「アセットライフサイクル状態」を参照してください。

アプリケーションのスナップショットを更新するたびに、アプリケーションを再デプロイして最新のスナップショットバイナリで更新します。スナップショットアセットはデプロイ後に変更される可能性があるため、本番環境にはデプロイしないでください。

Runtime Fabric への再デプロイ

アプリケーションを再デプロイするには、デプロイしたときと同じコマンドを実行します。
Runtime Fabric は、デプロイしたアプリケーションを書き込み直します。

Authentication のメソッド

Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[]

設定パラメーターの詳細は、Runtime Fabric デプロイメントのパラメーターリファレンスを参照してください。

Runtime Fabric デプロイメントのパラメーターリファレンス

パラメーター説明必須

パラメーター	説明	必須
`runtimeFabricDeployment`	最上位要素	はい
`uri`	Anypoint Platform URI。設定しない場合、デフォルトの https://anypoint.mulesoft.com になります。	いいえ
`muleVersion`	Runtime Fabric インスタンスで実行する Mule Runtime Engine のバージョン。この値がアプリケーションで最小限必要な Mule バージョン以上であることを確認します。値の例: `4.3.0`、`4.2.2-hf4`	はい
`username`	Anypoint Platform ユーザー名	Anypoint Platform ログイン情報を使用してログインする場合のみ。
`password`	Anypoint Platform パスワード	Anypoint Platform ログイン情報を使用してログインする場合のみ。
`applicationName`	アプリケーションのデプロイ後に Runtime Manager に表示されるアプリケーション名。	はい
`target`	アプリケーションをデプロイする Runtime Fabric 対象名。	はい
`provider`	Runtime Fabric では `MC` に設定。	はい
`environment`	対象の Anypoint Platform 環境。この値は、次のように Anypoint Platform アカウントで設定された環境に一致する必要があります。 `<environment>Sandbox</environment>` xml	はい
`replicas`	デプロイする Mule アプリケーションのレプリカまたはインスタンスの数を指定します。アプリケーションあたりのレプリカの最大数は 8 です。	はい Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[]
`deploymentSettings`	deploymentSettings リファレンスで説明されているいずれかのパラメーター	いいえ

runtimeFabricDeployment

最上位要素

はい

uri

Anypoint Platform URI。
設定しない場合、デフォルトの https://anypoint.mulesoft.com になります。

いいえ

muleVersion

Runtime Fabric インスタンスで実行する Mule Runtime Engine のバージョン。
この値がアプリケーションで最小限必要な Mule バージョン以上であることを確認します。
値の例: 4.3.0、4.2.2-hf4

はい

username

Anypoint Platform ユーザー名

Anypoint Platform ログイン情報を使用してログインする場合のみ。

password

Anypoint Platform パスワード

Anypoint Platform ログイン情報を使用してログインする場合のみ。

applicationName

アプリケーションのデプロイ後に Runtime Manager に表示されるアプリケーション名。

はい

target

アプリケーションをデプロイする Runtime Fabric 対象名。

はい

provider

Runtime Fabric では MC に設定。

はい

environment

対象の Anypoint Platform 環境。
この値は、次のように Anypoint Platform アカウントで設定された環境に一致する必要があります。

<environment>Sandbox</environment>xml

はい

replicas

デプロイする Mule アプリケーションのレプリカまたはインスタンスの数を指定します。アプリケーションあたりのレプリカの最大数は 8 です。

はい Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[] Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[]

deploymentSettings

deploymentSettings リファレンスで説明されているいずれかのパラメーター

いいえ

deploymentSettings パラメーターリファレンス

パラメーター説明

enforceDeployingReplicasAcrossNodes

異なるノード間でレプリカのデプロイメントを適用します。デフォルト値は false です。

設定例:

<deploymentSettings>
  <enforceDeployingReplicasAcrossNodes>false</enforceDeployingReplicasAcrossNodes>
</deploymentSettings>xml

updateStrategy

使用可能な値説明

rolling

レプリカを増分的に更新することで、可用性を維持します。成功するには、レプリカに相当する 1 つの追加リソースが必要です。
enforceDeployingReplicasAcrossNodes が有効になっている場合、設定できるレプリカの最大数はノードの総数より 1 つ少なくなります。

recreate

再デプロイメントの前にレプリカを終了します。再デプロイメントは rolling よりも迅速で、追加リソースは必要ありません。
enforceDeployingReplicasAcrossNodes が有効になっている場合、設定できるレプリカの最大数はノードの数と同じです。

デフォルト値は rolling です。

設定例:

<deploymentSettings>
  <updateStrategy>recreate</updateStrategy>
</deploymentSettings>xml

forwardSslSession

セッション中に SSL 転送を有効にします。デフォルト値は false です。

設定例:

<deploymentSettings>
  <forwardSslSession>true</forwardSslSession>
</deploymentSettings>xml

clustered

アプリケーションの複数のレプリカでのクラスタリングを有効にします。デフォルト値は false です。

設定例:

<deploymentSettings>
    <clustered>true</clustered>
</deploymentSettings>xml

lastMileSecurity

Last-Mile セキュリティを有効化して、このアプリケーションによって復号化される HTTPS 接続を転送します。
このためには SSL 証明書を Mule アプリケーションに含む必要があり、より多くの CPU リソースも必要です。デフォルト値は false です。
設定例:

<deploymentSettings>
    <lastMileSecurity>true</lastMileSecurity>
</deploymentSettings>xml

resources

cpu

reserved

アプリケーションの各レプリカに割り当てるコア数を指定します。デフォルト値は 0.5 vCore です。

limit

アプリケーションの各レプリカに割り当てる最大コア数を指定します。
reserved 設定が存在する場合、この値がそれ以上であることを確認してください。

memory

reserved

アプリケーションの各レプリカに割り当てるメモリ量を指定します。デフォルト値は 700 MB です。

limit

アプリケーションレプリカごとに割り当てる最大メモリを指定します。reserved 設定が存在する場合、この値がそれ以上であることを確認してください。

設定例:

<deploymentSettings>
  <resources>
    <cpu>
      <reserved>20m</reserved>
      <limit>1500m</limit>
    </cpu>
    <memory>
      <reserved>700Mi</reserved>
    </memory>
  </resources>
</deploymentSettings>xml

http

inbound

publicURL

デプロイされるアプリケーションの URL。

設定例:

<deploymentSettings>
  <http>
    <inbound>
      <publicUrl>myapp.anypoint.com</publicUrl>
    </inbound>
  </http>
</deploymentSettings>xml

disableAmLogForwarding

Anypoint Monitoring へのアプリケーションレベルログの転送を無効にします。デフォルトでは、これは false に設定されます。

ログイン情報の暗号化

Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-rtf.adoc - include::mule-runtime::partial$mmp-concept.adoc[]

<plugin>
  ...
  <configuration>
    ...
    <runtimeFabricDeployment>
      ...
      <server>my.anypoint.credentials</server>
      ...
    </runtimeFabricDeployment>
    ...
  </configuration>
  ...
<plugin>xml

+ NOTE: ユーザー名とパスワードがデプロイメント設定で設定されていると、定義されたサーバー ID が上書きされるため、設定されていないことを確認してください。

Mule Maven プラグインを使用した Runtime Fabric へのアプリケーションのデプロイ

前提条件

Runtime Fabric デプロイメント戦略の設定

Runtime Fabric へのデプロイ

Exchange のスナップショットアセット

Runtime Fabric への再デプロイ

Authentication のメソッド

Runtime Fabric デプロイメントのパラメーターリファレンス

deploymentSettings パラメーターリファレンス

ログイン情報の暗号化

関連情報