文字

概述

Webapp Runner可以在任何安装有JRE环境的系统中利用Tomcat将应用程序启动。使用Webapp Runner不需要安装Tomcat。它只是一个jar文件可以用java命令运行和配置。

这篇文档将会教您如何构建应用程序,并通过Wepapp Runner启动,最终部署到好雨云平台。

您可以按照下面的每一步从头开始构建一个应用程序,或者直接跳到最后浏览文章源码。当然你也可以使用大多数现有的Maven webapp项目。

Webapp Runner 是如何工作的?

在本地或好雨云平台使用Webapp Runner启动应用程序时的命令类似如下格式:

$ java -jar webapp-runner.jar application.war
deploying app from: /Users/zhouyq/dev/gitrepos/java-webapp-runner/target/webappRunnerSample.war
Feb 14, 2015 5:21:44 PM org.apache.coyote.AbstractProtocol init
INFO: Initializing ProtocolHandler ["http-bio-8080"]
Feb 14, 2015 5:21:44 PM org.apache.catalina.core.StandardService startInternal
INFO: Starting service Tomcat
Feb 14, 2015 5:21:44 PM org.apache.catalina.core.StandardEngine startInternal
INFO: Starting Servlet Engine: Apache Tomcat/7.0.57
Feb 14, 2015 5:21:44 PM org.apache.catalina.startup.ContextConfig webConfig
INFO: No global web.xml found
Feb 14, 2015 5:21:44 PM org.apache.coyote.AbstractProtocol start
INFO: Starting ProtocolHandler ["http-bio-8080"]

Webapp Runner 会利用给定的war文件启动一个Tomcat实例。它会使用Tomcat提供的内嵌API来把程序跑起来,与Jetty Runner提供的选项有些类似。 Webapp Runner 是 开源 软件,你可以随时查阅项目源码。

创建应用程序

$ mvn archetype:generate -DarchetypeArtifactId=maven-archetype-webapp
...
[INFO] Generating project in Interactive mode
Define value for property 'groupId': : com.example
Define value for property 'artifactId': : helloworld

(你可以使用任意的 groupId 或 artifactId)。执行完上面的命令后,helloworld目录会生成一个完整的Java web 应用。

配置Maven下载Webapp Runner

通过构建配置文件(pom.xml)可以下载Webapp Runner,通过这种方式可以自动解决依赖关系,提高程序的灵活性与可移植性。在这里我们使用 Maven 因此需要使用依赖插件(maven-dependency-plugin)来下载jar包。将如下的配置添加到你的pom.xml文件中:

<build>
    ...
    <plugins>
        ...
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-dependency-plugin</artifactId>
            <version>2.3</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals><goal>copy</goal></goals>
                    <configuration>
                        <artifactItems>
                            <artifactItem>
                                <groupId>com.github.jsimone</groupId>
                                <artifactId>webapp-runner</artifactId>
                                <version>7.0.57.2</version>
                                <destFileName>webapp-runner.jar</destFileName>
                            </artifactItem>
                        </artifactItems>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

Webapp Runner 是基于 Tomcat server的,因此 7.0.57.2 版本的 Webapp Runner 使用的是 7.0.57 版本的Tomcat。Tomcat 8 Beta测试版本对应 8.0.18.0-M1 版本的 Webapp Runner.

运行程序

先运行如下简单的命令构建应用程序:

$ mvn clean package

然后通过java命令运行起来:

$ java -jar target/dependency/webapp-runner.jar target/*.war

就这么简单,你的应用程序已经运行并监听8080端口

说明

如果你需要在启动应用之前展开WAR文件,需要在启动命令的 target/*.war选项之前添加 --expand-war

将应用部署到好雨云平台

创建Procfile文件

您需要在项目跟目录创建 Procfile 文件来描述如何启动您的应用程序,该文件只是一个简单的文本文件,通过如下方式将启动命令写到Procfile文件中:

cd helloworld
echo "web: java \$JAVA_OPTS -jar target/dependency/webapp-runner.jar --port \$PORT target/*.war" > Procfile

注意

$JAVA_OPTS 与 $PORT 变量必须添加,否则程序无法在平台上跑起来。

可选的 JDK 版本

平台默认会使用 OpenJDK 1.8 如果您想使用1.7版本,可以通过system.properties文件设置java.runtime.version=1.7选项, system.properties文件的内容类似如下格式:

java.runtime.version=1.7

您可以指定 1.6, 1.7, 或 1.8 (1.8 beta版本) 分别对应 Java 6, 7, 或 8

将更改提交到git

创建应用

参见: 新建应用文档

提交代码

$ git init
$ git add .
$ git commit -m "Ready to deploy"

# 下面的仓库地址根据用户的情况自行更改
$ git remote add origin http://code.goodrain.com/app/项目名称.git
$ git push -u origin master

更多关于提交代码的文档参见: 新建应用-代码提交

一键部署

参见: 一键部署文档

访问应用

直接点击 应用概览页的 “访问” 按钮,打开应用首页

上一篇: 下一篇:
  页面正在加载中