§アプリケーションを本番モードで起動する

We have seen how to run a Play application in development mode, however the run command should not be used to run an application in production mode. When using run, on each request, Play checks with SBT to see if any files have changed, and this may have significant performance impacts on your application.

Play アプリケーションを本番モードで起動する方法はいくつかあります。まずは、ローカル環境に Play をインストールするという最も簡単な方法を試してみましょう。

§The application secret

Before you run your application in production mode, you need to generate an application secret. To read more about how to do this, see Configuring the application secret. In the examples below, you will see the use of -Dapplication.secret=abcdefghijk. You must generate your own secret to use here.

§start コマンドを使う

アプリケーションを本番モードで起動する最も簡単な方法は、 Play コンソールから start コマンドを実行することです。そのためには、サーバに予め Play をインストールしておく必要があります。

[my-first-app] $ start -Dapplication.secret=abcdefghijk

start コマンドを実行すると、 Play は JVM を新たにフォークして、標準の Netty HTTP サーバを起動します。そのとき、標準出力が Play コンソールにリダイレクトされるので、そこからアプリケーションの状態をモニタリングすることができます。

The server’s process id is displayed at bootstrap and written to the RUNNING_PID file. To kill a running Play server, it is enough to send a SIGTERM to the process to properly shutdown the application.

Ctrl+D を入力すると、 Play コンソールは終了しますが、生成されたサーバ・プロセスはバックグラウンドで動作を続けます。そのとき、フォークした JVM の標準出力は閉じられてしまいますが、ログは logs/application.log というファイルに出力され続けます。

Ctrl+C を入力すると、Play コンソールとフォークした Play サーバの両方の JVM を終了します。

You can also use activator start at your OS command prompt to start the server without first starting the Play console:

$ activator start -Dapplication.secret="abcdefghijk"

§stage タスクを使う

start コマンドはアプリケーションを対話的に起動するため、手作業が必要であり、また プロセスを切り離すために Ctrl+D が必要です。つまり、この方法はデプロイを自動化するには向いていません。

こんなとき stage タスクを利用すると、アプリケーションが後で即座に起動できるように、準備をすることができます。プロジェクトを後で即座に実行できるようにするための典型的なコマンドは次のようなものです。

$ activator clean stage

This cleans and compiles your application, retrieves the required dependencies and copies them to the target/universal/stage directory. It also creates a bin/<start> script where <start> is the project’s name. The script runs the Play server on Unix style systems and there is also a corresponding bat file for Windows.

For example to start an application of the project my-first-app from the project folder you can:

$ target/universal/stage/bin/my-first-app -Dapplication.secret=abcdefghijk

次のようにして、本番環境用の別の設定ファイルを指定することもできます:

$ target/universal/stage/bin/my-first-app -Dconfig.file=/full/path/to/conf/application-prod.conf

For a full description of usage invoke the start script with a -h option.

Next: スタンドアローン版を作成する

このドキュメントの翻訳は Play チームによってメンテナンスされているものではありません。 間違いを見つけた場合、このページのソースコードを ここ で確認することができます。 ドキュメントガイドライン を読んで、お気軽にプルリクエストを送ってください。