すべてのプロダクト
Search
ドキュメントセンター

Serverless App Engine:起動コマンドの設定

最終更新日:Jan 10, 2026

SAE コンソールでコンテナイメージまたはコードパッケージからアプリケーションをデプロイすると、SAE はプリセットされた起動パラメーターを使用してコンテナーを起動します。SAE でカスタム起動コマンドを定義して、Nginx などの特別な構成を適用したり、イメージのデフォルトの起動パラメーターを上書きしたりできます。

機能のエントリポイント

アクセス方法はシナリオによって異なります:

アプリケーションの作成

  1. SAE コンソールにログインします。 左側のナビゲーションウィンドウで、アプリケーション管理 > アプリケーション一覧 を選択します。 ターゲットリージョンと名前空間を選択し、[アプリケーションの作成] をクリックします。

  2. 基本情報 ページでパラメーターを設定し、[次へ:高度な設定] をクリックします。

実行中のアプリケーションの変更

警告

アプリケーションを再デプロイすると、アプリケーションは再起動されます。 ビジネスの中断などの予測不能なエラーを防ぐため、オフピーク時間にアプリケーションをデプロイすることを推奨します。

  1. SAE コンソールにログインします。 左側のナビゲーションウィンドウで、アプリケーション管理 > アプリケーション一覧 を選択します。 ターゲットリージョンと名前空間を選択し、対象アプリケーションの名前をクリックします。

  2. アプリケーションの 基本情報 ページで、[アプリケーションのデプロイ] をクリックします。

停止中のアプリケーションの変更

  1. SAE コンソールにログインします。 左側のナビゲーションウィンドウで、アプリケーション管理 > アプリケーション一覧 を選択します。 ターゲットリージョンと名前空間を選択し、対象アプリケーションの名前をクリックします。

  2. アプリケーションの 基本情報 ページで、[アプリケーション構成の変更] をクリックします。

アプリケーションの起動コマンドの設定

イメージからデプロイされたアプリケーション

通常、起動コマンドを設定する必要はありません。 これは、イメージを作成する際に、コンテナーの起動コマンドが Dockerfile 内の ENTRYPOINT または CMD を使用してすでに設定されているためです。

たとえば、Dockerfile で設定された次のコマンドは、コンテナーの起動時に実行されます。

ENTRYPOINT [nginx, '-g', 'daemon off;']                

Dockerfile で設定された起動コマンドを上書きするには、次の手順を実行します:

  1. 起動コマンド セクションで、スクリプトインタープリターを >_ /bin/sh または >_ /bin/bash に設定します。 イメージに選択したスクリプトインタープリターが含まれていることを確認してください。

  2. コンテナーの起動コマンドを設定します。 次の例は、必要なフォーマットを示しています:

    • >_ /bin/sh

      sh -c 'while true; do echo hello; sleep 10;done'
    • >_ /bin/bash

      bash -c 'while true; do echo hello; sleep 10;done'

    sBXB3VO8G5

重要

元の Dockerfile の ENTRYPOINTCMD の設定に慣れていない場合は、起動コマンドやパラメーターをカスタマイズしたり変更したりしないでください。 起動コマンドが正しくないと、アプリケーションの作成が失敗します。

JAR パッケージからデプロイされたアプリケーション

Java アプリケーションは、Java 仮想マシン (JVM) パラメーターや GC (ガベージコレクション) ポリシーなど、起動して実行するための起動コマンドとパラメーターを必要とします。

SAE は、アップロードされた JAR パッケージを自動的にイメージにコンパイルし、コンテナー内でアプリケーションを実行します。 このプロセス中、SAE は組み込みの起動コマンドとパラメーターを使用し、JAR パッケージのストレージパスを指定します。 SAEコンソールにログインして、デフォルトの起動コマンドとそのパラメーターを変更できます。

起動コマンド設定 セクションで、設定項目を指定します。 以下は起動コマンドの例です。

dQolzyE4Iu

設定項目

説明

デフォルトの起動コマンド

SAE が提供するデフォルトの起動コマンド。

オプション設定

JVM パラメーターを設定します。 詳細については、「JVM パラメーター設定」、「Tuning Java Virtual Machines」、および「JVM Tuning: How to Prepare Your Environment for Performance Tuning」をご参照ください。

アプリケーションのリモートデバッグ機能を使用するには、JDK バージョンに基づいて必要なコマンドを設定します。

  • JDK 11 および JDK 17

    -agentlib:jdwp=transport=dt_socket,address=*:9000,server=y,suspend=n
  • その他の JDK バージョン

    -agentlib:jdwp=transport=dt_socket,address=9000,server=y,suspend=n

パラメーターは次のように説明されます。

  • transport:リモートデバッグのデータ転送メソッド。

  • address:リモートデバッグアドレス。 これは、リモートデバッグを有効にしたときに設定したデバッグポートと同じである必要があります。 リモートデバッグの詳細については、「リモートデバッグ」をご参照ください。

重要

WAR パッケージと JAR パッケージからデプロイされたアプリケーションの起動コマンドは異なります。 両方のデプロイメントメソッドに同じ起動コマンドを使用しないでください。 この例のリモートデバッグコマンドは、両方のデプロイメントメソッドに適用されます。

引数設定

標準出力と標準エラーのリダイレクトコマンドを設定します。例:1>>/tmp/std.log>&1

WAR パッケージからデプロイされたアプリケーション

起動コマンド設定 セクションで、設定項目を指定します。 以下は起動コマンドの例です。

nGwm0XDLnO

設定項目

説明

デフォルトの起動コマンド

SAE が提供するデフォルトの起動コマンド。

オプション設定

JVM パラメーターを設定します。 詳細については、「JVM パラメーター設定」、「Tuning Java Virtual Machines」、および「JVM Tuning: How to Prepare Your Environment for Performance Tuning」をご参照ください。

アプリケーションのリモートデバッグ機能を使用するには、JDK バージョンに基づいて必要なコマンドを設定します。

  • JDK 11 および JDK 17

    -agentlib:jdwp=transport=dt_socket,address=*:9000,server=y,suspend=n
  • その他の JDK バージョン

    -agentlib:jdwp=transport=dt_socket,address=9000,server=y,suspend=n

パラメーターは次のように説明されます。

  • transport:リモートデバッグのデータ転送メソッド。

  • address:リモートデバッグアドレス。 これは、リモートデバッグを有効にしたときに設定したデバッグポートと同じである必要があります。 リモートデバッグの詳細については、「リモートデバッグ」をご参照ください。

重要

WAR パッケージと JAR パッケージからデプロイされたアプリケーションの起動コマンドは異なります。 両方のデプロイメントメソッドに同じ起動コマンドを使用しないでください。 この例のリモートデバッグコマンドは、両方のデプロイメントメソッドに適用されます。

ZIP パッケージからデプロイされたアプリケーション

起動コマンド セクションで、スクリプトタイプを選択し、コンテナーの起動コマンドを設定します。

  • >_ /bin/sh

    sh -c 'gunicorn -w 3 -b 0.0.0.0:8080 app.hello:app'
  • >_ /bin/bash

    bash -c 'gunicorn -w 3 -b 0.0.0.0:8080 app.hello:app'

FWP1NqMoGb