本文中含有需要您注意的重要提示信息,忽略該信息可能對您的業務造成影響,請務必仔細閱讀。
當您使用WAR包部署應用時,您可以根據需求自定義Tomcat參數,包括應用端口、應用訪問路徑以及最大線程數等信息。本文介紹如何在SAE控制臺為基于WAR部署的Java應用設置Java Tomcat參數。
前提條件
在設置Java Tomcat的相關參數之前,請確保您已準備Java應用程序的WAR包文件。
操作步驟
在創建應用過程中配置Tomcat
登錄SAE控制臺。
在左側導航欄,選擇 ,在頂部菜單欄選擇地域,然后單擊創建應用。
在應用基本信息配置向導,設置應用相關信息,并單擊下一步:應用部署配置。
在應用部署配置配置向導,配置應用部署信息。
配置項 說明 技術棧語言 選擇Java。 應用部署方式 選擇WAR包部署。 應用運行環境 - apache-tomcat-XXX:適用于Spring Boot或Dubbo應用。
- EDAS-Container-XXX:適用于HSF應用。
Java環境 Dragonwell X(推薦):支持OpenJDK,支持應用啟動及運行時加速,提升GC效率等。更多信息,請參見設置啟動命令。
Open 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 Tomat設置面板,配置相關信息,單擊確定。
配置項
說明
應用端口
默認為8080,取值范圍[1024,49151]。
Tomcat Context
選擇應用訪問的路徑。
程序包名字:無需填寫自定義路徑,應用的訪問路徑是WAR包名稱。文件上傳方式為上傳WAR包時可以選擇。
根目錄:應用的訪問路徑是/。
自定義:在自定義路徑區域設置應用需要訪問的路徑。
最大線程數
設置并發處理請求的最大線程數。默認為400,取值范圍為[10, 1024]。
重要最大線程數會直接影響應用性能,請謹慎設置。
Tomcat編碼
Tomcat的編碼格式,包括UTF-8、ISO-8859-1、GBK和GB2312,默認為ISO-8859-1。
Use Body Encoding for URL
默認選中,選中后可以根據HTTP Body設置的字符集解碼查詢參數(QueryString)。
單擊下一步:確認規格。
在確認規格配置向導,查看您所創建應用的詳細信息以及配置費用情況,并單擊確認創建。
頁面會跳轉至創建完成配置向導,您可以單擊應用詳情頁進入基本信息頁面,查看已創建的應用的基本信息。
在部署應用過程中配置Tomcat
重新部署應用后,該應用將會被重啟。為避免業務中斷等不可預知的錯誤,請在業務低峰期執行部署操作。
更新應用配置的路徑因實例數的不同而不同。本文以實例數大于等于1為例,介紹如何配置目標功能。當實例數等于0時的操作路徑,請參見更新應用。
登錄SAE控制臺。
在左側導航欄,選擇 ,在頂部菜單欄選擇地域,然后單擊目標應用名稱。
在基本信息頁面右上角,單擊部署應用。
展開Java Tomcat設置區域,選中自定義配置,單擊編輯。
在編輯Java Tomat設置面板,配置相關信息,單擊確定。
配置項
說明
應用端口
默認為8080,取值范圍[1024,49151]。
Tomcat Context
選擇應用訪問的路徑。
程序包名字:無需填寫自定義路徑,應用的訪問路徑是WAR包名稱。文件上傳方式為上傳WAR包時可以選擇。
根目錄:應用的訪問路徑是/。
自定義:在自定義路徑區域設置應用需要訪問的路徑。
最大線程數
設置并發處理請求的最大線程數。默認為400,取值范圍為[10, 1024]。
重要最大線程數會直接影響應用性能,請謹慎設置。
Tomcat編碼
Tomcat的編碼格式,包括UTF-8、ISO-8859-1、GBK和GB2312,默認為ISO-8859-1。
Use Body Encoding for URL
默認選中,選中后可以根據HTTP Body設置的字符集解碼查詢參數(QueryString)。
配置完成后,單擊確認。
利用配置項修改Tomcat配置文件
如果SAE控制臺提供的以上Tomcat參數配置無法滿足您的需求,或者您需要修改其他的Tomcat配置文件,您可以通過掛載配置項來實現。
通過WAR包成功部署SAE應用后,Tomcat的server.xml文件會位于/home/admin/apache-tomcat-8.5.42/conf目錄下。本文以server.xml文件為例,介紹如何利用配置項修改Tomcat配置文件。
修改server.xml文件內容。
登錄SAE控制臺。
在左側導航欄,選擇 ,在頂部菜單欄選擇地域,然后單擊具體應用名稱。
在基本信息頁面,單擊實例部署信息頁簽,在默認分組區域單擊實例操作列的Webshell。
在Webshell窗口修改server.xml文件內容,并關閉窗口。
執行以下命令,進入server.xml文件所在的目錄。
cd /home/admin/apache-tomcat-8.5.42/conf
執行以下命令,查看server.xml文件內容。
cat server.xml
復制server.xml的文件內容至本地,按需修改后再次復制。
創建配置項。
說明配置項與目標應用所在的命名空間需保持一致。
在應用列表頁面左側導航欄,單擊命名空間(環境),在頂部菜單欄選擇地域,然后單擊具體命名空間名稱。
在左側導航欄,單擊配置項,然后在配置項頁面,單擊創建。
在創建配置項面板,輸入相關參數,在值文本框內粘貼修改后的server.xml文件內容,并單擊確定。
本文以默認顯示的手工創建方式為例。參數說明如下。更多信息,請參見管理和使用配置項(K8s ConfigMap)。
配置項 說明 配置項名稱 自定義。 配置項描述 自定義。 配置映射 - 鍵的長度不超過250個字符,值的長度不超過10,000個字符。
- 一個配置項最多可以填寫20個鍵值對。
創建的配置項將顯示在配置項頁面。
部署應用并掛載配置項。
在左側導航欄單擊命名空間詳情,在命名空間詳情頁面單擊資源信息頁簽。
單擊具體的應用數數值,在應用列表頁面單擊目標應用。
在基本信息頁面右上角,單擊部署應用。
在部署應用頁面下方,展開配置管理區域,選擇步驟2創建的配置項名稱與鍵,并輸入掛載路徑。
配置完成后,單擊確認。
您可以在變更詳情頁面查看應用部署的執行狀態。
結果驗證
登錄SAE控制臺。
在左側導航欄,選擇 ,在頂部菜單欄選擇地域,然后單擊目標應用名稱。
通過以下方式驗證配置是否生效。
方式一:
在應用基本信息頁面的左側導航欄,單擊變更記錄,在變更記錄頁面,查看應用變更詳情。如果顯示執行成功,表示應用部署成功,配置已生效。
方式二:
在應用基本信息頁面,單擊實例部署信息頁簽,查看實例的運行狀態。如果運行狀態顯示為Running,表示應用部署成功,配置已生效。