5.3.9.1. 部署 WAR 至 Heroku
Heroku 账号




首先，使用浏览器在 Heroku 创建一个账号，免费账号类型 hobby-dev 已经足够使用。然后登录账号，并且点击界面顶部的 New 按钮创建新项目。



选择一个唯一的名称（或者这个字段空着等着自动分配）并且选择一个服务器地址。然后 Heroku 会创建一个应用，比如 morning-beach-4895。



第一次使用的时候，Heroku 会切换到 Deploy 标签页，选择使用 Heroku 的 Git 部署方式。



Heroku CLI




-
在电脑安装 Heroku CLI。

-
切换到 CUBA 项目目录。接下来这个目录会用 $PROJECT_FOLDER 来代称。

-
在 $PROJECT_FOLDER 目录打开命令行窗口并输入：




  1. heroku login





-
按提示输入用户名密码。下面的步骤应该不需要再给这个项目输入用户名密码了。

-
安装 Heroku CLI 插件：




  1. heroku plugins:install heroku-cli-deploy







PostgreSQL 数据库




使用浏览器访问 Heroku 数据 网页



可以选择已有的 Postgres 数据库或者创建一个新的。以下步骤描述怎么创建一个新数据库。



-
找到 Heroku Postgres 区域点击 Create one

-
然后新界面点击 Install Heroku Postgr…​

-
下拉列表选择 Heroku 应用程序并连接数据库

-
选择账号付费计划（比如 hobby-dev）



或者也可以通过 Heroku CLI 来安装 PostgreSQL：





  1. heroku addons:create heroku-postgresql:hobby-dev —app morning-beach-4895






这里的 morning-beach-4895 是 Heroku 应用的名称。



然后可以在 Resources 标签页看到新建的数据库。数据库已经连接 Heroku 应用程序。通过这个方式可以看到数据库的用户名密码：切换到 Heroku 数据库的 Datasource 界面，下翻到 Administration 区域然后点击 View credentials 按钮。





  1. Host compute.amazonaws.com
    Database d2tk
    User nmmd
    Port 5432
    Password 9c05
    URI postgres://nmmd:9c05@compute.amazonaws.com:5432/d2tk






项目部署设置




-
假设 CUBA 项目使用的是 PostgreSQL 数据库。

-
在 Studio 打开 CUBA 项目，在 CUBA 项目视图的 Deployment 部分双击 WAR settings 打开 WAR settings 窗口，按照下面的介绍对选项进行配置。


-
勾选 Build WAR

-
设置 application home 目录为 .（当前目录）

-
勾选 Include JDBC driver

-
勾选 Include Tomcat’s context.xml

-
点击 Custom context.xml path 旁边的 Generate 按钮，在弹窗中填写数据库连接信息

-
点开生成的 modules/core/web/META-INF/war-context.xml 文件，检查连接参数和用户名密码：









-
勾选 Single WAR for Middleware and Web Client

-
点击 Custom web.xml path 旁边的 Generate 按钮。

-
拷贝下面的代码然后粘贴到 App properties 字段：




  1. [
      'cuba.automaticDatabaseUpdate' : true
    ]





-
保存部署设置。




构建 WAR 文件




执行 buildWar Gradle 任务构建 WAR 文件：





  1. gradlew buildWar






通过 Studio 的 Build 菜单命令可以预先创建 Gradle wrapper 以便在命令行窗口使用 gradlew 命令。



应用程序配置




-
从 https://mvnrepository.com/artifact/com.github.jsimone/webapp-runner 下载 Tomcat Webapp Runner。Webapp Runner 的版本需要跟 Tomcat 的版本匹配，比如，Webapp Runner 8.5.11.3 版本能兼容 Tomcat 8.5.11 版本。下载下来的 JAR 包重命名成 webapp-runner.jar 然后放到 $PROJECT_FOLDER 目录。

-
从 https://mvnrepository.com/artifact/org.apache.tomcat/tomcat-dbcp 下载 Tomcat DBCP。版本需要能兼容 Tomcat 的版本，比如 8.5.11。创建 $PROJECT_FOLDER/libs 目录，将下载的 JAR 文件重命名为 tomcat-dbcp.jar 然后放到这个目录。

-
在 $PROJECT_FOLDER 目录创建新文件 Procfile。文件包含如下内容：




  1. web: java $JAVA_OPTS -cp webapp-runner.jar:libs/ webapp.runner.launch.Main —enable-naming —port $PORT build/distributions/war/app.war







Git 配置




在 $PROJECT_FOLDER 目录打开终端窗口，运行以下命令：





  1. git init
    heroku git:remote -a morning-beach-4895
    git add .
    git commit -am "Initial commit"






应用部署




打开终端窗口，运行以下命令：



在 nix 系统：





  1. heroku jar:deploy webapp-runner.jar —includes libs/tomcat-dbcp.jar:build/distributions/war/app.war —app morning-beach-4895






Windows 系统：





  1. heroku jar:deploy webapp-runner.jar —includes libs\tomcat-dbcp.jar;build\distributions\war\app.war —app morning-beach-4895






在 Heroku 的 dashboard 打开 Resources 标签页。能看到一个新的 Dyno（Heroku 的服务实例），还有从 Procfile 读取出来的命令：



heroku dyno



应用程序现在正在部署了，可以查看日志了解部署进度。



日志监控




在命令行窗口等待弹出 https://morning-beach-4895.herokuapp.com/ deployed to Heroku 消息。



需要跟踪查看应用系统的日志，可以使用以下命令：





  1. heroku logs —tail —app morning-beach-4895






部署成功之后，可以通过浏览器访问类似 https://morning-beach-4895.herokuapp.com 这样的 URL 来访问服务。

或者可以通过 Heroku dashboard 的 Open app 按钮打开应用。