Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/asseco-pst/liberty


https://github.com/asseco-pst/liberty

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README

        

## Liberty

[![CircleCI](https://circleci.com/gh/asseco-pst/liberty/tree/develop.svg?style=svg)](https://circleci.com/gh/asseco-pst/liberty/tree/develop)
[![CodeFactor](https://www.codefactor.io/repository/github/asseco-pst/liberty/badge)](https://www.codefactor.io/repository/github/asseco-pst/liberty)

### What is it?
Liberty is an open source tool to allow deploying artifacts into Open Liberty or IBM Websphere Liberty servers. It provides a deploy builder that will assist in the necessary
configuration for the deployer service. Using the deployer service, the following actions are currently supported:
- install artifact
- uninstall artifact
- start artifact
- stop artifact
- restart artifact
- get a list of installed artifacts
- get a list of installed artifacts for a given package
- change the autostart configuration (only supported for the custom strategy)

An artifact is a java package (war, ear, etc) that is currently supported by Open Liberty or IBM Websphere Liberty.

Right now, Liberty is supplied only as an importable dependency, but a CLI version is set to be developed as part of the roadmap.

### Getting Started

Import using Maven or Gradle:

```xml

io.github.asseco-pst
liberty
...

```

```groovy
compile group: 'io.github.asseco-pst', name: 'liberty', version: '...'
```

### Build from source
1. Clone the project
```sh
git clone [email protected]:asseco-pst/liberty.git
```

2. Run the following command on the root of the project:
```sh
gradlew build
```

## Usage

### As a CLI
#### Running the executable

To be developed as part of the roadmap.

### As a Groovy Lib

Install a new artifact in a Liberty Server
```groovy
// Sets up the deployment service
IDeployService deployService = deployBuilder
.setProfileDetails('>', '', '', '')
.setDeployStrategy(Strategy.DROPINS)
.setArtifactPath("")
.build()

// Installs and starts the artifact on the Liberty server
deployService.connect().installArtifact().await(2000).startArtifact()
```