在 Idea 中配置远程 tomcat 并部署

清疚 2023-05-29 02:24 24阅读 0赞

# 1. 前言 #

在项目开发过程中，需要访问某公司的接口，由于将我们公司自己服务器的 IP 配置成了发起请求的主机 IP，所以只有在服务器上运行的项目请求那个接口才能请求成功。我们平常开发都是在自己电脑本地的 tomcat 中运行项目，这样显然不能访问该公司的接口，但是如果在本地编译完再部署到服务器上测试就太浪费时间了。所以需要在 Idea 中配置服务器上的tomcat，这样在本地写完代码之后，点击运行，项目就直接是跑在服务器上的了，省去了中间的部署过程。  
所以就有了今天这篇文章。

# 2. 环境 #

本地环境：

*  OS：Windows 10
 *  tomcat 9.0.26
 *  java 1.8.0\_201
 *  Idea 2017.3

服务器环境：

*  OS：CentOS7.6
 *  tomcat 9.0.26
 *  java 1.8.0\_231

Idea 的帮助文档中有这样一句话：

> When working with a remote server, the same server version must be available locally.

我的理解是说本地 tomcat 版本要和服务器上的完全一致，不知道理解的对不对。为了与服务器保持一致，我把原来本地的 tomcat 9.0.14 换成了 tomcat 9.0.26。

还有一点要注意，那就是最好保证你的服务器上只有一个 tomcat 在使用。我在这个地方吃了很多亏。

# 3. 修改服务器 tomcat 的启动脚本catalina.sh #

通常我们启动 tomcat 时，本质上都是运行的 statup.sh，但是现在需要远程部署，启动脚本要换成 catalina.sh。

打开服务器 tomcat 安装目录下的 bin 目录，通常是 `/usr/local/apache-tomcat-9.0.26/bin`，里面有一个脚本文件 catalina.sh，打开这个脚本文件后，在开头的地方加入下面这段代码：

CATALINA_OPTS="-Dcom.sun.management.jmxremote 
    -Dcom.sun.management.jmxremote.port=1099 
    -Dcom.sun.management.jmxremote.ssl=false 
    -Dcom.sun.management.jmxremote.authenticate=false 
    -Djava.rmi.server.hostname=<IPAddress>"
    export CATALINA_OPTS

其中的 <IPAddress> 就是你服务器的 IP 地址，1099 这个端口要记住，一会儿还要用到。

修改完成后来到 catalina.sh 所在的目录，使用下面这个命令运行该脚本，启动 tomcat：

./catalina.sh run > /dev/null 2>&1 &

如果出现下图中的提示，则说明启动成功。图中的 6595 是 tomcat 的进程号。  
![在这里插入图片描述][20191101142512968.png]  
也可以用 `jps` 命令查看：  
![在这里插入图片描述][20191101142752832.png]  
tomcat 运行起来之后，我们在本地浏览器中输入 http://<IPAddress>:8080 进行访问，可以看到熟悉的 tomcat 主页：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70]

# 4. 配置本地 Idea #

在 Idea 右上角找到下图中的这个按钮：  
![在这里插入图片描述][20191101144001580.png]  
点击左上角的 +，添加一个远程 tomcat：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 1]  
然后开始配置。

第一步：Run / Debug Configuration -> Server：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 2]  
第二步：Deployment -> Connection：  
点击上图中 Host 右边的 … ，会出现 Deployment 对话框：  
点击左上角的 +，添加远程主机，Type 选 SFTP。然后可以看到下图中的界面：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 3]  
第三步：Deployment -> Mappings：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 4]  
第四步：Run / Debug Configuration -> Deployment：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 5]  
至此，Idea 的配置就完成了。

# 5. 运行 #

运行项目  
![在这里插入图片描述][20191101151856112.png]  
若看到控制台输出以下内容，则说明配置远程 tomcat 成功！  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 6]  
在浏览器中访问服务器的 tomcat，就可以打开本地编写的项目了。

本地代码如下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 7]  
浏览器界面：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 8]

# 6. 参考链接 #

1.  [idea部署项目到远程tomcat][idea_tomcat]
2.  [Idea 2017.3 帮助文档 - Run/Debug Configuration: Tomcat Server][Idea 2017.3 _ - Run_Debug Configuration_ Tomcat Server]  
    **注：** 如果你的 Idea 是其他版本的话，Idea 的配置过程可能会略有不同，具体可以参考相应 Idea 版本的帮助文档，只需把链接中的 2017.3 改成你自己的 Idea 的版本即可

[20191101142512968.png]: https://img-blog.csdnimg.cn/20191101142512968.png
[20191101142752832.png]: https://img-blog.csdnimg.cn/20191101142752832.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20191101143340509.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ==,size_16,color_FFFFFF,t_70
[20191101144001580.png]: https://img-blog.csdnimg.cn/20191101144001580.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20191101151646346.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20191101144844305.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20191101150337554.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/20191101150746500.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 5]: https://img-blog.csdnimg.cn/20191101151028354.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ==,size_16,color_FFFFFF,t_70
[20191101151856112.png]: https://img-blog.csdnimg.cn/20191101151856112.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 6]: https://img-blog.csdnimg.cn/20191101152136180.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 7]: https://img-blog.csdnimg.cn/20191101152451920.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ_size_16_color_FFFFFF_t_70 8]: https://img-blog.csdnimg.cn/20191101152509207.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lvdW5nMjQxNQ==,size_16,color_FFFFFF,t_70
[idea_tomcat]: https://blog.csdn.net/tianjun2012/article/details/52795202
[Idea 2017.3 _ - Run_Debug Configuration_ Tomcat Server]: https://www.jetbrains.com/help/idea/2017.3/run-debug-configuration-tomcat-server.html