From 1c616e1ab8ed021adb39629e90ee5e83b1ee8723 Mon Sep 17 00:00:00 2001
From: qibaoguang <qibaoguang@gmail.com>
Date: Fri, 6 Mar 2015 00:23:22 +0800
Subject: [PATCH] Update deploying_to_the_cloud.md

---
 deploying_to_the_cloud.md | 101 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 101 insertions(+)

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)。