前言
整理這個(gè)官方翻譯的系列,原因是網(wǎng)上大部分的 tomcat 版本比較舊,此版本為 v11 最新的版本。
開源項(xiàng)目
從零手寫實(shí)現(xiàn) tomcat minicat 別稱【嗅虎】心有猛虎,輕嗅薔薇。
系列文章
web server apache tomcat11-01-官方文檔入門介紹
web server apache tomcat11-02-setup 啟動(dòng)
web server apache tomcat11-03-deploy 如何部署
web server apache tomcat11-04-manager 如何管理?
web server apache tomcat11-06-Host Manager App -- Text Interface
web server apache tomcat11-07-Realm Configuration
web server apache tomcat11-08-JNDI Resources
web server apache tomcat11-09-JNDI Datasource
web server apache tomcat11-10-Class Loader
...
簡(jiǎn)介
Tomcat 主機(jī)管理器應(yīng)用程序使您能夠在 Tomcat 中創(chuàng)建、刪除和管理虛擬主機(jī)。本操作指南最好與以下文檔一起使用:
- 虛擬主機(jī) How-To 獲取有關(guān)虛擬主機(jī)的更多信息。
- 主機(jī)容器 獲取有關(guān)虛擬主機(jī)的底層 XML 配置和屬性描述的更多信息。
Tomcat 主機(jī)管理器應(yīng)用程序是 Tomcat 安裝的一部分,默認(rèn)情況下可以使用以下上下文訪問:/host-manager。您可以以下列方式使用主機(jī)管理器:
- 利用圖形用戶界面,可通過以下地址訪問:{服務(wù)器}:{端口}/host-manager/html。
- 利用一組適用于腳本編寫的最小 HTTP 請(qǐng)求。您可以在以下地址訪問此模式:{服務(wù)器}:{端口}/host-manager/text。
這兩種方式都可以添加、刪除、啟動(dòng)和停止虛擬主機(jī)。通過使用 persist 命令可以持久化更改。本文檔重點(diǎn)介紹文本界面。有關(guān)圖形界面的更多信息,請(qǐng)參閱主機(jī)管理器應(yīng)用程序 -- HTML 界面。
配置管理器應(yīng)用程序訪問權(quán)限
以下描述使用 $CATALINA_HOME 來引用基本的 Tomcat 目錄。它是您安裝 Tomcat 的目錄,例如 C:\tomcat9 或 /usr/share/tomcat9。
主機(jī)管理器應(yīng)用程序需要具有以下角色之一的用戶:
- admin-gui - 對(duì)于圖形 Web 界面使用此角色。
- admin-script - 對(duì)于腳本 Web 界面使用此角色。
要啟用對(duì)主機(jī)管理器應(yīng)用程序文本界面的訪問權(quán)限,請(qǐng)為您的 Tomcat 用戶授予適當(dāng)?shù)慕巧騽?chuàng)建具有正確角色的新用戶。例如,打開 ${CATALINA_BASE}/conf/tomcat-users.xml 并輸入以下內(nèi)容:
<user username="test" password="chang3m3N#w" roles="admin-script"/>
無需進(jìn)行進(jìn)一步的設(shè)置?,F(xiàn)在,當(dāng)您訪問 {服務(wù)器}:{端口}/host-manager/text/${COMMAND} 時(shí),您可以使用創(chuàng)建的憑據(jù)登錄。例如:
$ curl -u ${USERNAME}:${PASSWORD} http://localhost:8080/host-manager/text/list
命令列表
支持以下命令:
- list
- add
- remove
- start
- stop
- persist
在以下子節(jié)中,假設(shè)用戶名和密碼為 test:test。對(duì)于您的環(huán)境,請(qǐng)使用前面部分創(chuàng)建的憑據(jù)。
List 命令
使用 list 命令查看您的 Tomcat 實(shí)例上可用的虛擬主機(jī)。
示例命令:
curl -u test:test http://localhost:8080/host-manager/text/list
示例響應(yīng):
OK - Listed hosts
localhost:
Add 命令
使用 add 命令添加新的虛擬主機(jī)。用于 add 命令的參數(shù):
- String name: 虛擬主機(jī)的名稱。必填
- String aliases: 虛擬主機(jī)的別名。
- String appBase: 將由此虛擬主機(jī)提供服務(wù)的應(yīng)用程序的基本路徑。提供相對(duì)或絕對(duì)路徑。
- Boolean manager: 如果為 true,則將 Manager 應(yīng)用程序添加到虛擬主機(jī)。您可以通過 /manager 上下文訪問它。
- Boolean autoDeploy: 如果為 true,則 Tomcat 會(huì)自動(dòng)重新部署放置在 appBase 目錄中的應(yīng)用程序。
- Boolean deployOnStartup: 如果為 true,則 Tomcat 會(huì)在啟動(dòng)時(shí)自動(dòng)部署放置在 appBase 目錄中的應(yīng)用程序。
- Boolean deployXML: 如果為 true,則會(huì)讀取并使用 /META-INF/context.xml 文件。
- Boolean copyXML: 如果為 true,則 Tomcat 會(huì)復(fù)制 /META-INF/context.xml 文件,并使用原始副本,而不管應(yīng)用程序的 /META-INF/context.xml 文件的更新。
示例命令:
curl -u test:test "http://localhost:8080/host-manager/text/add?name=www.awesomeserver.com&aliases=awesomeserver.com&appBase=/mnt/appDir&deployOnStartup=true"
示例響應(yīng):
add: Adding host [www.awesomeserver.com]
Remove 命令
使用 remove 命令刪除虛擬主機(jī)。用于 remove 命令的參數(shù):
- String name: 要?jiǎng)h除的虛擬主機(jī)的名稱。必填
示例命令:
curl -u test:test http://localhost:8080/host-manager/text/remove?name=www.awesomeserver.com
示例響應(yīng):
remove: Removing host [www.awesomeserver.com]
Start 命令
使用 start 命令啟動(dòng)虛擬主機(jī)。用于 start 命令的參數(shù):
- String name: 要啟動(dòng)的虛擬主機(jī)的名稱。必填
示例命令:
curl -u test:test http://localhost:8080/host-manager/text/start?name=www.awesomeserver.com
示例響應(yīng):
OK - Host www.awesomeserver.com started
Stop 命令
使用 stop 命令停止虛擬主機(jī)。用于 stop 命令的參數(shù):
- String name: 要停止的虛擬主機(jī)的名稱。必填
示例命令:
curl -u test:test http://localhost:8080/host-manager/text/stop?name=www.awesomeserver.com
示例響應(yīng):
OK - Host www.awesomeserver.com stopped
Persist 命令
使用 persist 命令將虛擬主機(jī)持久化到 server.xml 中。用于 persist 命令的參數(shù):
- String name: 要持久化的虛擬主機(jī)的名稱。必填
此功能默認(rèn)情況下處于禁用狀態(tài)。要啟用此選項(xiàng),您必須首先配置 Store
ConfigLifecycleListener 監(jiān)聽器。要執(zhí)行此操作,請(qǐng)將以下監(jiān)聽器添加到您的 server.xml 中:
<Listener className="org.apache.catalina.storeconfig.StoreConfigLifecycleListener"/>
示例命令:
curl -u test:test http://localhost:8080/host-manager/text/persist?name=www.awesomeserver.com
示例響應(yīng):
OK - Configuration persisted
示例手動(dòng)條目:文章來源:http://www.zghlxwxcb.cn/news/detail-855018.html
<Host appBase="www.awesomeserver.com" name="www.awesomeserver.com" deployXML="false" unpackWARs="false">
</Host>
參考資料
https://tomcat.apache.org/tomcat-11.0-doc/host-manager-howto.html文章來源地址http://www.zghlxwxcb.cn/news/detail-855018.html
到了這里,關(guān)于web server apache tomcat11-06-Host Manager App的文章就介紹完了。如果您還想了解更多內(nèi)容,請(qǐng)?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持TOY模板網(wǎng)!