イントラマートを再起動せずにリリースする方法

こんにちは。もりおです。

今回はintra-martについて記事にしました。

「ちょっとした修正なのに、毎回resin再起動するのつらい…」そんな方に向けて、intra-martをサーバ再起動せずにリリースする方法をまとめました。

※公式ドキュメント(設定ファイルリファレンス 第39版 2026-04-28)をもとに最新情報をお届けします。

この記事におすすめの方々

・自社のシステムをintra-martで構築している運用担当者の方
・intra-martを用いてシステムを開発している方
・毎回のサーバ再起動を省略したい方

イントラマートを再起動せずにリリースする方法を教えるよ!
非推奨なので注意してね!でも知っておくと便利やで


intra-martをサーバ再起動せずにリリースする方法【source-config.xml設定】


1. 再起動なしでリリースできるケースとできないケース


スクリプト開発モデルでは、リリース対象がjsファイルやhtmlファイルであればアプリケーションサーバ上のファイルを上書きするだけでOKです。

ただし、条件があります。source-config.xml でJavaScriptコンパイラが無効(false)になっていることが前提です。

一方、xmlファイルなどの定義ファイルをリリースしたい場合は、resinの再起動が必要です。定義ファイルの内容はサーバ再起動をしないと反映されません。

2. source-config.xml の設定方法


設定ファイル『source-config.xml』は、スクリプト開発モデルのプログラムソースおよび実行に関する設定を行うファイルです。

このファイルは対象ディレクトリとそのサブディレクトリに対して再帰的に有効です。最も浅い階層に配置することで、配下すべてのプログラムソースに設定が適用されます。

再起動なしで反映させるには、以下の2箇所を false に設定してください。

① JavaScriptコンパイラの設定(jsファイルを再起動なしで反映)
<resource-file>
  <javascript>
    <compiler enable="false" />
    <optimize level="0" />
  </javascript>
</resource-file>
enable="true" の場合、JavaScriptをJavaクラスへコンパイルしてキャッシュするため、ソース変更がサーバ再起動なしでは一切反映されません。false(インタプリタモード)にすることで即時反映できます。
optimize level は必ず「0」を指定してください(公式推奨値)。

② Viewコンパイラの設定(htmlファイルを再起動なしで反映)
<resource-file>
  <view>
    <compiler enable="false" />
  </view>
</resource-file>
enable="true" の場合、HTMLをコンパイルして中間ファイルをキャッシュするため、変更が反映されなくなります。false にすることでHTMLの変更も即時反映できます。

3. ファイル単位で設定する方法(応用編)


特定のファイルだけ個別に設定したい場合は、対象ファイルと同名の .properties ファイルを同じディレクトリに作成する方法も使えます。

例:sample.html / sample.js に対して個別設定する場合 → sample.properties を作成

charset=UTF-8
javascript.compile.enable=false
javascript.optimize.level=0
view.compile.enable=false
※ .properties ファイルが存在する場合、source-config.xml の設定より優先して適用されます。

4. 注意点まとめ


⚠️ この方法は公式非推奨です。intra-martとしては正式なデプロイ手順での運用を推奨しています。

⚠️ compiler enable="false"(インタプリタモード)はパフォーマンスへの影響があります。開発・テスト環境向けの設定で、本番運用環境では基本的に true(コンパイルモード)が推奨です。

⚠️ xmlファイルや定義ファイルの変更は、この方法では反映できません。定義ファイルはサーバ再起動が必須です。

5. 参考ページ(公式ドキュメント)

⚫️ 設定ファイル『source-config.xml』について(第39版 2026-04-28)

⚫️ 推奨のリリース方法(公式サイト)

⚫️ サポートサイト:停止は必要と記載あり(公式サポートサイト)

⚫️ 推奨されないリリース方法(公式サポートサイト)

最後までご覧いただきありがとうございました。

よろしければクリックをお願いいたします。
  にほんブログ村 株ブログ 株日記へ