Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.bluemix
chart/java2
manifests
src
.cfignore
.dockerignore
.gitignore
Dockerfile
Dockerfile-build
Dockerfile-tools
Jenkinsfile
README.md
cli-config.yml
manifest.yml
pom.xml

README.md

Microservice

IBM Cloud Microservice Starter for Java - MicroProfile / Java EE

Platform

Table of Contents

Summary

The IBM Cloud Microservice Starter for Java - MicroProfile / Java EE provides a starting point for creating Java microservice applications running on WebSphere Liberty.

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

Requirements

Configuration

The application is configured to provide JAX-RS REST capabilities, JNDI, JSON parsing and Contexts and Dependency Injection (CDI).

These capabilities are provided through dependencies in the pom.xml file and Liberty features enabled in the server config file found in src/main/liberty/config/server.xml.

Project contents

The microservice application has a health endpoint which is accessible at <host>:<port>/java2/health. The context root is set in the src/main/webapp/WEB-INF/ibm-web-ext.xml file. The ports are set in the pom.xml file and exposed to the CLI in the cli-config.yml file.

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

Credentials are either taken from the VCAP_SERVICES environment variable that IBM Cloud provides or from environment variables passed in by JNDI (see the server config file src/main/liberty/config/server.xml).

Run

To build and run the application:

  1. mvn install
  2. mvn liberty:run-server

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:

  • Health endpoint: <host>:<port>/<contextRoot>/health

The context root is set in the src/main/webapp/WEB-INF/ibm-web-ext.xml file. 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-ibm-java v5.13.7
  • generator-ibm-service-enablement v3.1.2
  • generator-ibm-cloud-enablement v1.5.4
  • generator-ibm-java-liberty v
You can’t perform that action at this time.