5.3.5. 部署 WAR 至 Tomcat Linux 服务

以下示例在 Ubuntu 16.04 测试通过

  1. build.gradle 末尾添加 buildWar 任务。可以指定不同的 context.xml 文件来设置生产环境数据库连接:

    task buildWar(type: CubaWarBuilding) {
        appHome = '${catalina.base}/work'
        singleWar = true
        includeContextXml = true
        includeJdbcDriver = true
        appProperties = ['cuba.automaticDatabaseUpdate': true]
        webXmlPath = 'modules/web/web/WEB-INF/single-war-web.xml'
        coreContextXmlPath = 'modules/core/web/META-INF/war-context.xml'
    }

    如果目标 Tomcat 服务的参数跟快速部署里用到的本地 Tomcat 的参数不同,需要提供相应的应用程序属性。比如,如果目标 Tomcat 运行在 9999 端口,任务定义会是这样:

    task buildWar(type: CubaWarBuilding) {
        appHome = './app_home'
        singleWar = false
        includeContextXml = true
        includeJdbcDriver = true
        appProperties = [
            'cuba.automaticDatabaseUpdate': true,
            'cuba.webPort': 9999,
            'cuba.connectionUrlList': 'http://localhost:9999/app-core'
        ]
    }
  2. 执行 buildWar Gradle 任务。会在项目 build/distributions 目录生成 app.war 文件。

    gradlew buildWar
  3. 安装 Tomcat 8 Linux Service:

    sudo apt-get install tomcat8
  4. 拷贝项目生成的 app.war 文件到 Tomcat 服务的 /var/lib/tomcat8/webapps 目录。

    Tomcat 服务默认是使用 tomcat8 用户来启动的。所以 webapps 目录的所有者也是 tomcat8

  5. 创建配置文件 /usr/share/tomcat8/bin/setenv.sh 包含以下设置:

    export CATALINA_OPTS="$CATALINA_OPTS -Xmx1024m"
  6. 重启 Tomcat 服务:

    sudo service tomcat8 restart
  7. 在浏览器打开 http://localhost:8080/app