本篇教程介绍如何手动在ECS实例上部署Java web项目，适用于刚开始使用阿里云进行建站的个人用户。

前提条件

  • 已注册阿里云账号。如还未注册，请先完成账号注册。
  • 如果在中国内地地域中使用云服务器ECS，请确保账号已完成实名认证。如还未认证，请先完成实名认证。
  • 已创建一台ECS实例。详细步骤请参见使用向导创建实例。

背景信息

本篇教程在示例步骤中使用了以下实例规格和软件版本。操作时，请您以实际软件版本为准。
  • 实例规格：ecs.c6.large
  • 操作系统：CentOS 7.4
  • Tomcat 版本：Tomcat 8.5.53
    说明 本示例中，使用Tomcat 8.5.53版本为例。源代码版本会不断升级，您可以获取合适的安装包版本。
  • JDK 版本：JDK 1.8.0_241
  • FTP工具：Winscp

点我去体验

步骤一：下载源代码

  1. 下载Apache Tomcat。
  2. 下载JDK。
    1. 下载JDK安装压缩包。
      说明 如果在实例中执行 wget命令下载JDK安装压缩包，但在解压时报错，您可以下载JDK安装压缩包，再上传到ECS实例上。
    2. 登录ECS管理控制台。
    3. 在左侧导航栏，选择实例与镜像 > 实例。
    4. 选择已购ECS实例所在的地域。
    5. 在实例列表页面，找到已购ECS实例，在IP 地址列获取该实例的公网IP地址。
    6. 在Winscp工具里使用公网IP地址连接Linux实例。
    7. 将下载好的Apache Tomcat和JDK安装压缩包上传到Linux实例的根目录下。

步骤二：安装前准备

  1. 在安全组入方向添加规则放行所需端口。具体步骤，请参见添加安全组规则。
    例如本示例中，SSH协议的22端口和HTTP协议的8080端口。
  2. 远程连接Linux实例。具体步骤，请参见通过密码认证登录Linux实例。
  3. 关闭防火墙。
    1. 运行systemctl status firewalld命令查看当前防火墙的状态。
      查看防火墙状态
      • 如果防火墙的状态参数是inactive，则防火墙为关闭状态。
      • 如果防火墙的状态参数是active，则防火墙为开启状态。本示例中防火墙为开启状态，因此需要关闭防火墙。
    2. 关闭防火墙。如果防火墙为关闭状态可以忽略此步骤。
      • 如果您想临时关闭防火墙，运行命令systemctl stop firewalld。
        说明 这只是暂时关闭防火墙，下次重启Linux后，防火墙还会开启。
      • 如果您想永久关闭防火墙，运行命令systemctl disable firewalld。
        说明 如果您想重新开启防火墙，具体操作，请参见 firewalld官网信息。
  4. 关闭SELinux。
    1. 运行命令getenforce查看SELinux的当前状态。
      查看SELinux状态
      • 如果SELinux状态参数是Disabled， 则SELinux为关闭状态。
      • 如果SELinux状态参数是Enforcing，则SELinux为开启状态。本示例中SELinux为开启状态，因此需要关闭SELinux。
    2. 关闭SELinux。如果SELinux为关闭状态可以忽略此步骤。
      • 如果您想临时关闭SELinux，运行命令setenforce 0。
        说明 这只是暂时关闭SELinux，下次重启Linux后，SELinux还会开启。
      • 如果您想永久关闭SELinux，运行命令vi /etc/selinux/config编辑SELinux配置文件。回车后，把光标移动到SELINUX=enforcing这一行，按i键进入编辑模式，修改为SELINUX=disabled， 按Esc键，然后输入:wq并回车来保存并关闭SELinux配置文件。
        说明 如果您想重新开启SELinux，具体操作，请参见 开启或关闭SELinux。
    3. 重启系统使设置生效。
  5. 为保证系统安全性，建议创建一般用户来运行Tomcat。
    例如，本示例中创建一般用户www。
    1
    useradd www
  6. 运行以下命令创建网站根目录。
    1
    mkdir -p /data/wwwroot/default
  7. 将需要部署的Java Web项目文件WAR包上传到网站根目录下，然后将网站根目录下文件所属用户改为www。
    本示例中，将依次运行以下命令直接在网站根目录下新建一个Tomcat测试页面，并将网站根目录下文件所属用户改为www。
    1
    echo Tomcat test > /data/wwwroot/default/index.jsp
    1
    chown -R www.www /data/wwwroot

步骤三：安装JDK

  1. 运行以下命令新建一个目录。
    1
    mkdir /usr/java
  2. 依次运行以下命令为jdk-8u241-linux-x64.tar.gz添加可执行权限并解压到/usr/java。
    1
    chmod +x jdk-8u241-linux-x64.tar.gz
    1
    tar xzf jdk-8u241-linux-x64.tar.gz -C /usr/java
  3. 设置环境变量。
    1. 运行命令vi /etc/profile打开/etc/profile文件。
    2. 按下i键，添加以下内容。
      1
      2
      3
      4
      # set java environment
      export JAVA_HOME=/usr/java/jdk1.8.0_241
      export CLASSPATH=$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib
      export PATH=$JAVA_HOME/bin:$PATH
    3. 按下Esc键，输入:wq并回车以保存并关闭文件。
  4. 运行以下命令加载环境变量。
    1
    source /etc/profile
  5. 运行以下命令显示JDK版本信息。
    1
    java -version
    返回结果如图所示，表示JDK已经安装成功。 jdk180241

步骤四：安装Apache Tomcat

  1. 依次运行以下命令。
    1. 解压apache-tomcat-8.5.53.tar.gz。
      1
      tar xzf apache-tomcat-8.5.53.tar.gz
    2. 重命名Tomcat目录。
      1
      mv apache-tomcat-8.5.53 /usr/local/tomcat/
    3. 设置文件的所属用户。
      1
      chown -R www.www /usr/local/tomcat/
    在 /usr/local/tomcat/目录下：
    • bin：存放Tomcat的一些脚本文件，包含启动和关闭Tomcat服务脚本。
    • conf：存放Tomcat服务器的各种全局配置文件，其中最重要的是server.xml和web.xml。
    • webapps：Tomcat的主要Web发布目录，默认情况下把Web应用文件放于此目录。
    • logs：存放Tomcat执行时的日志文件。
  2. 配置server.xml文件。
    1. 运行以下命令切换到/usr/local/tomcat/conf/目录。
      1
      cd /usr/local/tomcat/conf/
    2. 运行以下命令重命名server.xml文件。
      1
      mv server.xml server.xml_bk
    3. 新建一个server.xml文件。
      1. 运行命令vi server.xml创建server.xml文件。
      2. 按下i键，添加以下内容。
        1
        2
        3
        4
        5
        6
        7
        8
        9
        10
        11
        12
        13
        14
        15
        16
        17
        18
        19
        20
        21
        22
        23
        24
        25
        26
        27
        28
        29
        30
        31
        32
        33
        34
        35
        36
        37
        38
        39
        40
        <?xml version="1.0" encoding="UTF-8"?>
        <Server port="8006" shutdown="SHUTDOWN">
        <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener"/>
        <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener"/>
        <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener"/>
        <Listener className="org.apache.catalina.core.AprLifecycleListener"/>
        <GlobalNamingResources>
        <Resource name="UserDatabase" auth="Container"
         type="org.apache.catalina.UserDatabase"
         description="User database that can be updated and saved"
         factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
         pathname="conf/tomcat-users.xml"/>
        </GlobalNamingResources>
        <Service name="Catalina">
        <Connector port="8080"
         protocol="HTTP/1.1"
         connectionTimeout="20000"
         redirectPort="8443"
         maxThreads="1000"
         minSpareThreads="20"
         acceptCount="1000"
         maxHttpHeaderSize="65536"
         debug="0"
         disableUploadTimeout="true"
         useBodyEncodingForURI="true"
         enableLookups="false"
         URIEncoding="UTF-8"/>
        <Engine name="Catalina" defaultHost="localhost">
        <Realm className="org.apache.catalina.realm.LockOutRealm">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
          resourceName="UserDatabase"/>
        </Realm>
        <Host name="localhost" appBase="/data/wwwroot/default" unpackWARs="true" autoDeploy="true">
        <Context path="" docBase="/data/wwwroot/default" debug="0" reloadable="false" crossContext="true"/>
        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
        prefix="localhost_access_log." suffix=".txt" pattern="%h %l %u %t &quot;%r&quot; %s %b" />
        </Host>
        </Engine>
        </Service>
        </Server>
      3. 按Esc键，输入:wq并回车以保存并关闭文件。
  3. 设置JVM内存参数。
    1. 运行vi /usr/local/tomcat/bin/setenv.sh命令创建/usr/local/tomcat/bin/setenv.sh文件。
    2. 按下i键，添加以下内容。
      指定 JAVA_OPTS参数，用于设置JVM的内存信息以及编码格式。
      1
      JAVA_OPTS='-Djava.security.egd=file:/dev/./urandom -server -Xms256m -Xmx496m -Dfile.encoding=UTF-8'
    3. 按下Esc键，输入:wq并回车以保存并关闭文件。
  4. 设置Tomcat自启动脚本。
    1. 运行以下命令下载Tomcat自启动脚本。
      说明 该脚本来源于社区，仅供参考。阿里云对其可靠性以及操作可能带来的潜在影响，不做任何暗示或其他形式的承诺。如果您运行 wget命令下载失败，您可以通过浏览器访问 https://raw.githubusercontent.com/oneinstack/oneinstack/master/init.d/Tomcat-init直接获取脚本内容。
      1
      wget https://raw.githubusercontent.com/oneinstack/oneinstack/master/init.d/Tomcat-init
    2. 运行以下命令重命名Tomcat-init。
      1
      mv Tomcat-init /etc/init.d/tomcat
    3. 运行以下命令为/etc/init.d/tomcat添加可执行权限。
      1
      chmod +x /etc/init.d/tomcat
    4. 运行以下命令设置启动脚本JAVA_HOME。
      注意 脚本中JDK的版本信息必须与您安装的JDK版本信息一致，否则Tomcat会启动失败。
      1
      sed -i 's@^export JAVA_HOME=.*@export JAVA_HOME=/usr/java/jdk1.8.0_241@' /etc/init.d/tomcat
  5. 运行以下命令设置Tomcat开机自启动。
    1
    2
    chkconfig --add tomcat
    chkconfig tomcat on
  6. 运行以下命令启动Tomcat。
    1
    service tomcat start
  7. 在浏览器地址栏中输入http://公网IP:8080进行访问。
    返回页面如下图所示，表示安装成功。 返回结果

后续步骤

Tomcat可用后，建议您为ECS实例的公网IP地址绑定域名，配置网站等。