README.md

Liberty App Accelerator

This project was generated by the Liberty app accelerator

Table of Contents

• Summary
• Requirements
• Configuration
• Project contents
• Run
• Notices

Summary

The Liberty App Accelerator provides a starting point for creating applications running on WebSphere Liberty.

To deploy this application to IBM Cloud 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), or Download a Liberty server package that contains the IBM JDK (Windows, Linux)

Configuration

The application is configured to provide various technologies and features. 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 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.

• MicroProfile : The MicroProfile project is an open community with the aim of optimizing Enterprise Java for a microservices architecture. MicroProfile will be evolving with guidance from the community. For the complete feature documentation, see the microProfile-1.2 feature description in IBM Knowledge Center. If you want to share your thoughts you can post straight to the MicroProfile Google group.

The project contains IBM Cloud specific files that are used to deploy the application as part of an 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.

Run

To build and run the application:

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

To deploy the application to IBM Cloud:

1. mvn install -Pbluemix -Dcf.org=[your email address] -Dcf.username=[your username] -Dcf.password=[your password]

The application will be deployed to the following url: [http://LibertyProject.mybluemix.net/LibertyProject/]

Alternatively use the Toolchain button above.

Endpoints

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.

Notices

This project was generated using:

• generator-java v3.1.0
• java-common v2.3.0
• generator-ibm-service-enablement v0.5.0
• generator-ibm-cloud-enablement v0.0.114
• generator-liberty v6.0.2