spring-sendgrid

A sample application for using Spring Framework and SendGrid on Cloud Foundry.

Running the application on Cloud Foundry

After installing in the 'cf' command-line interface for Cloud Foundry, targeting a Cloud Foundry instance, and logging in, the application can be pushed using these commands:

$ ./gradlew assemble
$ cf push --path=build/libs/spring-sendgrid.war

If prompted to create a service for your app, select y and choose the SendGrid service. This will provision an account on SendGrid and bind it to your app, which stores credentials for the account in the VCAP_SERVICES environment variable. This application will read those credentials and use them when it sends e-mails.

Once the app is uploaded and finishes staging, you can browse to the URL http://spring-sendgrid.<cloud-foundry-domain>/.

You can verify the SendGrid credentials the app is using by navigating to http://spring-sendgrid.<cloud-foundry-domain>/creds.

You can see what environment variables are available to the application (including the VCAP_ENVIRONMENT variable) by navigating to http://spring-sendgrid.<cloud-foundry-domain>/env.

You can override the SendGrid credentials in the environment by configuring them in the file src/main/resources/application.properties.

Running the application locally

When running locally, the SendGrid credentials must be set manually in the file src/main/resources/application.properties.

After editing the file and adding the credentials, run this command to start the app:

./gradlew tomcatRun

Once the app is running you can browse to the URL http://localhost:8080/spring-sendgrid.

A note on `./gradlew'

The first time ./gradlew runs, it will take a while to download the build tool. Subsequent runs will be much faster.