initializr/README.md
Dave Syer 143300aeb5 Update README with instructions for deploying app
The instructions should be explicit and precise enough for
anyone to deploy to production now. There is a Bamboo job
that should be doing it, but we've had some issue with it and
it often fails, whereas manual pushes always work. You need
a Cloudfoundry account with access to the Sagan organization
to push to production (ask Trevor Marshall).
2014-08-12 07:53:14 -07:00

2.4 KiB

Spring Initializr

Prerequisites

You need Java (1.6 or better) and a bash-like shell.

If you are on a Mac and using homebrew, all you need to do to install it is:

$ brew install spring-boot-cli

It will install /usr/local/bin/spring. You can jump right to running the app.

An alternative way to install the spring command line interface can be installed like this:

$ curl start.spring.io/install.sh | bash

After running that command you should see a spring directory:

$ ./spring/bin/spring --help

usage: spring [--help] [--version]
   <command> [<args>]
...

You could add that bin directory to your PATH (the examples below assume you did that).

If you don't have curl or zip you can probably get them (for Windows users we recommend cygwin), or you can download the zip file and unpack it yourself.

Running the app locally

Use the spring command:

$ spring run app.groovy

Deploying to Cloud Foundry

If you are on a Mac and using homebrew, install the Cloud Foundry CLI:

$ brew install cloudfoundry-cli

Alternatively, download a suitable binary for your platform from Pivotal Web Services.

To help avoid a timeout on startup you should upload all the dependencies. You can get those locally by running spring grab:

$ spring jar app.groovy

this will create a local directory repository/ with all the jar dependencies. Then when you cf push they will be uploaded and used.

An example Cloud Foundry manifest.yml file is provided. You should ensure that the application name and URL (name and host values) are suitable for your environment before running cf push.

Alternatively you can jar up the app and make it executable in any environment. Care is needed with the includes and excludes:

$ spring jar --include '+spring.zip' start.jar app.groovy
$ cf push start -p start.jar -n start-<space>

Where <space> is the name of the space. As a failsafe, and a reminder to be explicit, the deployment will fail in production without the -n. It is needed to select the route because there is a manifest that defaults it to start-development.

If you are deploying the "legacy" service for STS in production:

$ cf push start-legacy -p start.jar -n start-legacy