--- schema_version: "1" id: 82c3c7d496ea9e22621f8e65e6409b885b36545d174e61569b461e231f75044c title: Mule Maven プラグインを使用した CloudHub 2.0 へのアプリケーションのデプロイ collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/mule-runtime/4.9/deploy-to-cloudhub-2.md canonical_url: https://docs.mulesoft.com/jp/mule-runtime/4.9/deploy-to-cloudhub-2 source_site: docs.mulesoft.com content_type: documentation content_hash: d5a27f3981aae8d0d1d4dc6a1215f233839589251a94ce46de433dce1d60416a description: MuleSoft Documentation Site release: "4.9" latest: false --- # Mule Maven プラグインを使用した CloudHub 2.0 へのアプリケーションのデプロイ

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、3.8.3 は非推奨です。

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

Anypoint Runtime Manager を使用してアプリケーションを CloudHub2.0 にデプロイすることに加えて、Mule Maven プラグインを使用してアプリケーションをデプロイすることもできます。これを行うには、特定の前提条件を満たし、CloudHub 2.0 デプロイメント戦略をプロジェクトの `pom.xml` ファイルで定義する必要があります。 ## [](#始める前に)始める前に - Mule Maven プラグインがプロジェクトに追加されていることを確認する手順については、[「Mule Maven プラグインを Mule プロジェクトに追加する」](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept#add-mmp)を参照してください。 - アプリケーションが Exchange ですでにパブリッシュされている [「Maven を使用した Exchange アセットのパブリッシュとデプロイ」](https://docs.mulesoft.com/jp/exchange/to-publish-assets-maven)を参照してください。 - Mule Maven Facade API (v3) がプロジェクトの POM ファイルの配布管理セクションにリポジトリとして追加されている。次に例を示します。 ```xml Repository Corporate Repository https://maven.anypoint.mulesoft.com/api/v3/organizations/ORGANIZATION_ID/maven default ``` 詳細は、 [Mule Maven Facade API ドキュメント](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/exchange-maven-facade-api-http/)を参照してください。 ## [](#deploying-to-rtf)CloudHub 2.0 デプロイメント戦略の設定 `plugin` 要素内に CloudHub 2.0 デプロイメント用の設定を追加し、次のプレースホルダーの値を CloudHub 2.0 情報で置き換えます。 ```xml org.mule.tools.maven mule-maven-plugin 3.7.1 true https://anypoint.mulesoft.com MC ${environment} ${targetName} ${muleVersion} ${user} ${pass} ${appName} 1 1 ${publicURL} true true ``` ## [](#cloudhub-2-0-へのデプロイ)CloudHub 2.0 へのデプロイプロジェクトのフォルダーのコマンドラインから、アプリケーションをパッケージ化してデプロイゴールを実行します。 ```bash mvn clean deploy -DmuleDeploy ``` アーティファクトを再ビルドすることなくデプロイするには、次のコマンドを実行します。 ```bash mvn mule:deploy ``` ### [](#exchange-のスナップショットアセット)Exchange のスナップショットアセット Exchange スナップショットアセットを CloudHub 2.0 にデプロイすることもできます。開発フェーズとテストフェーズで Anypoint Exchange の `SNAPSHOT` バージョンアセットを使用して、些細な変更でアプリケーションのバージョン番号を増分することを回避できます。`SNAPSHOT` バージョンのアプリケーションが Anypoint Exchange で上書きされると、Mule Maven プラグインを介して `SNAPSHOT` バージョンのアプリケーションを CloudHub 2.0 に再デプロイすることで、最新の変更をデプロイできます。スナップショットアセットを Anypoint Exchange にパブリッシュする方法についての詳細は、[アセットライフサイクル状態](https://docs.mulesoft.com/jp/exchange/to-publish-assets-maven#asset-lifecycle-state)を参照してください。

アプリケーションのスナップショットを更新するたびに、アプリケーションを再デプロイして最新のスナップショットバイナリで更新します。

スナップショットアセットはデプロイメント後に変更される可能性があるため、本番環境にはデプロイしないでください。

## [](#cloudhub-2-0-への再デプロイ)CloudHub 2.0 への再デプロイアプリケーションを再デプロイするには、デプロイしたときと同じコマンドを実行します。 CloudHub 2.0 は、デプロイしたアプリケーションを書き込み直します。 ## [](#authentication-のメソッド)Authentication のメソッド Mule Maven プラグインを使用してアプリケーションをデプロイする場合には、デプロイメントプラットフォームに対して認証するためのログイン情報をいくつかの方法で提供できます。使用する認証方法に応じて、デプロイメント設定で指定するパラメーターが異なります。

認証方法説明設定パラメーター

認証方法	説明	設定パラメーター
ユーザー名とパスワード	CloudHub 2.0 のユーザー名とパスワードを使用して認証します。	`username` `password`
サーバー	Maven サーバーに保存されているログイン情報を使用します。Maven の `settings.xml` ファイル内で設定します。	`server`
認証トークン	認証トークンを使用してプラットフォームにアクセスします。サポートされているシングルサインオン (SSO) 種別は「ID 管理」を参照してください。	`authToken`
接続アプリケーション	接続アプリケーションを使用して Anypoint Platform と通信することで、プログラムによって認証を実行します。接続アプリケーションのログイン情報に `Design Center Developer` アクセススコープが設定されている必要があります。接続アプリケーションを作成する手順は、「開発者向けの接続アプリケーション」を参照してください。	`connectedAppClientId` `connectedAppClientSecret` `connectedAppGrantType`

ユーザー名とパスワード

CloudHub 2.0 のユーザー名とパスワードを使用して認証します。

username
password

サーバー

Maven サーバーに保存されているログイン情報を使用します。Maven の settings.xml ファイル内で設定します。

server

認証トークン

認証トークンを使用してプラットフォームにアクセスします。
サポートされているシングルサインオン (SSO) 種別は「ID 管理」を参照してください。

authToken

接続アプリケーション

接続アプリケーションを使用して Anypoint Platform と通信することで、プログラムによって認証を実行します。
接続アプリケーションのログイン情報に Design Center Developer アクセススコープが設定されている必要があります。
接続アプリケーションを作成する手順は、「開発者向けの接続アプリケーション」を参照してください。

connectedAppClientId
connectedAppClientSecret
connectedAppGrantType

設定パラメーターの詳細は、[CloudHub 2.0 デプロイメントのパラメーターリファレンス](#cloudhub2-deploy-reference)を参照してください。 ## [](#cloudhub2-deploy-reference)CloudHub 2.0 デプロイメントのパラメーターリファレンス

パラメーター説明必須

cloudhub2Deployment

最上位要素

はい

uri

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

いいえ

muleVersion

CloudHub 2.0 インスタンスで実行する Mule Runtime Engine のバージョン。
この値がアプリケーションで最小限必要な Mule バージョン以上であることを確認します。デフォルトでは、使用可能な最新の Mule バージョンが選択されます。
値の例: 4.6.0 ではデフォルトで Edge チャネルと Java 8 になる最新のビルドが選択されます。異なる LTS または Edge の選択や Java バージョンを選択する場合は、4.6.0:1e-java17 のように完全な Mule バージョン名を指定します。
デプロイメントに Mule Maven プラグインバージョン 3.8.0 および 4.0.0 を使用している場合、muleVersion プロパティで releaseChannel と javaVersion を指定できません。これらのプロパティを指定するには、プラグインをバージョン 4.1.1 以降にアップグレードします。
Mule Runtime 4.4 標準サポートは 2024 年 10 月に終了するため、新しい Mule アプリケーションは Mule 4.6 LTS または Mule 4.8 Edge にデプロイできます。お客様が Mule Maven プラグインバージョン 4.1.0 以前を使用している場合、LTS チャネルはサポートされないため、プラグインをバージョン 4.1.1 以降にアップグレードしてください。

いいえ

releaseChannel

Mule イメージを選択するために使用されるリリースチャネル名を設定します。サポートされている値は、NONE、EDGE、LTS です。デフォルトでは、この値は EDGE に設定されています。選択されたリリースチャネルが存在しない場合、エラーが発生します。

いいえ

javaVersion

デプロイで使用される Java バージョンを設定します。サポートされている値は 8 と 17 です。デフォルトでは、この値は 8 に設定されています。選択された Java バージョンが存在しない場合、エラーが発生します。

いいえ

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>

いいえ

target

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

はい

provider

プロバイダー MC (MuleSoft コントロールプレーン) は、デプロイメントが Anypoint Runtime Manager を介して管理されていることを示します。CloudHub 2.0 では MC に設定します。

はい

environment

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

<environment>Sandbox</environment>

はい

replicas

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

autoscaling が false に設定されている場合のみ。

vCores

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

はい (instanceType が設定されていない場合のみ)

businessGroup

デプロイメントのビジネスグループパス
親組織から対象ビジネスグループへの完全な階層パスを指定します。次に例を示します。

<businessGroup>ParentOrg\SubOrg1\myBusinessGroup</businessGroup>

この値は、businessGroupId が設定されている場合は省略されます。businessGroup と businessGroupId が設定されていない場合、値はデフォルトでユーザーのメインビジネスグループになります。

いいえ

businessGroupId

デプロイメントのビジネスグループ ID
ビジネスグループパスを指定する代わりにビジネスグループ ID を指定してアプリケーションをデプロイできます。businessGroupId と businessGroup が設定されていない場合、値はデフォルトでユーザーのメインビジネスグループになります。
特定のビジネスグループへのアクセス権のみがあり、親組織へのアクセス権がない場合は、ビジネスグループ ID は必須パラメーターです。
このパラメーターは、プラグインバージョン 3.2.7 以降で使用できます。

いいえ

deploymentTimeout

デプロイメントプロセスの開始からアーティファクトがデプロイされたことの確認までの許容される経過時間 (ミリ秒)

デフォルト値は 1000000 です。

いいえ

server

Anypoint Platform ログイン情報を持つ Maven サーバー
これは、Maven settings.xml ファイルに保存されたログイン情報を使用する場合のみ必要です。これは Mule サーバー名ではありません。

いいえ

properties

最上位要素
デプロイする Mule アプリケーションのプロパティを設定する必要がある場合、最上位要素 <properties> を使用できます。

<properties>
  <key>value</key>
</properties>

次に例を示します。

<properties>
  <http.port>8081</http.port>
</properties>

アプリケーションを再デプロイする必要があり、デプロイメントの POM ファイルで設定されたプロパティがない場合、CloudHub 2.0 環境の既存のプロパティが保持されます。POM ファイルでプロパティが定義されている場合、アプリケーションはそれらのプロパティを使用してデプロイされるため、UI で設定されたプロパティは上書きされます。

いいえ

secureProperties

最上位要素
secureProperties 最上位要素を使用して Mule アプリケーションのプロパティを設定し、値を保存する前に暗号化するように CloudHub 2.0 に指示します。

<secureProperties>
  <key>value</key>
</secureProperties>

次に例を示します。

<secureProperties>
  <http.port>8081</http.port>
</secureProperties>

いいえ

skip

true に設定すると、プラグインデプロイメントゴールをスキップします。
デフォルト値は false です。

いいえ

skipDeploymentVerification

true に設定すると、デプロイされるアプリケーションの検証をスキップします。
デフォルト値は false です。

いいえ

authToken

プラットフォームにアクセスするための認証トークンを指定します。ユーザー名とパスワードを設定する代わりに、この認証方式を使用できます。
サポートされているシングルサインオン (SSO) 種別は「ID 管理」を参照してください。

認証トークンを使用してログインする場合のみ。

connectedAppClientId

接続アプリケーションの clientID 値を指定します。

接続アプリケーションログイン情報を使用してログインする場合のみ。

connectedAppClientSecret

接続アプリケーションのシークレットキーを指定します。

接続アプリケーションログイン情報を使用してログインする場合のみ。

connectedAppGrantType

サポートされている唯一の接続種別、client_credentials を指定します。

接続アプリケーションログイン情報を使用してログインする場合のみ。

deploymentSettings

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

いいえ

integrations

services

objectStoreV2

enabled

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

設定例:

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

いいえ

### [](#deployment-settings)deploymentSettings パラメーターリファレンス

パラメーター説明

enforceDeployingReplicasAcrossNodes

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

設定例:

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

updateStrategy

使用可能な値説明

rolling

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

recreate

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

デフォルト値は rolling です。

設定例:

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

clustered

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

設定例:

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

http

inbound

publicURL

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

pathRewrite

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

lastMileSecurity

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

設定例:

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

generateDefaultPublicUrl

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

disableAmLogForwarding

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

tracingEnabled

Mule Runtime の OpenTelemetry 標準のトレース情報をすべての APM ソリューションに公開します。cloudhub-2::ch2-deploy-private-space.adoc#enable-trace-data-collectionを参照してください。

autoscaling

デプロイメントおよび再デプロイメント操作で CPU ベースの水平自動スケーリング設定を指定します。autoscaling が無効になっていて、minReplicas および maxReplicas 項目が指定されている場合、それらは target.replicas 項目の値と一致している必要があります。「トレースデータ収集の有効化」を参照してください。設定例:

<deploymentSettings>
  <autoscaling>
    <enabled>true</enabled>
    <minReplicas>1</minReplicas>
    <maxReplicas>2</maxReplicas>
  </autoscaling>
</deploymentSettings>

persistentObjectStore

永続的なオブジェクトストアを使用するように Mule アプリケーションを設定します。デフォルトでは、これは false に設定されます。

instanceType

アプリケーションデプロイメントのレプリカの容量を指定します。このフラグは、使用量ベースの価格設定 (UBP) パッケージを使用している組織でのみ利用できます。UBP 以外の組織では、代わりに vCores パラメーターを使用します。Anypoint Platform 価格設定を参照してください。

## [](#ログイン情報の暗号化)ログイン情報の暗号化デプロイするときに暗号化ログイン情報を使用するには、Maven マスター暗号化パスワードおよび `settings-security.xml` ファイルをセットアップする必要があります。 1. Maven 設定のマスターパスワードを作成します。 mvn --encrypt-master-password Maven はマスターパスワードを暗号化して返します。 {l9vZ2uM5SdgHy+H12z4pX7LEOZn3Kbnqmt3kIquLjnQ=} 2. ~/.m2 リポジトリで `settings-security.xml` ファイルを作成し、暗号化マスターパスワードを追加します。 ```xml {l9vZ2uM5SdgHy+H12z4pX7LEOZn3Kbnqmt3kIquLjnQ=} ``` 3. Anypoint Platform パスワードを暗号化します。 mvn --encrypt-password Maven は Anypoint Platform パスワードを暗号化して返します。 {HTWFGH5BG9QmvJ1B=} 4. 暗号化 Anypoint Platform パスワードを `settings.xml` ファイルのセクションに追加します。 ```xml ... ... my.anypoint.credentials my.anypoint.username {HTWFGH5BG9QmvJ1B=} ... ... ``` 5. 設定デプロイメントで、`settings.xml` ファイルで設定されたサーバー ID を挿入するログイン情報を参照します。 ```xml ... ... ... my.anypoint.credentials ... ... ... ```

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

## [](#関連情報)関連情報 - [Mule Maven プラグイン](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept) - [CloudHub 2.0](https://docs.mulesoft.com/cloudhub-2/)