diff --git a/deploying_to_the_cloud.md b/deploying_to_the_cloud.md index 0923bbd..3701a92 100644 --- a/deploying_to_the_cloud.md +++ b/deploying_to_the_cloud.md @@ -77,5 +77,106 @@ class MyBean implements EnvironmentAware { **注**:[Spring Cloud Connectors](http://cloud.spring.io/spring-cloud-connectors/)项目很适合比如配置数据源的任务。Spring Boot提供自动配置支持和一个`spring-boot-starter-cloud-connectors` starter POM。 * Heroku + +Heroku是另外一个流行的Paas平台。想要自定义Heroku的构建过程,你可以提供一个`Procfile`,它提供部署一个应用所需的指令。Heroku为Java应用分配一个端口,确保能够路由到外部URI。 + +你必须配置你的应用监听正确的端口。下面是用于我们的starter REST应用的Procfile: +```shell +web: java -Dserver.port=$PORT -jar target/demo-0.0.1-SNAPSHOT.jar +``` +Spring Boot将`-D`参数作为属性,通过一个Spring的Environment实例访问。`server.port`配置属性适合于内嵌的Tomcat,Jetty或Undertow实例启用时使用。`$PORT`环境变量被分配给Heroku Paas使用。 + +Heroku默认使用Java 1.6。只要你的Maven或Gradle构建时使用相同的版本就没问题(Maven用户可以设置`java.version`属性)。如果你想使用JDK 1.7,在你的pom.xml和Procfile临近处创建一个system.properties文件。在该文件中添加以下设置: +```java +java.runtime.version=1.7 +``` +这就是你需要做的一切。对于Heroku部署来说,经常做的工作就是使用`git push`将代码推送到生产环境。 +```shell +$ 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](https://www.openshift.com/)是RedHat公共(和企业)PaaS解决方案。和Heroku相似,它也是通过运行被git提交触发的脚本来工作的,所以你可以使用任何你喜欢的方式编写Spring Boot应用启动脚本,只要Java运行时环境可用(这是在Openshift上可以要求的一个标准特性)。为了实现这样的效果,你可以使用[DIY Cartridge](https://www.openshift.com/developers/do-it-yourself),并在`.openshift/action_scripts`下hooks你的仓库: + +基本模式如下: + +1. 确保Java和构建工具已被远程安装,比如使用一个`pre_build` hook(默认会安装Java和Maven,不会安装Gradle)。 +2. 使用一个`build` hook去构建你的jar(使用Maven或Gradle),比如 +```shell +#!/bin/bash +cd $OPENSHIFT_REPO_DIR +mvn package -s .openshift/settings.xml -DskipTests=true +``` +3. 添加一个调用`java -jar …​`的`start` hook +```shell +#!/bin/bash +cd $OPENSHIFT_REPO_DIR +nohup java -jar target/*.jar --server.port=${OPENSHIFT_DIY_PORT} --server.address=${OPENSHIFT_DIY_IP} & +``` +4. 使用一个`stop` hook +```shell +#!/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 +``` +5. 将内嵌的服务绑定到平台提供的在application.properties定义的环境变量,比如 +```shell +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](https://www.openshift.com/blogs/run-gradle-builds-on-openshift)博客,如果想使用gradle构建运行的应用可以参考它。由于一个[Gradle bug](http://issues.gradle.org/browse/GRADLE-2871),你不能使用高于1.6版本的Gradle。 + * Google App Engine + +Google App Engine跟Servlet 2.5 API是有联系的,所以在不修改的情况系你是不能部署一个Spring应用的。具体查看本指南的[Servlet 2.5章节](http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/#howto-servlet-2-5)。