本篇教程介绍如何手动在ECS实例上部署Java web项目,适用于刚开始使用阿里云进行建站的个人用户。
前提条件
- 已注册阿里云账号。如还未注册,请先完成账号注册。
- 如果在中国内地地域中使用云服务器ECS,请确保账号已完成实名认证。如还未认证,请先完成实名认证。
- 已创建一台ECS实例。详细步骤,请参见自定义购买实例。
背景信息
本篇教程在示例步骤中使用了以下实例规格和软件版本。操作时,请您以实际软件版本为准。
- 实例规格:ecs.c6.large
- 操作系统:CentOS 7.4
- Tomcat 版本:Tomcat 8.5.95
- JDK 版本:JDK 1.8.0_342
- FTP工具:WinSCP
说明:本示例中,使用Tomcat 8.5.95版本为例。源代码版本会不断升级,您可以获取合适的安装包版本。
操作步骤
步骤一:安装前准备
1.在安全组入方向添加规则放行所需端口。具体步骤,请参见添加安全组规则。
例如本示例中,SSH协议的22端口和HTTP协议的8080端口。
2.远程连接Linux实例。
具体操作,请参见通过密码或密钥认证登录Linux实例。
3.关闭防火墙。
a.运行systemctl status firewalld命令查看当前防火墙的状态。
- 如果防火墙的状态参数是inactive,则防火墙为关闭状态。
- 如果防火墙的状态参数是active,则防火墙为开启状态。本示例中防火墙为开启状态,因此需要关闭防火墙。
b.关闭防火墙。如果防火墙为关闭状态可以忽略此步骤。
- 如果您想临时关闭防火墙,运行以下命令。
systemctl stop firewalld
说明 该操作只是暂时关闭防火墙,下次重启Linux后,防火墙还会开启。
- 如果您想永久关闭防火墙,需要依次运行以下命令。
i)关闭当前运行中的防火墙。
systemctl stop firewalld
ii)关闭防火墙服务,在下次重启实例后,防火墙服务将不会开机自启动。
systemctl disable firewalld
说明 该操作会关闭防火墙服务,当您重新启动实例后,防火墙将会默认保持关闭状态。 如果您想重新开启防火墙,具体操作,请参见firewalld官网信息。
4.关闭SELinux。
a.运行命令以下命令查看SELinux的当前状态。
getenforce
查看结果示例,如下图所示:
- 如果SELinux状态参数是Disabled, 则SELinux为关闭状态。
- 如果SELinux状态参数是Enforcing,则SELinux为开启状态。本示例中SELinux为开启状态,因此需要关闭SELinux。
b.关闭SELinux。如果SELinux为关闭状态可以忽略此步骤。
- 如果您想临时关闭SELinux,运行以下命令。
setenforce 0
说明 该操作只是暂时关闭SELinux,下次重启Linux后,SELinux还会开启。
- 如果您想永久关闭SELinux,运行以下命令打开SELinux配置文件。
vi /etc/selinux/config
在/etc/selinux/config文件内,将光标移动到SELINUX=enforcing
一行,按i键进入编辑模式,修改为SELINUX=disabled
,然后按Esc键,再输入:wq
并回车,保存关闭SELinux配置文件。
说明 如果您想重新开启SELinux,具体操作,请参见开启或关闭SELinux。
c.重启系统使设置生效。
步骤二:安装JDK
1.执行以下命令,查看yum源中JDK版本。
yum list java*
2.执行以下命令,使用yum安装JDK1.8.0。
yum -y install java-1.8.0-openjdk*
3.执行以下命令,查看是否安装成功。
java -version
如果显示如下所示,则表示JDK安装成功。
[root@iZuspq7vnxm**** ~]# java -version openjdk version "1.8.0_342" OpenJDK Runtime Environment (build 1.8.0_342-b07) OpenJDK 64-Bit Server VM (build 25.342-b07, mixed mode)
4.配置环境变量。
a.运行以下命令,查看JDK安装的路径。
find /usr/lib/jvm -name 'java-1.8.0-openjdk-1.8.0*'
回显信息如下所示。
[root@test000****~]# find /usr/lib/jvm -name 'java-1.8.0-openjdk-1.8.0*' /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.342.b07-1.el7_9.x86_64
b.打开配置文件。
vim /etc/profile
c.在配置文件末尾,按i进入编辑模式。
d.添加以下信息。
说明 : JAVA_HOME
值为当前JDK安装的路径。
JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.342.b07-1.el7_9.x86_64 PATH=$PATH:$JAVA_HOME/bin CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar export JAVA_HOME CLASSPATH PATH
e.按下Esc键,输入:wq
并回车以保存并关闭文件。
f.运行以下命令,立即生效环境变量。
source /etc/profile
重要 :
修改环境变量后,可能会导致执行其他命令时,出现类似-bash: chmod: command not found
这样的问题,执行export PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/root/bin即可。
步骤三:安装Apache Tomcat
1.运行以下命令,下载并解压Tomcat 8安装包。
wget --no-check-certificate https://dlcdn.apache.org/tomcat/tomcat-8/v8.5.95/bin/apache-tomcat-8.5.95.tar.gz
说明 :Tomcat下载地址官网会持续更新。如果上述下载地址失效,请您直接访问Tomcat官网获取。
2.运行以下命令,移动Tomcat所在目录。
mv apache-tomcat-8.5.88 /usr/local/tomcat/
3.为保证系统安全性,建议创建一般用户来运行Tomcat。
例如,本示例中创建一般用户www。
useradd www
4.运行以下命令,将文件的所属用户设置为www。
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执行时的日志文件。
5.配置server.xml文件。
a.运行以下命令,切换到/usr/local/tomcat/conf/目录。
cd /usr/local/tomcat/conf/
b.运行以下命令,重命名server.xml文件。
mv server.xml server.xml_bk
c.新建一个server.xml文件。
i)运行以下命令,创建并打开server.xml文件。
vi server.xml
ii)按下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 "%r" %s %b" /> </Host> </Engine> </Service> </Server>
iii)按Esc键,输入:wq
并回车以保存并关闭文件。
6.设置JVM内存参数。
a.运行以下命令,创建并打开/usr/local/tomcat/bin/setenv.sh文件。
vi /usr/local/tomcat/bin/setenv.sh
b.按下i键,添加以下内容。
指定JAVA_OPTS
参数,用于设置JVM的内存信息以及编码格式。
JAVA_OPTS='-Djava.security.egd=file:/dev/./urandom -server -Xms256m -Xmx496m -Dfile.encoding=UTF-8'
c.按下Esc键,输入:wq
并回车以保存并关闭文件。
7.设置Tomcat自启动脚本。
a.运行以下命令,下载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
直接获取脚本内容。
b.运行以下命令,移动并重命名Tomcat-init。
mv Tomcat-init /etc/init.d/tomcat
c.运行以下命令,为/etc/init.d/tomcat添加可执行权限。
chmod +x /etc/init.d/tomcat
d.运行以下命令,设置启动脚本JAVA_HOME。
sed -i 's@^export JAVA_HOME=.*@export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.342.b07-1.el7_9.x86_64@' /etc/init.d/tomcat
重要 :脚本中JDK的版本信息必须与您安装的JDK版本信息一致,否则Tomcat会启动失败。
8.依次运行以下命令,设置Tomcat开机自启动。
chkconfig --add tomcat chkconfig tomcat on
9.运行以下命令,启动Tomcat。
service tomcat start
- 回显信息类似如下所示,表示启动Tomcat成功。
[root@test000**** conf]# service tomcat start 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.342.b07-1.el7_9.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: 11837
步骤四:部署测试项目并验证
将需要部署的Java Web项目文件WAR包上传到网站根目录下,并将网站根目录下文件所属用户改为www。您可以使用支持文件传输功能的远程连接工具或搭建FTP站点上传项目文件。本示例中,网站根目录为/data/wwwroot/default,运行以下命令直接在网站根目录下新建一个Tomcat测试页面,并进行访问。
1.运行以下命令,创建网站根目录。
mkdir -p /data/wwwroot/default
2.运行以下命令,将网站根目录的所属用户设置为www。
chown -R www.www /data/wwwroot
3.运行以下命令,新建测试文件。
echo Tomcat test > /data/wwwroot/default/index.jsp
4.root使配置生效。
5.在本地浏览器地址栏中输入http://公网IP:8080
进行访问。
返回页面如下图所示,表示安装成功。如果无法访问,请确保已在安全组中放行Tomcat默认使用的8080端口。具体操作,请参见添加安全组规则。
后续步骤
Tomcat可用后,建议您为ECS实例的公网IP地址绑定域名,配置网站等。