webapp-runner使用指南 编辑此页面



Webapp Runner 是基于Tomcat server的。默认Rainbond支持的版本如下:

web服务支持 web服务版本 自定义Procfile中jar文件名
tomcat7 webapp-runner- webapp-runner.jar
tomcat8 webapp-runner- webapp-runner.jar
tomcat85 (默认) webapp-runner- webapp-runner.jar
tomcat9 webapp-runner- webapp-runner.jar
jetty7 jetty-runner-7.5.4.v20111024.jar jetty-runner.jar
jetty9 jetty-runner-9.4.0.v20161208.jar jetty-runner.jar




# Procfile
$ java -jar ./webapp-runner.jar --session-store memcache target/<appname>.war



# Procfile
java -jar ./webapp-runner.jar --session-store redis target/<appname>.war



# Procfile
java -jar ./webapp-runner.jar --path /phone target/<appname>.war


$ java -jar webapp-runner.jar --help
The specified path "src/main/webapp" does not exist.
Usage: <main class> [options]
      Enables AccessLogValue to STDOUT
      Default: false
       If --access-log is enabled, sets the logging pattern
       Default: common
       Password to be used with basic auth. Defaults to BASIC_AUTH_PW env
       Username to be used with basic auth. Defaults to BASIC_AUTH_USER env
       Controls when the socket used by the connector is bound. By default it is
       bound when the connector is initiated and unbound when the connector is
       destroyed., default value: true
       Default: true
       Comma delimited list of mime types that will be compressed when using
       GZIP compression.
       Default: text/html,text/xml,text/plain,text/css,application/json,application/xml,text/javascript,application/javascript
       The path to the context xml to use.
       Secure the app with basic auth. Use with --basic-auth-user and
       --basic-auth-pw or --tomcat-users-location
       Default: false
       Specify -Djavax.net.ssl.keyStore and -Djavax.net.ssl.keyStorePassword in
       Default: false
       Enable GZIP compression on responses
       Default: false
       Enables JNDI naming
       Default: false
       Specify -Djavax.net.ssl.keyStore, -Djavax.net.ssl.keyStorePassword,
       -Djavax.net.ssl.trustStore and -Djavax.net.ssl.trustStorePassword in JAVA_OPTS. Note: should not be
       used if a reverse proxy is terminating SSL for you (such as on Heroku)
       Default: false
       Expand the war file and set it as source
       Default: true
       The name of the directory the WAR file will be expanded into.
       Default: expanded

       Default: false
       Set the maximum number of worker threads
       Default: 0
       The context path
       Default: <empty string>
       The port that the server will accept http requests on.
       Default: 8080
       Set proxy URL if tomcat is running behind reverse proxy
       Default: <empty string>
       Set jar scanner scan bootstrap classpath.
       Default: false
      Session store to use (valid options are 'memcache' or 'redis')
      Request pattern to not track sessions for. Valid only with memcache
      session store. (default is '.*\.(png|gif|jpg|css|js)$'. Has no effect
      for 'redis')
      Default: .*\.(png|gif|jpg|css|js)$
      Session locking mode for use with memcache session store. (default is
      all. Has no effect for 'redis')
      Default: all
      Operation timeout for the memcache session store. (default is 5000ms)
      Default: 5000
      Pool size of the session store connections (default is 10. Has no effect
      for 'memcache')
      Default: 10
      The number of minutes of inactivity before a user's session is timed
      Overrides the default behavior and casues Tomcat to ignore lifecycle
      failure events rather than shutting down when they occur.
      Default: false
      Define the temp directory, default value: ./target/tomcat.PORT
      Location of the tomcat-users.xml file. (relative to the location of the
      webapp-runner jar file)
      Set the URI encoding to be used for the Connector.
      Set if the entity body encoding should be used for the URI.
      Default: false
      Allows setting HTTP connector attributes. For example: -Acompression=on
      Syntax: -Akey=value
      Default: {}

关于设置设置HTTP连接属性,如 -Acompression=on,可以参考 Apache Attributes