Summary
A lightweight open framework for building fast and efficient cloud-native Java microservices:
- Open Liberty is fast to start up with low memory footprint and live reload for quick iteration.
- Simple to add and remove features from the latest versions of MicroProfile and Java EE.
- Zero migration lets you focus on what's important, not the APIs changing under you.
Getting Started
Maven
Launch a sample app usinggit clone https://github.com/OpenLiberty/sample-getting-started.git
cd sample-getting-started
mvn clean package liberty:run
Open browser to http://localhost:9080/ and explore the demo application.
See this guide to learn how it works.
Downloads
Usage
Docker
- This guide demonstrates development using Docker containers.
Maven
- This guide demonstrates development using the Liberty Maven Plugin.
Command Line
- This reference demonstrates the basic server operation commands.
Open Liberty Docs
Contributing
Our CONTRIBUTING document contains details for submitting pull requests.
FYI: The project recently renamed master
branch to release
. More info here: https://github.com/OpenLiberty/open-liberty/wiki/Master-rename-to-Release
Running a Build
-
Clone the repository to your system.
git clone git@github.com:OpenLiberty/open-liberty.git
-
Run a gradle build.
cd open-liberty/dev ./gradlew cnf:initialize ./gradlew assemble
-
Run the unit or FAT tests.
./gradlew test
for unit tests./gradlew build.example_fat:buildandrun
to run a FAT projectNOTE:
./gradlew build
runs theassemble
andtest
tasks -
Perform a local release
./gradlew releaseNeeded
NOTE: This task releases all projects to the local releaseRepo. The final openliberty zip can be found in
open-liberty\dev\cnf\release\dev\openliberty\<version>\openliberty-xxx.zip
License
Usage is provided under the EPL 2.0 license See LICENSE for the full details.