全部产品
Search
文档中心

云服务器 ECS:手动部署Java Web环境(Tomcat)

更新时间:Jan 02, 2025

Java Web是一种使用Java语言开发动态Web应用程序的技术栈,它利用Java平台的强大功能,结合各种技术和框架,使得开发者能够创建复杂、高性能、可跨平台部署的Web应用。在Java Web开发中,Tomcat是常用的开源Web服务器,用于部署和运行Java Web应用程序。本文介绍如何在ECS实例中部署Java Web环境。

快速部署

您可以单击一键运行进入Terraform Explorer查看并执行Terraform代码,从而实现自动化地在ECS实例中部署Java Web环境(Tomcat)。

准备工作

部署Java Web环境时,已有ECS实例必须满足以下条件:

  • 实例已部署Java环境。关于如何部署Java环境,请参见部署Java环境

  • 实例已分配固定公网IP地址或绑定弹性公网IP(EIP)。具体操作,请参见弹性公网IP

  • 若您的实例为Linux系统,实例安全组的入方向规则需放行22、8080端口。

    若您的实例为Windows系统,实例安全组的入方向规则需放行3389、8080端口。

    具体操作,请参见添加安全组规则

  • 若您的实例为Linux系统,需要您关闭实例的系统防火墙、SELinux。具体操作,请参见开启或关闭Linux系统防火墙开启或关闭SELinux

    若您的实例为Windows系统,需要您关闭实例的系统防火墙。具体操作,请参见管理Windows系统防火墙

操作方案

您可以根据实例的系统,选择合适的方案。

Linux

本文以安装Apache Tomcat 9.0.91为例。若您安装其他版本,或使用其他目录,您需要根据实际版本及目录替换命令中的版本及路径。

  1. 登录Linux服务器。具体操作,请参见ECS远程连接方式概述

  2. 运行以下命令,下载并解压Tomcat 9安装包。

    说明
    • Tomcat下载地址官网会持续更新。如果下方下载地址失效,请您直接访问Tomcat官网获取。

    • 若您需要安装其他版本,可以访问Tomcat官网获取下载地址,替换命令中的URL。

    wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.91/bin/apache-tomcat-9.0.91.tar.gz  --no-check-certificate 
    tar -zxvf apache-tomcat-9.0.91.tar.gz
  3. 运行以下命令,移动Tomcat所在目录。

    sudo mv apache-tomcat-9.0.91 /usr/local/tomcat/
  4. (可选)配置server.xml文件。

    若您需要修改Tomcat的相关配置,可以参考如下操作。

    1. 运行以下命令,打开/usr/local/tomcat/conf/server.xml文件。

      vim /usr/local/tomcat/conf/server.xml
    2. i键,进入编辑模式。本示例使用Tomcat的默认配置。您也可以根据需求,修改Tomcat的相关配置。例如:

      • Tomcat默认使用8080端口,如果您需要修改端口号,可以修改port的属性值。

        说明

        修改端口后,您需要在实例的安全组中放行修改后的端口,具体操作,请参见添加安全组规则

        image

      • Tomcat默认的网站根目录为webapps,当您将一个Web应用程序(例如一个WAR文件或一个包含WEB-INF目录的文件夹)放到webapps目录下时,Tomcat会自动部署这个应用。如果您需要修改Tomcat的网站根目录,可以修改appBase的属性值。image

    3. 修改完成后,按Esc键,输入:wq并回车以保存并关闭文件。

  5. (可选)设置JVM内存参数。

    若您需要根据需求设置Tomcat的JVM内存参数,以优化Tomcat的性能、稳定性等,可以参考如下操作。

    1. 运行以下命令,创建并打开/usr/local/tomcat/bin/setenv.sh文件。

      vim /usr/local/tomcat/bin/setenv.sh
    2. i键,添加以下内容。

      指定JAVA_OPTS参数,用于设置JVM的内存信息以及编码格式。本示例将编码格式设置为UTF-8。

      说明

      您可以根据需求调整以下内容,以更好地设置JVM内存参数。

      JAVA_OPTS='-Djava.security.egd=file:/dev/./urandom -server -Xms512m -Xmx512m -Dfile.encoding=UTF-8'
    3. Esc键,输入:wq,按Enter键保存并关闭文件。

    4. 为文件添加可执行权限。

      sudo chmod +x /usr/local/tomcat/bin/setenv.sh
  6. 设置Tomcat自启动脚本。

    1. 运行以下命令,下载Tomcat自启动脚本文件。

      wget https://help-static-aliyun-doc.aliyuncs.com/software/Tomcat-init.sh
    2. 运行以下命令,移动并重命名Tomcat-init.sh

      sudo mv Tomcat-init.sh /etc/init.d/tomcat
    3. 运行以下命令,为/etc/init.d/tomcat添加可执行权限。

      chmod +x /etc/init.d/tomcat
    4. 获取安装的JDK路径。运行以下命令,获取Java二进制文件的真实路径,其父目录则为安装的JDK路径。

      readlink -f $(which java)
      说明

      例如执行命令后返回/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.432.b06-2.0.2.1.al8.x86_64/jre/bin/java,则安装的JDK路径为/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.432.b06-2.0.2.1.al8.x86_64

    5. 运行以下命令,设置启动脚本JAVA_HOME

      重要

      脚本中JDK的路径信息必须与您安装的JDK路径保持一致,否则Tomcat会启动失败。

      sudo sed -i 's@^export JAVA_HOME=.*@export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.432.b06-2.0.2.1.al8.x86_64@' /etc/init.d/tomcat
  7. 依次运行以下命令,设置Tomcat开机自动启动,并启动Tomcat。

    sudo systemctl daemon-reload
    sudo systemctl start tomcat
    sudo systemctl enable tomcat

    启动后,您可以执行sudo systemctl status tomcat查看Tomcat当前状态,返回active(running)则说明Tomcat启动成功。image

  8. 验证环境配置。

    在本地浏览器地址栏中,输入http://公网IP:8080,成功进入Tomcat欢迎页,则说明环境配置成功。

    说明
    • 若输入http://公网IP:8080后无法显示下述页面,请检查安全组,确保入方向已放行8080端口。

    • 若您修改过Tomcat的端口,请将8080替换为修改后的端口,并检查安全组是否放行该端口。

    • 若您想上传本地项目进行测试,可以将WAR包上传至Tomcat的网站根目录(本文中默认为/usr/local/tomcat/webapps),并在浏览器输入http://公网IP:8080/包名访问项目。具体操作,请参见上传或下载文件(Linux)

    image

Windows

本文以安装Apache Tomcat 9.0.97为例。

  1. 登录Windows服务器。具体操作,请参见ECS远程连接方式概述

  2. 下载Tomcat。

    访问Tomcat官网,选择相应的版本,下载安装包。

    image

  3. 解压Tomcat压缩包。

    将下载的压缩包解压到您希望安装Tomcat的位置。本文以C:\Program Files为例。

  4. 获取Tomcat安装目录。

    解压后,您可以进入解压后的目录,在地址栏获取到Tomcat的安装目录。

    image

  5. 配置环境变量。

    1. 右键单击此电脑,选择属性image

    2. 关于页滚动至最下方,单击高级系统设置

      image

    3. 单击环境变量

      image

    4. 系统变量区域,单击新建,创建系统变量,完成后单击确定。变量名为CATALINA_HOME,变量值为Tomcat安装目录,例如C:\Program Files\apache-tomcat-9.0.97

      image

    5. 系统变量中找到Path变量,选中并单击编辑

      image

    6. 编辑环境变量中单击新建,添加%CATALINA_HOME%\bin

      image

    7. 单击两次确定,保存环境变量配置。

      image

  6. 启动Tomcat。

    1. 进入Tomcat安装目录下的bin文件夹。image

    2. 在路径栏输入cmd,按下回车,打开命令提示符。image

    3. 执行命令startup.bat启动Tomcat,命令执行后,默认会打开一个新的命令提示符窗口,以显示Tomcat的启动日志信息,请勿关闭此窗口。

      image

      image

  7. 验证Tomcat。

    在本地浏览器输入http://公网IP:8080,进入Tomcat欢迎页,则说明Tomcat部署成功。

    说明
    • 若输入http://公网IP:8080后无法显示下述页面,请您排查以下问题:

      • 请检查安全组,确保入方向已放行8080端口。

      • 请确认执行startup.bat命令启动Tomcat后,默认打开的命令提示符窗口是否被关闭,若窗口已关闭,请您重新执行startup.bat命令开启此窗口。

    • 若您想上传本地项目进行测试,可以将WAR包上传至Tomcat的网站根目录(本文中默认为C:\Program Files\apache-tomcat-9.0.97\webapps),并在浏览器输入http://公网IP:8080/包名访问项目。具体操作,请参见上传或下载文件(Linux)

    image