Flex Gateway新着情報
Governance新着情報
Monitoring API ManagerCloudHub デプロイメントでは、Anypoint Runtime Manager またはプロパティファイルを使用してプロパティをアプリケーションに追加できます。
アプリケーションのプロパティファイルと Runtime Manager の両方でプロパティを設定してある場合、アプリケーションをデプロイすると、常に Runtime Manager の値がプロファイルファイルの値よりも優先されます。
CloudHub にデプロイされたアプリケーションにプロパティを読み込む最も簡単な方法は、Anypoint Runtime Manager の [Properties (プロパティ)] タブを使用することです。
プロパティを追加する手順は、次のとおりです。
Anypoint Platform の [Runtime Manager] を選択します。
[Applications (アプリケーション)] タブをクリックします。
[Status (状況)] 列をクリックして詳細ペインを表示します。
[Manage Application (アプリケーションを管理)] をクリックします。
[Settings (設定)] ページで [Properties (プロパティ)] タブで以下を行います。
[List (リスト)] をクリックします。
代わりに、[Text (テキスト)] 項目に key=value
の形式でキー-値ペアを入力することもできます。
[Key (キー)] 項目にプロパティ名を入力します。
[Value (値)] 項目にプロパティ値を入力します。
Chrome のパスワード保存機能が有効化されていて、[Key (キー)] 項目のコンテンツと一致する anypoint.mulesoft.com
のユーザー名が保存されている場合、Chrome はそのユーザー名に関連付けられている保存済みパスワードで [Value (値)] 項目の値を上書きします。
この制約を回避するには、Chrome をシークレットモードで使用するか、または他のブラウザーを使用してください。
キーまたは値を変更するには、項目ないのテキストを編集します。
プロパティを削除するには、[X] をクリックします。
[Apply Changes (変更を適用)] をクリックします。
右上のメニューから [Restart (再起動)] を選択してアプリケーションを再起動します。
Java システム環境変数を指定できます。この機能は、オンプレミスサーバーへのデプロイで環境変数を追加した場合と同じです。
アプリケーションの環境変数も設定できます。
プロパティにより、デプロイ先の環境に応じて変わる設定を外部化することができます。
たとえば、ローカルで Mule アプリケーションを使用している場合は、データベースホストを 0.0.0.0
に設定する可能性があります。
同じアプリケーションを CloudHub にデプロイする場合は、データベースホストを Amazon RDS サーバーなどに設定することがあります。
アプリケーションプロパティを使用して環境変数を作成または設定する手順は、次のとおりです。
Anypoint Platform の [Runtime Manager] を選択します。
[Applications (アプリケーション)] タブをクリックします。
[Status (状況)] 列をクリックして詳細ペインを表示します。
[Manage Application (アプリケーションを管理)] をクリックします。
[Settings (設定)] ページで [Properties (プロパティ)] タブで以下を行います。
[Text (テキスト)] ビューに key=value
の形式で変数を入力します。
[Text (テキスト)] ビューでは、バックスラッシュ文字 (\ ) はエスケープ文字として使用します。
たとえば、キーまたは値内で : を使用するには、構文で \: を使用します。
キーまたは値内で \ を使用するには、構文で \\ を使用します。
[List (リスト)] ビューの構文には、エスケープ文字は必要ありません。
|
Mule アプリケーション設定で環境変数を使用します。
デプロイ可能なアプリケーションのアーカイブファイルにファイルをインクルードすることで、アプリケーションにプロパティを追加できます。
プロパティプレースホルダー YAML ファイル (Mule 4)
「プロパティの設定」を参照してください。
mule-app.properties
(Mule 3)
「プロパティの設定」を参照してください。
これらのプロパティはアプリケーションの起動時に CloudHub によってアプリケーションに読み込まれます。
この方法は CloudHub でのベストプラクティスではありません (CloudHub の [Properties (プロパティ)] タブの値によってファイル内の同じ名前を持つすべてのプロパティが上書きされるため) が、Mule アプリケーションのオプションを変更することでこの問題を回避できます。
CloudHub プロパティによって、デプロイ可能なアーカイブにバンドルされたプロパティが上書きされるのを防ぐには、Mule アプリケーションの property-placeholder
要素のオプションを変更します。
デフォルト以外のプロパティプレースホルダーオプションの詳細は、 プロパティプレースホルダーオプションに関する Spring のドキュメントを参照してください。
CloudHub では、一部のプロパティが予約されており、これらのプロパティの値は変更できません。 アプリケーションが予約されたプロパティに値を割り当てようとしても、CloudHub はその値を使用しません。 代わりに、エラーや例外をスローすることなく、内部で設定されている値を返し、ログに警告メッセージを追加します。
アプリケーションは、予約されたプロパティを参照して、アプリケーション名やデプロイメントリージョンなどを取得できます。
アプリケーションで Anypoint Platform API コールを実行する場合は、${csorganization.id}
および ${environment.id}
プロパティを使用してこれらの値を取得します。
複数ワーカーアプリケーションで各ワーカーを識別するには、${worker.id}
を使用してください。
${spring.profiles.active} および ${logging.*} プロパティは使用しないでください。
|
プロパティ | 説明 | 例 |
---|---|---|
|
JVM を提供するベンダー |
Oracle Corporation |
|
JVM 名 |
Java™ SE Runtime Environment |
|
ドット (ポイント) リリースを除外した JVM バージョン。 この値は、CloudHub ランタイムリリースで JDK がアップグレードされると変更されます。 |
1.8.0_141 |
|
メインまたはビジネスグループ ID |
09396371-2cd4-412e-8d08-4356dd3e7bfc |
|
環境 ID |
52a69d49e4b0e3c7324ae5b6 |
|
環境種別 |
本番 |
|
ワーカー ID (複数ワーカーアプリケーション用) |
0 |
|
アプリケーション名 |
|
|
アプリケーションの完全ドメイン名 |
|
|
アプリケーションデプロイリージョン |
|
|
HTTP ポート |
8081 |
|
HTTPS ポート |
8082 |
|
HTTP 非公開ポート |
8091 |
|
HTTPS 非公開ポート |
8092 |
|
Mule インスタンスへの絶対パス |
|
|
内部で使用、使用しないでください |
|
|
内部で使用、使用しないでください |
|
|
内部でワーカーのローカル IP アドレスに使用 |
|
|
内部で基本 Anypoint Platform URL として使用 |
US: MuleSoft Government Cloud: |
独自の理由により、MuleSoft は予約されたすべての内部プロパティを公開しません。 CloudHub ランタイムリリースの更新により、予約されたプロパティが変更される場合があります。 |
次の 2 つのプロパティの値は事前入力されます。ただし、事前入力された値を上書きすることができます。
プロパティ | 説明 | 例 |
---|---|---|
|
アプリケーションの |
myApplication |
|
実行時のアプリケーションのルートディレクトリ。 |
/opt/mule/mule-4.3.0/apps/myApplication |
<set-payload value="java.vendor=${java.vendor}, java.runtime.name=${java.runtime.name}, java.version=${java.version}, application.aws.region=${application.aws.region},
http.port=${http.port}, http.ports=${http.port}, mule.home=${mule.home}, csorganization.id=${csorganization.id}, environment.id=${environment.id},
environment.type=${environment.type}, worker.id=${worker.id}, domain=${domain}, fullDomain=${fullDomain}" doc:name="Set Payload"/>
<logger message="#[payload]" level="INFO" doc:name="Logger"/>
出力例:
16:33:08.572 07/02/2020 Worker-0 [cloudhub-reserved-properties].HTTP_Listener_Configuration.worker.01 INFO
java.vendor=Oracle Corporation, java.runtime.name=Java(TM) SE Runtime Environment, java.version=1.8.0_141, application.aws.region=ap-southeast-2,
http.port=8081, http.ports=8081, mule.home=/opt/mule/mule-4.3.0, csorganization.id=09396371-2cd4-412e-8d08-4356dd3e7bfc, environment.id=52a69d49e4b0e3c7324ae5b6,
environment.type=production, worker.id=0, domain=cloudhub-reserved-properties, fullDomain=cloudhub-reserved-properties.au-s1.cloudhub.io
「プロパティの設定」 (Mule 4)
「プロパティの設定」 (Mule 3)