Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/puniverse/capsule
Dead-Simple Packaging and Deployment for JVM Apps
https://github.com/puniverse/capsule
deployment jar java jvm packaging
Last synced: about 2 months ago
JSON representation
Dead-Simple Packaging and Deployment for JVM Apps
- Host: GitHub
- URL: https://github.com/puniverse/capsule
- Owner: puniverse
- License: epl-1.0
- Created: 2014-04-18T12:15:41.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2022-05-29T12:44:43.000Z (over 2 years ago)
- Last Synced: 2024-06-20T09:21:24.650Z (3 months ago)
- Topics: deployment, jar, java, jvm, packaging
- Language: Java
- Homepage: http://capsule.io
- Size: 5.87 MB
- Stars: 1,146
- Watchers: 56
- Forks: 99
- Open Issues: 29
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-java - Capsule - Simple and powerful packaging and deployment. A fat JAR on steroids, or a "Docker for Java" that supports JVM-optimized containers. (Projects / Distribution)
README
# *Capsule*
Dead-Simple Packaging and Deployment for JVM Applications
[](https://travis-ci.org/puniverse/capsule) [](https://coveralls.io/r/puniverse/capsule?branch=master) [](https://www.versioneye.com/user/projects/539704a483add7f80a000030) [](https://github.com/puniverse/capsule/releases) [](https://www.eclipse.org/legal/epl-v10.html)
Capsule is a packaging and deployment tool for JVM applications. A capsule is a single executable JAR that contains everything your application needs to run either in the form of embedded files or as declarative metadata. It can contain your JAR artifacts, your dependencies and resources, native libraries, the require JRE version, the JVM flags required to run the application well, Java or native agents and more. In short, a capsule is a self-contained JAR that knows everything there is to know about how to run your application the way it's meant to run.
One way of thinking about a capsule is as a fat JAR on steroids (that also allows native libraries and never interferes with your dependencies) and a declarative startup script rolled into one; another, is to see it is as the deploy-time counterpart to your build tool. Just as a build tool manages your build, Capsule manages the launching of your application.
But while plain capsules are cool and let you ship any JVM application -- no matter how complex -- as a single executable JAR, caplets make capsules even more powerful.
## Documentation
[Capsule website](http://www.capsule.io)
## Support
Discuss Capsule on the capsule-user [Google Group/Mailing List](https://groups.google.com/forum/#!forum/capsule-user)
## Getting Started
[Download](https://github.com/puniverse/capsule/releases)
or:
co.paralleluniverse:capsule:1.0.3
or:
Clone the repository and
gradle install
## License
Copyright (c) 2014-2016, Parallel Universe Software Co. and Contributors. All rights reserved.
This program and the accompanying materials are licensed under the terms
of the Eclipse Public License v1.0 as published by the Eclipse Foundation.
http://www.eclipse.org/legal/epl-v10.html
As Capsule does not link in any way with any of the code bundled in the JAR file, and simply treats it as raw data, Capsule is no different from a self-extracting ZIP file (especially as manually unzipping and examining the JAR's contents is extremely easy). Capsule's own license, therefore, does not interfere with the licensing of the bundled software.
In particular, even though Capsule's license is incompatible with the GPL/LGPL, it is permitted to distribute GPL programs packaged as capsules, as Capsule is simply a packaging medium and an activation script, and does not restrict access to the packaged GPL code. Capsule does not add any capability to, nor removes any from the bundled application. It therefore falls under the definition of an "aggregate" in the GPL's terminology.