文档

手动部署Java Web环境(Alibaba Cloud Linux 3)

更新时间:

本篇教程介绍如何在Alibaba Cloud Linux 3系统的ECS实例上部署Java web项目,适用于刚开始使用阿里云进行建站的个人用户。

准备工作

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

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

  • 操作系统必须为Alibaba Cloud Linux 3。

  • 实例安全组的入方向规则已放行22、80、443、8080端口。具体操作,请参见添加安全组规则

步骤一:关闭防火墙和SELinux

  1. 远程连接Linux实例。

  2. 关闭防火墙。

    1. 运行以下命令,查看当前防火墙的状态。

      systemctl status firewalld
      查看防火墙状态
      • 如果防火墙的状态参数是inactive,则防火墙为关闭状态。

      • 如果防火墙的状态参数是active,则防火墙为开启状态。本示例中防火墙为开启状态,因此需要关闭防火墙。具体操作如下:

        • 如果您想临时关闭防火墙,运行以下命令。

          sudo systemctl stop firewalld
          说明

          这只是暂时关闭防火墙,下次重启Linux后,防火墙还会开启。

        • 如果您想永久关闭防火墙,运行以下命令。

          sudo systemctl disable firewalld
          说明

          如果您想重新开启防火墙,请参见firewalld官网信息

  3. 关闭SELinux。

    1. 运行以下命令,查看SELinux的当前状态。

      getenforce
      • 如果SELinux状态参数是Disabled, 则SELinux为关闭状态。

      • 如果SELinux状态参数是Enforcing,则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的官方文档

步骤二:安装JDK

JDK为Java开发工具包,本文以JDK 1.8.0_351为例。

  1. 运行以下命令,通过yum命令查找JDK软件包。

    yum -y list java*
  2. 运行以下命令,安装JDK软件包。

    本示例以安装JDK 1.8.0为例。

    sudo yum -y install java-1.8.0-openjdk-devel.x86_64
  3. 运行以下命令,查看JDK版本。

    java -version

    本示例中版本信息如下所示。

    openjdk version "1.8.0_372"
    OpenJDK Runtime Environment (build 1.8.0_372-b07)
    OpenJDK 64-Bit Server VM (build 25.372-b07, mixed mode)
  4. 运行以下命令,查看JDK安装后的路径。

    find /usr/lib/jvm -name 'java-1.8.0-openjdk-1.8.0*'

    返回信息类似如下所示。

    /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.372.b07-4.0.2.al8.x86_64
  5. 配置Java环境变量。

    1. 运行以下命令,打开配置文件。

      sudo vim /etc/profile
    2. i键进入编辑模式。

    3. 在配置文件末尾,添加以下信息。

      JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.372.b07-4.0.2.al8.x86_64
      PATH=$PATH:$JAVA_HOME/bin
      CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
      export JAVA_HOME CLASSPATH PATH

      其中:JAVA_HOME需要改为JDK安装的路径。具体路径,请参见步骤4

    4. Esc键,输入:wq,按Enter键保存并关闭文件。

    5. 运行以下命令,立即生效环境变量。

      source /etc/profile

步骤三:安装Apache Tomcat

Apache Tomcat为Web应用服务器,本文以安装Apache Tomcat 8.5.83为例。

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

    wget https://archive.apache.org/dist/tomcat/tomcat-8/v8.5.88/bin/apache-tomcat-8.5.88.tar.gz  --no-check-certificate 
    tar -zxvf apache-tomcat-8.5.88.tar.gz
    说明

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

  2. 运行以下命令,移动Tomcat所在目录。

    sudo mv apache-tomcat-8.5.88 /usr/local/tomcat/
  3. 配置server.xml文件。

    1. 运行以下命令,切换到/usr/local/tomcat/conf/目录。

      cd /usr/local/tomcat/conf/
    2. 运行以下命令,重命名server.xml文件。

      mv server.xml server.xml_bk
    3. 新建一个server.xml文件。

      1. 运行以下命令,创建并打开server.xml文件。

        vim server.xml
      2. i键,添加以下内容。

        <?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并回车以保存并关闭文件。

  4. 设置JVM内存参数。

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

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

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

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

  5. 设置Tomcat自启动脚本。

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

      说明

      该脚本来源于社区,仅供参考。阿里云对其可靠性以及操作可能带来的潜在影响,不做任何暗示或其他形式的承诺。如果您运行wget命令下载失败,您可以通过浏览器访问https://raw.githubusercontent.com/oneinstack/oneinstack/master/init.d/Tomcat-init直接获取脚本内容。

      wget https://raw.githubusercontent.com/oneinstack/oneinstack/master/init.d/Tomcat-init
    2. 运行以下命令,移动并重命名Tomcat-init。

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

      chmod +x /etc/init.d/tomcat
    4. 运行以下命令,设置启动脚本JAVA_HOME。

      重要

      脚本中JDK的路径信息必须与您安装的JDK路径保持一致,否则Tomcat会启动失败。具体路径,请参见步骤4

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

    sudo chkconfig --add tomcat
    sudo chkconfig tomcat on
  7. 运行以下命令,启动Tomcat。

    sudo service tomcat start

    回显信息类似如下所示,表示启动Tomcat成功。

    Starting tomcat
    Using CATALINA_BASE:   /usr/local/tomcat
    Using CATALINA_HOME:   /usr/local/tomcat
    Using CATALINA_TMPDIR: /usr/local/tomcat/temp
    Using JRE_HOME:        /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.372.b07-4.0.2.al8.x86_64
    Using CLASSPATH:       /usr/local/tomcat/bin/bootstrap.jar:/usr/local/tomcat/bin/tomcat-juli.jar
    Using CATALINA_OPTS:   
    Tomcat started.
    Tomcat is running with pid: 4517

步骤四:部署测试项目并验证

将需要部署的Java Web项目文件WAR包上传到网站根目录下,您可以使用支持文件传输功能的远程连接工具或搭建FTP站点上传项目文件。

本示例中,网站根目录为/data/wwwroot/default,运行以下命令直接在网站根目录下新建一个Tomcat测试页面,并进行访问。

  1. 运行以下命令,创建网站根目录。

    mkdir -p /data/wwwroot/default
  2. 运行以下命令,新建测试文件。

    echo sh -c Tomcat test > /data/wwwroot/default/index.jsp 'echo "${vSGX_ip_addr} grpc.tf-serving.service.com" >> /etc/hosts'
  3. 在本地浏览器地址栏中,输入http://公网IP:8080,查看环境配置是否成功。

    返回页面如下图所示,表示环境配置成功。返回结果

常见问题

如果Java Web环境无法访问,您可以参考以下思路排查问题:

  • ECS实例中的安全组中是否放行Tomcat默认使用的8080端口。具体操作,请参见添加安全组规则

  • Java安装路径配置是否正确。您可以执行命令find /usr/lib/jvm -name 'java-1.8.0-openjdk-1.8.0*'查看Java安装路径。涉及Java安装路径的配置主要涉及2处,具体请参见设置Java环境变量设置启动脚本JAVA_HOME

  • 本页导读 (1)
文档反馈