WARパッケージを使用してアプリケーションをデプロイする場合、ビジネス要件に基づいて、アプリケーションポート、アプリケーションアクセスパス、スレッドの最大数などのTomcatパラメーターをカスタマイズできます。 このトピックでは、WARパッケージを使用してデプロイされたJavaアプリケーションのSAEコンソールでJava Tomcatパラメーターを設定する方法について説明します。
前提条件
Java Tomcatパラメーターを設定する前に、JavaアプリケーションのWARパッケージが準備されていることを確認してください。
手順
アプリケーションの作成時にJava Tomcatを設定する
SAEコンソールにログインします。
左側のナビゲーションウィンドウで、[アプリケーション] をクリックします。 上部のナビゲーションバーで、リージョンを選択します。 次に、[アプリケーションの作成] をクリックします。
では、基本情報ステップ、パラメータを設定し、次条: アプリケーションの配置設定.
[デプロイの設定] ステップで、アプリケーションのデプロイ情報を設定します。
パラメーター 説明 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 [Java Tomcatの設定] セクションで、[カスタム設定] を選択し、[編集] をクリックします。
では、Java Tomcat設定の編集パネル、パラメータを設定し、OK.
パラメーター
説明
アプリケーションポート
アプリケーションによって使用されるポート番号。 有効な値: 1024〜49151。 デフォルト値: 8080
Tomcatコンテキスト
アプリケーションのアクセスパス。 有効な値:
パッケージ名: WARファイルの名前が使用されます。 このパラメーターを設定する必要はありません。 この設定は、[ファイルのアップロード方法] パラメーターを [WARパッケージのアップロード] に設定した場合にのみサポートされます。
ルートディレクトリ: アプリケーションのアクセスパスは /です。
カスタム: [カスタムパス] フィールドでアプリケーションのアクセスパスを指定します。
最大スレッド数
リクエストを同時に処理するスレッドの最大数。 有効な値: 10 ~ 1024 デフォルト値: 400
重要Maximum Threadsパラメーターの値は、アプリケーションのパフォーマンスに影響します。 このパラメーターの設定は、慎重に行ってください。
Tomcatエンコーディング
Tomcatのエンコード形式。The encoding format for Tomcat. 有効な値: UTF-8、ISO-8859-1、GBK、GB2312。 デフォルト値: ISO-8859-1
URLにボディエンコーディングを使用
デフォルトでは、この機能は有効になっています。 この場合、HTTPリクエスト本文の文字セットを使用して、クエリパラメーター (QueryString) をデコードできます。
[次へ: 仕様の確認] をクリックします。
仕様の確認ステップで、アプリケーションの詳細と選択した仕様の料金を表示します。 次に、[確認] をクリックします。
作成完了ステップが表示されます。 [アプリケーションの詳細] をクリックすると、[基本情報] ページに移動して、アプリケーションの基本情報を表示できます。
アプリケーションのデプロイ時にJava Tomcatを設定する
アプリケーションを再デプロイすると、アプリケーションは再起動されます。 業務中断などの予測できないエラーを防ぐため、オフピーク時にアプリケーションをデプロイすることを推奨します。
アプリケーションを更新するために実行できる手順は、アプリケーション内のインスタンスの数によって異なります。 このセクションでは、インスタンス数が1以上のアプリケーションに必要な機能を設定する方法の例を示します。 インスタンス数が0のアプリケーションの更新方法については、「アプリケーションの更新」をご参照ください。
SAEコンソールにログインします。
左側のナビゲーションウィンドウで、[アプリケーション] をクリックします。 上部のナビゲーションバーで、リージョンを選択します。 次に、管理するアプリケーションの名前をクリックします。
の右上隅に基本情報ページをクリックします。アプリケーションのデプロイ.
[Java Tomcatの設定] セクションで、[カスタム設定] を選択し、[編集] をクリックします。
では、Java Tomcat設定の編集パネル、パラメータを設定し、OK.
パラメーター
説明
アプリケーションポート
アプリケーションによって使用されるポート番号。 有効な値: 1024〜49151。 デフォルト値: 8080
Tomcatコンテキスト
アプリケーションのアクセスパス。 有効な値:
パッケージ名: WARファイルの名前が使用されます。 このパラメーターを設定する必要はありません。 この設定は、[ファイルのアップロード方法] パラメーターを [WARパッケージのアップロード] に設定した場合にのみサポートされます。
ルートディレクトリ: アプリケーションのアクセスパスは /です。
カスタム: [カスタムパス] フィールドでアプリケーションのアクセスパスを指定します。
最大スレッド数
リクエストを同時に処理するスレッドの最大数。 有効な値: 10 ~ 1024 デフォルト値: 400
重要Maximum Threadsパラメーターの値は、アプリケーションのパフォーマンスに影響します。 このパラメーターの設定は、慎重に行ってください。
Tomcatエンコーディング
Tomcatのエンコード形式。The encoding format for Tomcat. 有効な値: UTF-8、ISO-8859-1、GBK、GB2312。 デフォルト値: ISO-8859-1
URLにボディエンコーディングを使用
デフォルトでは、この機能は有効になっています。 この場合、HTTPリクエスト本文の文字セットを使用して、クエリパラメーター (QueryString) をデコードできます。
設定後、をクリックします。確認.
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構成ファイルを変更する方法を示します。
変更します。Modify theserver.xmlファイルを作成します。
SAEコンソールにログインします。
左側のナビゲーションウィンドウで、[アプリケーション] をクリックします。 上部のナビゲーションバーで、リージョンを選択します。 次に、アプリケーションの名前をクリックします。
[基本情報] ページで、[インスタンスのデプロイ情報] タブをクリックします。 [デフォルトグループ] セクションで、アプリケーションの [操作] 列の [Webshell] をクリックします。
Webshellウィンドウで、server.xmlファイルしてウィンドウを閉じます。
次のコマンドを実行して、server.xmlファイルが保存されているディレクトリに移動します。
cd /home/admin/apache-tomcat-8.5.42/conf
次のコマンドを実行して、server.xmlファイルの内容を表示します。
cat server.xml
server.xmlファイルのコンテンツをオンプレミスのコンピューターにコピーし、ビジネス要件に基づいてファイルのコンテンツを変更してから、新しいコンテンツをコピーします。
ConfigMapを作成します。
説明作成するConfigMapの名前空間は、ConfigMapを作成するアプリケーションの名前空間と同じである必要があります。
左側のナビゲーションウィンドウで、[名前空間] をクリックします。 上部のナビゲーションバーで、リージョンを選択します。 次に、アプリケーションの名前空間の名前をクリックします。
左側のナビゲーションウィンドウで、[ConfigMaps] をクリックします。 [ConfigMaps] ページで、[作成] をクリックします。
ConfigMapの作成パネルで、パラメーターを設定します。 server.xmlファイルの新しいコンテンツを [値] テキストボックスにコピーし、[OK] をクリックします。
この例では、MethodパラメーターはManualに設定されています。 下表に、各パラメーターを説明します。 詳細については、「Kubernetes ConfigMapの管理」をご参照ください。
パラメーター 説明 ConfigMap名 ConfigMapの名前を入力します。 ConfigMapの説明 ConfigMapの説明を入力します。 マッピングの設定 - キーの長さは最大250文字です。 値の長さは最大10,000文字です。
- ConfigMapには最大20個のキーと値のペアを指定できます。
ConfigMapを作成すると、ConfigMapページにConfigMapが表示されます。
アプリケーションをデプロイし、ConfigMapをマウントします。
左側のナビゲーションウィンドウで、[名前空間の詳細] をクリックします。 [名前空間の詳細] ページで、[リソース情報] タブをクリックします。
[アプリケーション] の値をクリックします。 [アプリケーション] ページで、デプロイするアプリケーションをクリックします。
基本情報ページの右上隅で、[アプリケーションのデプロイ] をクリックします。
[アプリケーションのデプロイ] ページの下部で、[設定管理] セクションをクリックし、[ステップ2] で設定した [設定マップ] と [キー] を選択し、[マウントパス] パラメーターを指定します。
パラメーターの設定後、[確認] をクリックします。
[レコードの変更] ページに移動して、アプリケーションのデプロイメントステータスを確認できます。
Verify the results
SAEコンソールにログインします。
左側のナビゲーションウィンドウで、[アプリケーション] をクリックします。 上部のナビゲーションバーで、リージョンを選択します。 次に、管理するアプリケーションの名前をクリックします。
設定が有効かどうかを確認します。
方法 1:
[基本情報] ページの左側のナビゲーションウィンドウで、[レコードの変更] をクリックします。 [レコードの変更] ページで、変更の詳細を表示します。 [ステータスの変更] 列に [実行] が表示されている場合、アプリケーションがデプロイされ、設定が有効になります。
方法 2:
[基本情報] ページで、[インスタンスのデプロイ情報] タブをクリックし、インスタンスの [ステータス] を表示します。 [ステータス] 列に [実行中] が表示されている場合、アプリケーションがデプロイされ、設定が有効になります。