• 用tsuru部署Java应用
  • 概述
  • 在tsuru中创建应用
  • 部署代码
    • WAR包部署
    • 通过Git部署
  • 切换Java版本
  • 设置应用的内存大小
  • 进一步探索

    用tsuru部署Java应用

    概述

    本文档是在tsuru中部署一个简单的Java应用的实战指南。例子应用原型由mvn生成，通过运行下面的命令生成：

    2.     $ mvn archetype:generate -DgroupId=io.tsuru.javasample -DartifactId=helloweb -DarchetypeArtifactId=maven-archetype-webapp

    也可以在tsuru服务器上部署任意其它的Java应用。另一个选择是直接下载在Github上的代码：https://github.com/tsuru/tsuru-java-sample。

    在tsuru中创建应用

    使用app-create命令创建应用：

    1.     $ tsuru app-create <app-name> <app-platform>

    对于Java来说，应用平台是，你猜，Java！让我们把应用起名为"helloweb"：

    1.     $ tsuru app-create helloweb java

    使用platform-list命令列出所有的可用的平台。使用app-list查看你所有的应用。

    1.     $ tsuru app-list
    2.     +-------------+-------------------------+------------------------------+
    3.     | Application | Units State Summary     | Address                      |
    4.     +-------------+-------------------------+------------------------------+
    5.     | helloweb    | 0 of 0 units in-service | helloweb.192.168.50.4.nip.io |
    6.     +-------------+-------------------------+------------------------------+

    部署代码

    Java平台的部署方式有两种：用户可以将WAR包上传到tsuru或者用常规的git push的方式部署。下面将会介绍这两种方法：

    WAR包部署

    使用mvn原型，可以很容易的用mvn package打包WAR文件，然后用户可以通过tsuru app-deploy去部署代码：

    1.     $ mvn package
    2.     $ cd target
    3.     $ tsuru app-deploy -a helloweb helloweb.war
    4.     Uploading files.... ok
    6.     ---- Building application image ----
    7.      ---> Sending image to repository (0.00MB)
    8.      ---> Cleaning up
    10.     ---- Starting 1 new unit ----
    11.      ---> Started unit 21c3b6aafa...
    13.     ---- Binding and checking 1 new units ----
    14.      ---> Bound and checked unit 21c3b6aafa
    16.     ---- Adding routes to 1 new units ----
    17.      ---> Added route to unit 21c3b6aafa
    19.     OK

    完成！现在我们可以访问tsuru app-list返回的项目地址。记得加上/helloweb/。也可以将应用部署到 / 下面，只需要将WAR重命名为ROOT.war并且重新部署：

    1.     $ mv helloweb.war ROOT.war
    2.     $ tsuru app-deploy -a helloweb ROOT.war
    3.     Uploading files... ok
    5.     ---- Building application image ----
    6.      ---> Sending image to repository (0.00MB)
    7.      ---> Cleaning up
    9.     ---- Starting 1 new unit ----
    10.      ---> Started unit 4d155e805f...
    12.     ---- Adding routes to 1 new units ----
    13.      ---> Added route to unit 4d155e805f
    15.     ---- Removing routes from 1 old units ----
    16.      ---> Removed route from unit d2811c0801
    18.     ---- Removing 1 old unit ----
    19.      ---> Removed old unit 1/1
    21.     OK

    这样就可以从应用的根地址访问helloworld应用了。

    通过Git部署

    对于Git部署的方式，需要将代码发送给tsuru，然后在那里编译。我们会配合mvn使用Jetty plugin。这么做需要创建一个Procfile并且输入以下的命令去启动应用：

    2.     $ cat Procfile
    3.     web: mvn jetty:run

    为了能在部署过程中编译应用的类，我们需要添加部署钩子。tsuru解析tsuru.yaml并且在部署阶段运行一些构建钩子。下面是helloweb应用的tsuru.yaml文件的内容：

    1.  $ cat tsuru.yaml
    2.     hooks:
    3.       build:
    4.         - mvn package

    添加完这些文件后，就可以部署应用了。app-info命令会显示一个Git远程地址。我们将代码推送到这个地址。

    1.     $ tsuru app-info -a helloweb
    2.     Application: helloweb
    3.     Repository: git@192.168.50.4.nip.io:helloweb.git
    4.     Platform: java
    5.     Teams: admin
    6.     Address: helloweb.192.168.50.4.nip.io
    7.     Owner: admin@example.com
    8.     Team owner: admin
    9.     Deploys: 2
    10.     Pool: theonepool
    11.     Units: 1
    12.     +------------+---------+
    13.     | Unit       | State   |
    14.     +------------+---------+
    15.     | 313458bb9d | started |
    16.     +------------+---------+
    18.     App Plan:
    19.     +---------------+--------+------+-----------+--------+---------+
    20.     | Name          | Memory | Swap | Cpu Share | Router | Default |
    21.     +---------------+--------+------+-----------+--------+---------+
    22.     | autogenerated | 0 MB   | 0 MB | 100       |        | false   |
    23.     +---------------+--------+------+-----------+--------+---------+

    "Repository"那行包含了我们需要的远程仓库的地址。 现在我们可以用Git push去推送应用的代码：

    1.     $ git push git@192.168.50.4.nip.io:helloweb.git master
    2.     Counting objects: 25, done.
    3.     Delta compression using up to 4 threads.
    4.     Compressing objects: 100% (19/19), done.
    5.     Writing objects: 100% (25/25), 2.59 KiB | 0 bytes/s, done.
    6.     Total 25 (delta 5), reused 0 (delta 0)
    7.     remote: tar: Removing leading `/' from member names
    8.     remote: [INFO] Scanning for projects...
    9.     remote: [INFO]
    10.     remote: [INFO] ------------------------------------------------------------------------
    11.     remote: [INFO] Building helloweb Maven Webapp 1.0-SNAPSHOT
    12.     remote: [INFO] ------------------------------------------------------------------------
    13.     remote: Downloading: http://repo.maven.apache.org/maven2/org/apache/maven/plugins/maven-resources-plugin/2.3/maven-resources-plugin-2.3.pom
    14.     remote: Downloaded: http://repo.maven.apache.org/maven2/org/apache/maven/plugins/maven-resources-plugin/2.3/maven-resources-plugin-2.3.pom (5 KB at 6.0 KB/sec)
    15.     remote: Downloading: http://repo.maven.apache.org/maven2/org/apache/maven/plugins/maven-plugins/12/maven-plugins-12.pom
    16.     remote: Downloaded: http://repo.maven.apache.org/maven2/org/apache/maven/plugins/maven-plugins/12/maven-plugins-12.pom (12 KB at 35.9 KB/sec)
    18.     ...
    20.     remote: [INFO] Packaging webapp
    21.     remote: [INFO] Assembling webapp [helloweb] in [/home/application/current/target/helloweb]
    22.     remote: [INFO] Processing war project
    23.     remote: [INFO] Copying webapp resources [/home/application/current/src/main/webapp]
    24.     remote: [INFO] Webapp assembled in [27 msecs]
    25.     remote: [INFO] Building war: /home/application/current/target/helloweb.war
    26.     remote: [INFO] WEB-INF/web.xml already added, skipping
    27.     remote: [INFO] ------------------------------------------------------------------------
    28.     remote: [INFO] BUILD SUCCESS
    29.     remote: [INFO] ------------------------------------------------------------------------
    30.     remote: [INFO] Total time: 51.729s
    31.     remote: [INFO] Finished at: Tue Nov 11 17:04:05 UTC 2014
    32.     remote: [INFO] Final Memory: 8M/19M
    33.     remote: [INFO] ------------------------------------------------------------------------
    34.     remote:
    35.     remote: ---- Building application image ----
    36.     remote:  ---> Sending image to repository (2.96MB)
    37.     remote:  ---> Cleaning up
    38.     remote:
    39.     remote: ---- Starting 1 new unit ----
    40.     remote:  ---> Started unit e71d176232...
    41.     remote:
    42.     remote: ---- Adding routes to 1 new units ----
    43.     remote:  ---> Added route to unit e71d176232
    44.     remote:
    45.     remote: ---- Removing routes from 1 old units ----
    46.     remote:  ---> Removed route from unit d8a2d14948
    47.     remote:
    48.     remote: ---- Removing 1 old unit ----
    49.     remote:  ---> Removed old unit 1/1
    50.     remote:
    51.     remote: OK
    52.     To git@tsuru.mycompany.com:helloweb.git
    53.      * [new branch]      master -> master

    如你所见，输出的最后一部分是相同的，应用已经运行在tsuru给定的地址了。

    切换Java版本

    在tsuru的Java平台中，用户可以使用两个版本的Java：Oracle提供的Java 7和8。通过JAVA_VERSION环境变量可以选择你想使用的Java版本。缺省使用Java 7，但是可以通过运行下面的命令切换到Java 8：

    1.     $ tsuru env-set -a helloweb JAVA_VERSION=8
    2.     ---- Setting 1 new environment variables ----
    4.     ---- Starting 1 new unit ----
    5.      ---> Started unit d8a2d14948...
    7.     ---- Adding routes to 1 new units ----
    8.      ---> Added route to unit d8a2d14948
    10.     ---- Removing routes from 1 old units ----
    11.      ---> Removed route from unit 4d155e805f
    13.     ---- Removing 1 old unit ----
    14.      ---> Removed old unit 1/1

    完成！不需要再运行一次部署，应用已经运行在Java 8之上了。

    设置应用的内存大小

    在tsuru的Java平台，用户可以使用不同的计划的单元，每个计划可以包含内存不同的容器。定义Java堆内存最大值（以MB计算）可以通过环境变量JAVA_MAX_MEMORY设置。变量缺省值为128（根据你的basebuilder不同而不同）。

    1.     $ tsuru env-set -a helloweb JAVA_MAX_MEMORY=1024
    2.     ---- Setting 1 new environment variables ----
    4.     ---- Starting 1 new unit ----
    5.      ---> Started unit o5p1k70289...
    7.     ---- Adding routes to 1 new units ----
    8.      ---> Added route to unit o5p1k70289
    10.     ---- Removing routes from 1 old units ----
    11.      ---> Removed route from unit d8a2d14948
    13.     ---- Removing 1 old unit ----
    14.      ---> Removed old unit 1/1

    完成! 不需要再运行一次部署，应用已经被分配了更多的内存。

    进一步探索

    更多信息，可以查看tsuru文档，或者阅读tsuru命令完全使用指南。

    原文: http://doc.oschina.net/tsuru-paas?t=52823