Name: vertx-vtoons
Owner: Cloud Foundry Sample Applications
Description: A sample vert.x application modified to run on Cloud Foundry.
Created: 2012-07-31 21:37:05.0
Updated: 2017-03-17 20:03:08.0
Pushed: 2013-01-03 17:39:21.0
Size: 282
Language: JavaScript
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
This is a sample project that shows how to run a vert.x application on CloudFoundry. The running application can be seen at http://vtoons.cloudfoundry.com/.
NOTE: This sample has been tested using cloudfoundry-runtime 0.8.2 and vert.x 1.2.3.final (Jan 2, 2013)
vert.x is a framework for for developing asynchronous event-driven applications in a variety of languages, including JavaScript, Ruby, Groovy, Java, Python and Coffeescript.
CloudFoundry recently added support for stand-alone applications, which includes the ability to run applications in containers and frameworks that are not yet fully supported by CloudFoundry.
Even more recently, CloudFoundry added support for running Java 7 applications. vert.x requires a Java 7 runtime environment, so the addition of Java 7 support now makes it possible to run vert.x applications on CloudFoundry.
The vert.x web site include a set of tutorials in several languages. This sample app is based on the Groovy tutorial application. For more details on this application and how to use it, refer to the tutorial pages. The rest of this README will only refer to changes made to the tutorial app to support CloudFoundry.
We can add support to detect runtime environment settings using the Java cloudfoundry-runtime library.
import org.cloudfoundry.runtime.env.CloudEnvironment
import org.cloudfoundry.runtime.env.MongoServiceInfo
def cloudEnv = new CloudEnvironment()
For simplicity, the configuration of the web server in the tutorial application is hard-coded to 'localhost:8080':
def webServerConf = [
port: 8080,
host: 'localhost',
ssl: true,
...
]
In order to run on CloudFoundry, the application must use the host name and port provided by CloudFoundry. This code reads the host name and port from the CloudEnvironment instance, defaulting to 'localhost:8080' if the CloudFoundry environment is not detected:
def webServerConf = [
port: (cloudEnv.getValue('VCAP_APP_PORT') ?: '8080') as int,
host: cloudEnv.getValue('VCAP_APP_HOST') ?: 'localhost',
/* ssl: true, */
...
]
Note: In order to simplify this example, the SSL support was removed from the application.
The tutorial app uses MongoDB as a back-end data store. No configuration is given for the MongoDB connection, so the default host and port are used by the MongoDB vert.x module.
When the application is pushed to CloudFoundry, it is bound to a MongoDB service. The connection parameters for the MongoDB service must also be read from the environment using the MongoServiceInfo class, defaulting if the CloudFoundry environment is not detected:
// Configuration for MongoDb
def mongoConf = [:]
if (cloudEnv.isCloudFoundry()) {
mongoSvcInfo = cloudEnv.getServiceInfo("mongodb-vtoons", MongoServiceInfo.class)
mongoConf.host = mongoSvcInfo.getHost()
mongoConf.port = mongoSvcInfo.getPort() as int
mongoConf.db_name = mongoSvcInfo.getDatabase()
mongoConf.username = mongoSvcInfo.getUserName()
mongoConf.password = mongoSvcInfo.getPassword()
}
A full vert.x distribution (available on the Downloads page of the vert.x web site) must be pushed to CloudFoundry along with the application (we used the 1.2.3.final version of vert.x for this app). This project uses the following directories from your downloaded vert.x distribution:
We are also using the Java cloudfoundry-runtime so we need to include this jar.
To simplify the packaging we will move the application code to a vert.x module in the 'src' directory. This includes adding a mod.json file listing the main application file. You can see this change in this commit in the repository.
While we could package the application by copying a few directories from vert.x distribution and then using ?vmc push? as usual, let?s simplify by creating a Gradle build script as seen here.
This build script provides the following:
With everything in place, let?s just build and deploy the app:
$ ./gradlew assemble
:runtime
Download http://vertx.io/downloads/vert.x-1.2.3.final.zip
:build
Download http://repo.springsource.org/libs-snapshot/org/cloudfoundry/cloudfoundry-runtime/0.8.2/cloudfoundry-runtime-0.8.2.pom
:assemble
BUILD SUCCESSFUL
Total time: 18.586 secs
$ ./gradlew cf-add-service -PcfUser=user@email.com -PcfPasswd=secret
:cf-add-service
CloudFoundry - Connecting to 'http://api.cloudfoundry.com' with user 'user@email.com'
CloudFoundry - Provisioning mongodb service 'mongodb-vtoons'
BUILD SUCCESSFUL
Total time: 7.435 secs
$ ./gradlew cf-push -PcfUser=user@email.com -PcfPasswd=secret
:cf-push
CloudFoundry - Connecting to 'http://api.cloudfoundry.com' with user 'user@email.com'
GET request for "http://api.cloudfoundry.com/apps/vtoons" resulted in 404 (Not Found); invoking error handler
CloudFoundry - Creating standalone application 'vtoons' with runtime java7
CloudFoundry - Deploying '/Users/trisberg/Projects/github/cloudfoundry-samples/vertx-vtoons/build/vertx-vtoons.zip'
CloudFoundry - Starting 'vtoons'
BUILD SUCCESSFUL
Total time: 21.358 secs
If you prefer to create your own zip file and use vmc for deployments here are some hints:
The zip file layout used is the following (only showing directories and some application files):
+- mods
+- vtoons
+- lib
cloudfoundry-runtime-0.8.2.jar
+- web
+- css
+- js
+- js3rdparty
index.html
App.groovy
mod.json
server-keystore.jks
StaticData.groovy
+- vert.x-1.2.3.final
(the vert.x distribution)
The 'vmc push' choices would be these: