Microservice

Bluemix Microservice Starter for Spring

Table of Contents

• Summary
• Requirements
• Configuration
• Project contents
• Run

Summary

The Bluemix Microservice Starter in Java provides a starting point for creating Java microservice applications running on Spring.

To deploy this application to Bluemix using a toolchain click the Create Toolchain button.

Requirements

• Maven
• Java 8: Any compliant JVM should work.
  • Java 8 JDK from Oracle
  • Java 8 JDK from IBM (AIX, Linux, z/OS, IBM i)

Configuration

Capabilities are provided through dependencies in the pom.xml file.

Project contents

The ports are set to the defaults of 8080 for http and 8443 for https and are exposed to the CLI in the cli-config.yml file.

The project contains Bluemix specific files that are used to deploy the application as part of a Bluemix DevOps flow. The .bluemix directory contains files used to define the Bluemix toolchain and pipeline for your application. The manifest.yml file specifies the name of your application in Bluemix, the timeout value during deployment and which services to bind to.

This microservice application is configured to connect to the following services :

Credentials are either taken from the VCAP_SERVICES environment variable that Bluemix provides or from environment variables passed in by the config file src/main/resources/localdev-config.json.

Run

To build and run the application:

1. mvn install
2. java -jar ./target/spring-1.0-SNAPSHOT.jar

To run the application in Docker use the Docker file called Dockerfile. If you do not want to install Maven locally you can use Dockerfile-tools to build a container with Maven installed.

Endpoints

The application exposes the following endpoints:

The ports are set in the pom.xml file and exposed to the CLI in the cli-config.yml file.

Notices

This project was generated using:

• generator-java v2.7.2
• java-common v2.3.0
• generator-ibm-service-enablement v0.0.97
• generator-ibm-cloud-enablement v0.0.110
• generator-spring v1.0.2