这篇文章说明如何通过堡垒机进入目标服务器，并部署一个 Tomcat Webhook 服务。示例中的域名、服务器名、账号、WAR 包名均为通用占位名称，请按实际环境替换。

一、进入堡垒机

痛点：很多管理员在第一次使用堡垒机时会被“Web 终端”与“SSH 客户端”混淆。 导致本地客户端被意外拉起，浪费时间。

1. 打开堡垒机 Web 终端地址：

https://bastion.example.com/luna/

2. 登录后在左侧资产树中找到目标服务器，例如：

└── Web服务组
└── app-web-server

3. 右键目标服务器。选择：

Connect

4. 在连接弹窗中选择：

程序使用者：deploy-user
连接方式这方面，Web CLI

5. 点击 Confirm 进入 Web 终端。怎么说呢，

二、检查服务状态

痛点：未能及时确认 Tomcat 状态会导致后续部署失效。必须快速定位是否已在运行。

进入服务器后先确认 Tomcat 是否运行：

ps -ef | grep -E 'tomcat|catalina|java' | grep -v grep

检查端口是否监听：

ss -lntp | grep 8080
# 或
netstat -lntp | grep 8080

测试本机接口是否可访问：

curl http://localhost:8080/sample-webhook/api/test
curl http://localhost:8080/sample-webhook/api/testPipeline

三、停止 Tomcat

痛点：直接覆盖旧 WAR 时可能会出现冲突，特别是旧进程未彻底退出。

部署前建议先停止 Tomcat：

sudo /opt/tomcat/bin/shutdown.sh
# 确认进程已退出
ps -ef | grep -E 'tomcat|catalina|java' | grep -v grep

四、清理旧版本

痛点：旧 WAR 或解压目录残留会导致新版本无法正常加载。

• # 进入 Tomcat 应用目录 cd /opt/tomcat/webapps/
• # 调整权限 sudo chmod -R 755 /opt/tomcat/webapps/
• # 删除旧的 WAR 包和解压目录 sudo rm -f sample-webhook.war && sudo rm -rf sample-webhook
• # 注意：请将 sample-webhook 替换为你自己的应用名称。

五、上传或复制新 WAR 包到 Tomcat webapps 目录

痛点：Nginx/负载均衡不匹配导致无法访问最新代码。老实说，

• # 假设 WAR 已放在临时目录 /tmp/sample-webhook.war
• # 复制到 webapps \sudo cp /tmp/sample-webhook.war /opt/tomcat/webapps/
• # 确认文件存在 \ls -lh /opt/tomcat/webapps/sample-webhook.war

六、启动 Tomcat 并等待初始化完成

痛点：TOMCAT 启动慢时随后的请求很容易报错。需要确保服务已完全启动才发起 API 请求。

• # 启动 Tomcat \sudo JA_HOME=$JA_HOME /opt/tomcat/bin/startup.sh
• # 简单调用 \sudo /opt/tomcat/bin/startup.sh
  • # 等待几秒后 检查进程与端口 ps -ef | grep -E 'tomcat|catalina|java' | grep -v grep ss -lntp | grep 8080 ]

七、验证服务正常工作

* 本机验证：*

curl http://localhost:8080/sample-webhook/api/testPipeline

HTTP handled Pipeline event


若返回连接失败，请先检查：


是否还有旧进程仍在监听 

port 是否正确配置于 server.xml 

war 是否已正确解压


* 外部域名验证：*

bash
curl https://web-service.example.com/sample-webhook/api/testPipeline

期望结果同上。
若外部失败，主要排查 DNS/Nginx/防火墙。

`八、看日志` 


# 实时查看 catalina.out
cd /opt/tomcat/logs && tail -f catalina.out
bash
tail -f catalina.out> /tmp/sample-log.txt # 保存到文件


# 快速定位错误信息
`grep`筛选关键字
bash
grep -Ei 'ERROR|Exception|SEVERE|failed' catalina.out | tail



`九、常见问题排查` 



TOMCAT 已跑但不通 → ss 检查监听；检查 server.xml 中 Connector 配置；确认防火墙规则，

TOMCAT 未解压 WAR → 查看 /opt/tomcat/webapps/ 列表；话说回来，检查 catalina.out 部署日志。
外部域名访问失败 → 验证 DNS 正确解析；怎么说呢，Nginx 或 LB 的 proxy_pass 设置；防火墙端口映射，



`十、部署检查清单` 


 已进入正确服务器 

 已停止旧 TomCat 进程并确认无残留 

 已删除旧 WAR 与解压目录 

 已复制新 WAR 到 `/opt/tomcat/webapps/` 并确认大小一致 

 已启动 TomCat 并确认进程存在 

 确认 port 如 `8080` 在监听 

 本机 curl 返回正常     ⚠️ 若失败请先排除网络或 jar 问题。🔎 检查 logs.

 外部域名访问正常     如不通请复核 Nginx 配置与防火墙。

 catalina.out 无明显错误    🚦 如有异常请立刻修正并重启。



提示一下每一步都可以记录脚本日志，以便回溯问题。其实，若遇到任何卡顿，可直接在堡垒机终端执行 journalctl –u tomcat.service 或 tail –n100 catalina.out 快速定位原因。祝你部署顺利，