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

Serverless App Engine:Java Tomcatパラメーターの設定

最終更新日:Sep 03, 2024

WARパッケージを使用してアプリケーションをデプロイする場合、ビジネス要件に基づいて、アプリケーションポート、アプリケーションアクセスパス、スレッドの最大数などのTomcatパラメーターをカスタマイズできます。 このトピックでは、WARパッケージを使用してデプロイされたJavaアプリケーションのSAEコンソールでJava Tomcatパラメーターを設定する方法について説明します。

前提条件

Java Tomcatパラメーターを設定する前に、JavaアプリケーションのWARパッケージが準備されていることを確認してください。

手順

アプリケーションの作成時にJava Tomcatを設定する

  1. SAEコンソールにログインします。

  2. 左側のナビゲーションウィンドウで、[アプリケーション] をクリックします。 上部のナビゲーションバーで、リージョンを選択します。 次に、[アプリケーションの作成] をクリックします。

  3. では、基本情報ステップ、パラメータを設定し、次条: アプリケーションの配置設定.

  4. [デプロイの設定] ステップで、アプリケーションのデプロイ情報を設定します。

    パラメーター説明
    Technology Stackプログラミング言语[Java] を選択します。
    アプリケーションの配置方法[WARパッケージでのデプロイ] を選択します。
    アプリケーションランタイム環境
    • apache-tomcat-XXX: このオプションは、Spring BootアプリケーションまたはDubboアプリケーションに適しています。
    • EDAS-Container-XXX: このオプションは、高速サービスフレームワーク (HSF) アプリケーションに適しています。
    Java環境
    • Dragonwell X (推奨): OpenJDKをサポートしています。 このオプションを選択すると、アプリケーションの起動とランタイムが高速化され、ガベージコレクション (GC) の効率が向上します。 詳細については、「スタートアップコマンドの設定」をご参照ください。

    • JDK Xを開く: この環境はCentOSオペレーティングシステムに基づいており、ベースイメージのサイズが大きいです。

    • openjdk-XXXXX-jdk-alpine3 9: この環境はAlpineオペレーティングシステムに基づいており、ベースイメージのサイズは小さいです。

    説明

    CentOSオペレーティングシステムと比較して、Alpineオペレーティングシステムに基づくJava環境は、より少ないツールまたはコマンドをサポートします。 openjdk-XXXXX-jdk-alpine3.9を選択すると、webshellの一部のコマンドの実行に失敗することがあります。 ビジネスシナリオに基づいて環境を選択します。

    ファイルのアップロード方法[WARパッケージのアップロード] または [WARパッケージアドレス] を選択します。
    • WARパッケージのアップロード: [ファイルの選択] をクリックし、アプリケーションのデプロイに使用するWARパッケージを選択します。
    • WARパッケージのアドレス: WARパッケージが保存されているディレクトリを入力します。
    説明 アプリケーションのデプロイに使用するパッケージの名前には、英数字、ハイフン (-) 、およびアンダースコア (_) のみを使用できます。
    バージョンアプリケーションのバージョン番号。 バージョン番号を入力するか、[タイムスタンプをバージョン番号として使用] をクリックします。
    タイムゾーン設定アプリケーションのタイムゾーンを選択します。 例: UTC + 8
  5. [Java Tomcatの設定] セクションで、[カスタム設定] を選択し、[編集] をクリックします。

    选中Java Tomcat

  6. では、Java Tomcat設定の編集パネル、パラメータを設定し、OK.

    image

    パラメーター

    説明

    アプリケーションポート

    アプリケーションによって使用されるポート番号。 有効な値: 1024〜49151。 デフォルト値: 8080

    Tomcatコンテキスト

    アプリケーションのアクセスパス。 有効な値:

    • パッケージ名: WARファイルの名前が使用されます。 このパラメーターを設定する必要はありません。 この設定は、[ファイルのアップロード方法] パラメーターを [WARパッケージのアップロード] に設定した場合にのみサポートされます。

    • ルートディレクトリ: アプリケーションのアクセスパスは /です。

    • カスタム: [カスタムパス] フィールドでアプリケーションのアクセスパスを指定します。

    最大スレッド数

    リクエストを同時に処理するスレッドの最大数。 有効な値: 10 ~ 1024 デフォルト値: 400

    重要

    Maximum Threadsパラメーターの値は、アプリケーションのパフォーマンスに影響します。 このパラメーターの設定は、慎重に行ってください。

    Tomcatエンコーディング

    Tomcatのエンコード形式。The encoding format for Tomcat. 有効な値: UTF-8ISO-8859-1GBKGB2312。 デフォルト値: ISO-8859-1

    URLにボディエンコーディングを使用

    デフォルトでは、この機能は有効になっています。 この場合、HTTPリクエスト本文の文字セットを使用して、クエリパラメーター (QueryString) をデコードできます。

  7. [次へ: 仕様の確認] をクリックします。

  8. 仕様の確認ステップで、アプリケーションの詳細と選択した仕様の料金を表示します。 次に、[確認] をクリックします。

    作成完了ステップが表示されます。 [アプリケーションの詳細] をクリックすると、[基本情報] ページに移動して、アプリケーションの基本情報を表示できます。

アプリケーションのデプロイ時にJava Tomcatを設定する

警告

アプリケーションを再デプロイすると、アプリケーションは再起動されます。 業務中断などの予測できないエラーを防ぐため、オフピーク時にアプリケーションをデプロイすることを推奨します。

アプリケーションを更新するために実行できる手順は、アプリケーション内のインスタンスの数によって異なります。 このセクションでは、インスタンス数が1以上のアプリケーションに必要な機能を設定する方法の例を示します。 インスタンス数が0のアプリケーションの更新方法については、「アプリケーションの更新」をご参照ください。

  1. SAEコンソールにログインします。

  2. 左側のナビゲーションウィンドウで、[アプリケーション] をクリックします。 上部のナビゲーションバーで、リージョンを選択します。 次に、管理するアプリケーションの名前をクリックします。

  3. の右上隅に基本情報ページをクリックします。アプリケーションのデプロイ.

  4. [Java Tomcatの設定] セクションで、[カスタム設定] を選択し、[編集] をクリックします。

    选中Java Tomcat

  5. では、Java Tomcat設定の編集パネル、パラメータを設定し、OK.

    image

    パラメーター

    説明

    アプリケーションポート

    アプリケーションによって使用されるポート番号。 有効な値: 1024〜49151。 デフォルト値: 8080

    Tomcatコンテキスト

    アプリケーションのアクセスパス。 有効な値:

    • パッケージ名: WARファイルの名前が使用されます。 このパラメーターを設定する必要はありません。 この設定は、[ファイルのアップロード方法] パラメーターを [WARパッケージのアップロード] に設定した場合にのみサポートされます。

    • ルートディレクトリ: アプリケーションのアクセスパスは /です。

    • カスタム: [カスタムパス] フィールドでアプリケーションのアクセスパスを指定します。

    最大スレッド数

    リクエストを同時に処理するスレッドの最大数。 有効な値: 10 ~ 1024 デフォルト値: 400

    重要

    Maximum Threadsパラメーターの値は、アプリケーションのパフォーマンスに影響します。 このパラメーターの設定は、慎重に行ってください。

    Tomcatエンコーディング

    Tomcatのエンコード形式。The encoding format for Tomcat. 有効な値: UTF-8ISO-8859-1GBKGB2312。 デフォルト値: ISO-8859-1

    URLにボディエンコーディングを使用

    デフォルトでは、この機能は有効になっています。 この場合、HTTPリクエスト本文の文字セットを使用して、クエリパラメーター (QueryString) をデコードできます。

  6. 設定後、をクリックします。確認.

ConfigMapを使用してJava Tomcat構成ファイルを変更する

SAEコンソールで提供されている前述のJava Tomcatパラメーターがビジネス要件を満たさない場合、またはJava Tomcat設定ファイルを変更する場合は、ConfigMapを作成できます。

WARファイルを使用してアプリケーションをSAEにデプロイすると、server.xmlファイルは /home/admin/apache-tomcat-8.5.42/confディレクトリに保存されます。 このセクションの例では、server.xmlファイルを使用して、ConfigMapを使用してJava Tomcat構成ファイルを変更する方法を示します。

  1. 変更します。Modify theserver.xmlファイルを作成します。

    1. SAEコンソールにログインします。

    2. 左側のナビゲーションウィンドウで、[アプリケーション] をクリックします。 上部のナビゲーションバーで、リージョンを選択します。 次に、アプリケーションの名前をクリックします。

    3. [基本情報] ページで、[インスタンスのデプロイ情報] タブをクリックします。 [デフォルトグループ] セクションで、アプリケーションの [操作] 列の [Webshell] をクリックします。

    4. Webshellウィンドウで、server.xmlファイルしてウィンドウを閉じます。

      1. 次のコマンドを実行して、server.xmlファイルが保存されているディレクトリに移動します。

        cd /home/admin/apache-tomcat-8.5.42/conf
      2. 次のコマンドを実行して、server.xmlファイルの内容を表示します。

        cat server.xml
      3. server.xmlファイルのコンテンツをオンプレミスのコンピューターにコピーし、ビジネス要件に基づいてファイルのコンテンツを変更してから、新しいコンテンツをコピーします。

  2. ConfigMapを作成します。

    説明

    作成するConfigMapの名前空間は、ConfigMapを作成するアプリケーションの名前空間と同じである必要があります。

    1. 左側のナビゲーションウィンドウで、[名前空間] をクリックします。 上部のナビゲーションバーで、リージョンを選択します。 次に、アプリケーションの名前空間の名前をクリックします。

    2. 左側のナビゲーションウィンドウで、[ConfigMaps] をクリックします。 [ConfigMaps] ページで、[作成] をクリックします。

    3. ConfigMapの作成パネルで、パラメーターを設定します。 server.xmlファイルの新しいコンテンツを [値] テキストボックスにコピーし、[OK] をクリックします。

      sc_create_configmap_for_tomcatこの例では、MethodパラメーターはManualに設定されています。 下表に、各パラメーターを説明します。 詳細については、「Kubernetes ConfigMapの管理」をご参照ください。

      パラメーター説明
      ConfigMap名ConfigMapの名前を入力します。
      ConfigMapの説明ConfigMapの説明を入力します。
      マッピングの設定
      • キーの長さは最大250文字です。 値の長さは最大10,000文字です。
      • ConfigMapには最大20個のキーと値のペアを指定できます。

    ConfigMapを作成すると、ConfigMapページにConfigMapが表示されます。

  3. アプリケーションをデプロイし、ConfigMapをマウントします。

    1. 左側のナビゲーションウィンドウで、[名前空間の詳細] をクリックします。 [名前空間の詳細] ページで、[リソース情報] タブをクリックします。

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

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

    4. [アプリケーションのデプロイ] ページの下部で、[設定管理] セクションをクリックし、[ステップ2] で設定した [設定マップ][キー] を選択し、[マウントパス] パラメーターを指定します。sc_mount_configuration_for_tomcat

    5. パラメーターの設定後、[確認] をクリックします。

      [レコードの変更] ページに移動して、アプリケーションのデプロイメントステータスを確認できます。

Verify the results

  1. SAEコンソールにログインします。

  2. 左側のナビゲーションウィンドウで、[アプリケーション] をクリックします。 上部のナビゲーションバーで、リージョンを選択します。 次に、管理するアプリケーションの名前をクリックします。

  3. 設定が有効かどうかを確認します。

    • 方法 1:

      [基本情報] ページの左側のナビゲーションウィンドウで、[レコードの変更] をクリックします。 [レコードの変更] ページで、変更の詳細を表示します。 [ステータスの変更] 列に [実行] が表示されている場合、アプリケーションがデプロイされ、設定が有効になります。

    • 方法 2:

      [基本情報] ページで、[インスタンスのデプロイ情報] タブをクリックし、インスタンスの [ステータス] を表示します。 [ステータス] 列に [実行中] が表示されている場合、アプリケーションがデプロイされ、設定が有効になります。