https://github.com/thorntail/thorntail

Source code for the Thorntail project
https://github.com/thorntail/thorntail

java microservices

Last synced: 2 days ago
JSON representation

Source code for the Thorntail project

• Host: GitHub
• URL: https://github.com/thorntail/thorntail
• Owner: thorntail
• License: apache-2.0
• Archived: true
• Created: 2016-02-18T21:32:47.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2020-12-02T16:49:38.000Z (almost 4 years ago)
• Last Synced: 2024-09-24T20:48:39.218Z (2 days ago)
• Topics: java, microservices
• Language: Java
• Homepage: http://thorntail.io/
• Size: 20.6 MB
• Stars: 391
• Watchers: 51
• Forks: 224
• Open Issues: 50
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
[![Build Status](https://ci.wildfly-swarm.io/buildStatus/icon?job=thorntail-linux)](https://ci.wildfly-swarm.io/job/thorntail-linux)

[![License](https://img.shields.io/:license-Apache2-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0)

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/io.thorntail/thorntail/badge.svg)](https://maven-badges.herokuapp.com/maven-central/io.thorntail/thorntail)

[![Join the chat at freenode:thorntail](https://img.shields.io/badge/irc-freenode%3A%20%23thorntail-blue.svg)](http://webchat.freenode.net/?channels=%23thorntail)

![Thorntail: Rightsize your JavaEE Applications](http://thorntail.io/images/thorntail_horizontal_rgb_600px_reverse.png)

> Issues for v2/master are being tracked using the [Red Hat issue tracking system](https://issues.redhat.com/projects/THORN/issues?filter=allopenissues) (JIRA).

> Issues for v4 are being tracked in GitHub Issues.

> Bug reports and feature requests are greatly appreciated.

# Thorntail Core

Thorntail provides a mechanism for building

applications as *uber jars*, with just enough of the

WildFly application server wrapped around it to support

each application's use-case.

> Note: Thorntail requires Maven 3.2.5 or higher for building your application.

> Note: Thorntail requires JDK 8 or higher for building your application

> or for building Thorntail itself.

# Project Configuration

In a normal WAR-based maven `pom.xml`, simply add the following

```xml

  io.thorntail

  thorntail-maven-plugin

  ${version.thorntail}

  

    

      package

      

        package

      

    

  

```

This will take the `.war` file normally created by your build, and wrap

it in the wildfly-swarm mechanisms.

If you normally produce `myapp-1.0.war`, in your `target/` directory will

then also be present a `myapp-1.0-thorntail.jar`.

In order to specify the portions of the WildFly AS your application needs,

your `pom.xml` should specify some of the following dependencies within

the `io.thorntail` Maven group-id:

* bean-validation

* cdi

* ee

* io

* jaxrs

* logging

* naming

* request-controller

* security

* transactions

* undertow

* _and many more!_

# How To Build Thorntail Itself

Thorntail attempts to be a well-behaved Maven project. To install to your local repository for usage:

```bash

mvn clean install

```

If you're running short on time:

```bash

mvn clean install -DskipTests

```

# Documentation

For a more complete set of documentation, go to the [Thorntail Guide](https://docs.thorntail.io/).

# Community

* We hang out in `#thorntail` on irc.freenode.net.