spring_reference/all in one/deploying_to_the_cloud.md

9.5 KiB
Raw Blame History

部署到云端

对于大多数流行云PaaS平台即服务提供商Spring Boot的可执行jars就是为它们准备的。这些提供商往往要求你带上自己的容器它们管理应用的进程不特别针对Java应用程序所以它们需要一些中间层来将你的应用适配到云概念中的一个运行进程。

两个流行的云提供商Heroku和Cloud Foundry采取一个打包'buildpack'方法。为了启动你的应用程序不管需要什么buildpack都会将它们打包到你的部署代码它可能是一个JDK和一个java调用也可能是一个内嵌的webserver或者是一个成熟的应用服务器。buildpack是可插拔的但你最好尽可能少的对它进行自定义设置。这可以减少不受你控制的功能范围最小化部署和生产环境的发散。

理想情况下你的应用就像一个Spring Boot可执行jar所有运行需要的东西都打包到它内部。

  • Cloud Foundry

如果不指定其他打包方式Cloud Foundry会启用它提供的默认打包方式。Cloud Foundry的Java buildpack对Spring应用有出色的支持包括Spring Boot。你可以部署独立的可执行jar应用也可以部署传统的.war形式的应用。

一旦你构建了应用(比如,使用mvn clean package)并安装了cf命令行工具,你可以使用下面的cf push命令(将路径指向你编译后的.jar来部署应用。在发布一个应用前确保你已登陆cf命令行客户端。

$ cf push acloudyspringtime -p target/demo-0.0.1-SNAPSHOT.jar

查看cf push文档获取更多可选项。如果相同目录下存在manifest.ymlCloud Foundry会使用它。

就此cf开始上传你的应用

Uploading acloudyspringtime... OK
Preparing to start acloudyspringtime... OK
-----> Downloaded app package (8.9M)
-----> Java Buildpack source: system
-----> Downloading Open JDK 1.7.0_51 from .../x86_64/openjdk-1.7.0_51.tar.gz (1.8s)
       Expanding Open JDK to .java-buildpack/open_jdk (1.2s)
-----> Downloading Spring Auto Reconfiguration from  0.8.7 .../auto-reconfiguration-0.8.7.jar (0.1s)
-----> Uploading droplet (44M)
Checking status of app 'acloudyspringtime'...
  0 of 1 instances running (1 starting)
  ...
  0 of 1 instances running (1 down)
  ...
  0 of 1 instances running (1 starting)
  ...
  1 of 1 instances running (1 running)

App started

恭喜!应用现在处于运行状态!

检验部署应用的状态是很简单的:

$ cf apps
Getting applications in ...
OK

name                 requested state   instances   memory   disk   urls
...
acloudyspringtime    started           1/1         512M     1G     acloudyspringtime.cfapps.io
...

一旦Cloud Foundry意识到你的应用已经部署你就可以点击给定的应用URI此处是acloudyspringtime.cfapps.io/

  • 绑定服务

默认情况下,运行应用的元数据和服务连接信息被暴露为应用的环境变量(比如,$VCAP_SERVICES。采用这种架构的原因是因为Cloud Foundry多语言特性任何语言和平台都支持作为buildpack。进程级别的环境变量是语言无关language agnostic的。

环境变量并不总是有利于设计最简单的API所以Spring Boot自动提取它们然后将这些数据导入能够通过Spring Environment抽象访问的属性里:

@Component
class MyBean implements EnvironmentAware {

    private String instanceId;

    @Override
    public void setEnvironment(Environment environment) {
        this.instanceId = environment.getProperty("vcap.application.instance_id");
    }

    // ...

}

所有的Cloud Foundry属性都以vcap作为前缀。你可以使用vcap属性获取应用信息比如应用的公共URL和服务信息比如数据库证书。具体参考VcapApplicationListener Javadoc。

Spring Cloud Connectors项目很适合比如配置数据源的任务。Spring Boot提供自动配置支持和一个spring-boot-starter-cloud-connectors starter POM。

  • Heroku

Heroku是另外一个流行的Paas平台。想要自定义Heroku的构建过程你可以提供一个Procfile它提供部署一个应用所需的指令。Heroku为Java应用分配一个端口确保能够路由到外部URI。

你必须配置你的应用监听正确的端口。下面是用于我们的starter REST应用的Procfile

web: java -Dserver.port=$PORT -jar target/demo-0.0.1-SNAPSHOT.jar

Spring Boot将-D参数作为属性通过一个Spring的Environment实例访问。server.port配置属性适合于内嵌的TomcatJetty或Undertow实例启用时使用。$PORT环境变量被分配给Heroku Paas使用。

Heroku默认使用Java 1.6。只要你的Maven或Gradle构建时使用相同的版本就没问题Maven用户可以设置java.version属性。如果你想使用JDK 1.7在你的pom.xml和Procfile临近处创建一个system.properties文件。在该文件中添加以下设置

java.runtime.version=1.7

这就是你需要做的一切。对于Heroku部署来说经常做的工作就是使用git push将代码推送到生产环境。

$ git push heroku master

Initializing repository, done.
Counting objects: 95, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (78/78), done.
Writing objects: 100% (95/95), 8.66 MiB | 606.00 KiB/s, done.
Total 95 (delta 31), reused 0 (delta 0)

-----> Java app detected
-----> Installing OpenJDK 1.7... done
-----> Installing Maven 3.2.3... done
-----> Installing settings.xml... done
-----> executing /app/tmp/cache/.maven/bin/mvn -B
       -Duser.home=/tmp/build_0c35a5d2-a067-4abc-a232-14b1fb7a8229
       -Dmaven.repo.local=/app/tmp/cache/.m2/repository
       -s /app/tmp/cache/.m2/settings.xml -DskipTests=true clean install

       [INFO] Scanning for projects...
       Downloading: http://repo.spring.io/...
       Downloaded: http://repo.spring.io/... (818 B at 1.8 KB/sec)
        ....
       Downloaded: http://s3pository.heroku.com/jvm/... (152 KB at 595.3 KB/sec)
       [INFO] Installing /tmp/build_0c35a5d2-a067-4abc-a232-14b1fb7a8229/target/...
       [INFO] Installing /tmp/build_0c35a5d2-a067-4abc-a232-14b1fb7a8229/pom.xml ...
       [INFO] ------------------------------------------------------------------------
       [INFO] BUILD SUCCESS
       [INFO] ------------------------------------------------------------------------
       [INFO] Total time: 59.358s
       [INFO] Finished at: Fri Mar 07 07:28:25 UTC 2014
       [INFO] Final Memory: 20M/493M
       [INFO] ------------------------------------------------------------------------

-----> Discovering process types
       Procfile declares types -> web

-----> Compressing... done, 70.4MB
-----> Launching... done, v6
       http://agile-sierra-1405.herokuapp.com/ deployed to Heroku

To git@heroku.com:agile-sierra-1405.git
 * [new branch]      master -> master

现在你的应用已经启动并运行在Heroku。

  • Openshift

Openshift是RedHat公共和企业PaaS解决方案。和Heroku相似它也是通过运行被git提交触发的脚本来工作的所以你可以使用任何你喜欢的方式编写Spring Boot应用启动脚本只要Java运行时环境可用这是在Openshift上可以要求的一个标准特性。为了实现这样的效果你可以使用DIY Cartridge,并在.openshift/action_scripts下hooks你的仓库

基本模式如下:

  1. 确保Java和构建工具已被远程安装比如使用一个pre_build hook默认会安装Java和Maven不会安装Gradle
  2. 使用一个build hook去构建你的jar使用Maven或Gradle比如
#!/bin/bash
cd $OPENSHIFT_REPO_DIR
mvn package -s .openshift/settings.xml -DskipTests=true
  1. 添加一个调用java -jar …​start hook
#!/bin/bash
cd $OPENSHIFT_REPO_DIR
nohup java -jar target/*.jar --server.port=${OPENSHIFT_DIY_PORT} --server.address=${OPENSHIFT_DIY_IP} &
  1. 使用一个stop hook
#!/bin/bash
source $OPENSHIFT_CARTRIDGE_SDK_BASH
PID=$(ps -ef | grep java.*\.jar | grep -v grep | awk '{ print $2 }')
if [ -z "$PID" ]
then
    client_result "Application is already stopped"
else
    kill $PID
fi
  1. 将内嵌的服务绑定到平台提供的在application.properties定义的环境变量比如
spring.datasource.url: jdbc:mysql://${OPENSHIFT_MYSQL_DB_HOST}:${OPENSHIFT_MYSQL_DB_PORT}/${OPENSHIFT_APP_NAME}
spring.datasource.username: ${OPENSHIFT_MYSQL_DB_USERNAME}
spring.datasource.password: ${OPENSHIFT_MYSQL_DB_PASSWORD}

在Openshift的网站上有一篇running Gradle in Openshift博客如果想使用gradle构建运行的应用可以参考它。由于一个Gradle bug你不能使用高于1.6版本的Gradle。

  • Google App Engine

Google App Engine跟Servlet 2.5 API是有联系的所以在不修改的情况系你是不能部署一个Spring应用的。具体查看本指南的Servlet 2.5章节