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

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

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

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

前提条件

CloudHub 2.0 デプロイメント戦略の設定

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

<plugin>
Unresolved include directive in modules/ROOT/pages/_partials/mmp-deploy-to-cloudhub-2.adoc - include::mule-runtime::example$mmp-concept-config.xml[]
  <configuration>
    <cloudhub2Deployment>
      <uri>https://anypoint.mulesoft.com</uri>
      <provider>MC</provider>
      <environment>${environment}</environment>
      <target>${targetName}</target>
      <muleVersion>${muleVersion}</muleVersion>
      <username>${user}</username>
      <password>${pass}</password>
      <applicationName>${appName}</applicationName>
      <replicas>1</replicas>
      <vCores>1</vCores>
      <deploymentSettings>
        <http>
          <inbound>
            <publicUrl>${publicURL}</publicUrl>
            <forwardSslSession>true</forwardSslSession>
            <lastMileSecurity>true</lastMileSecurity>
          </inbound>
        </http>
      </deploymentSettings>
    </cloudhub2Deployment>
  </configuration>
</plugin>
xml

CloudHub 2.0 へのデプロイ

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

mvn clean deploy -DmuleDeploy
bash

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

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

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

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

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

CloudHub 2.0 への再デプロイ

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

Authentication のメソッド

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

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

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

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

パラメーター 説明 必須

cloudhub2Deployment

最上位要素

はい

uri

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

いいえ

muleVersion

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

はい

username

Anypoint Platform ユーザー名

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

password

Anypoint Platform パスワード

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

applicationName

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

はい

scopeLoggingConfigurations

scopeLoggingConfiguration

scope

使用するログライブラリのパッケージ。

logLevel

ログレベル。使用可能な値: INFO​、​DEBUG​、​WARN​、​ERROR​、​FATAL​。

設定例:

<scopeLoggingConfigurations>
  <scopeLoggingConfiguration>
    <scope>com.pkg.warning</scope>
    <logLevel>WARN</logLevel>
  </scopeLoggingConfiguration>
  <scopeLoggingConfiguration>
    <scope>com.pkg.debug</scope>
    <logLevel>DEBUG</logLevel>
  </scopeLoggingConfiguration>
</scopeLoggingConfigurations>
xml

いいえ

target

アプリケーションをデプロイする CloudHub 2.0 対象名。
CloudHub 2.0 のデプロイメント対象値で使用できる共有スペースまたは非公開スペースのいずれかを指定します。共有スペースまたは非公開スペースについての詳細は、​「CloudHub 2.0 の機能」​を参照してください。​「リージョンのリスト」​の対象名値を使用します。例: Cloudhub-US-East-1​。

はい

provider

CloudHub 2.0 では ​MC​ に設定。

はい

environment

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

<environment>Sandbox</environment>
xml

はい

replicas

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

はい

vCores

vCores で指定されている各レプリカのサイズ。使用可能な値: 0.1​、​0.2​、​0.5​、​1​、​1.5​、​2​、​2.5​、​3​、​3.5​、​4​。 使用可能な vCore サイズと割り当てられるハードウェアリソースの詳細は、​「CloudHub 2.0 レプリカ」​を参照してください。

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

deploymentSettings

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

いいえ

integrations

services

objectStoreV2

enabled

true​ の場合、Object Store v2 を使用するようにデプロイメントに指示します。

設定例:

<integrations>
  <services>
    <objectStoreV2>
      <enabled>true</enabled>
    </objectStoreV2>
  </services>
</integrations>
xml

いいえ

pathRewrite

アプリケーションの HTTP リスナーで要求されるベースパスを提供します。この値は ​/​ で始まる必要があります。このパラメーターは、​『非公開スペース』​にデプロイされたアプリケーションでのみ使用されます。

いいえ

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

パラメーター 説明

enforceDeployingReplicasAcrossNodes

異なるノード間でレプリカのデプロイメントを適用します。デフォルト値は ​false​ です。
可用性を高めるには、この値を ​true​ に設定します。

設定例:

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

updateStrategy

使用可能な値 説明

rolling

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

recreate

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

デフォルト値は ​rolling​ です。

設定例:

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

clustered

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

設定例:

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

http

inbound

publicURL

デプロイされるアプリケーションの URL。複数のカンマ区切り値を追加できます。

lastMileSecurity

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

forwardSslSession

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

設定例:

<deploymentSettings>
  <http>
    <inbound>
      <publicUrl>https://myapp.anypoint.com</publicUrl>
      <lastMileSecurity>true</lastMileSecurity>
      <forwardSslSession>true</forwardSslSession>
    </inbound>
  </http>
</deploymentSettings>
xml

generateDefaultPublicUrl

true​ に設定されている場合、CloudHub 2.0 は、デプロイ済みアプリケーションの公開 URL を生成します。
このパラメーターは、​『非公開スペース』​にデプロイされたアプリケーションでのみ使用されます。​『共有スペース』​にデプロイされたアプリケーションでは常に生成された公開 URL が使用されます。

ログイン情報の暗号化

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

+

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

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