OSv Caplet
Java
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src/main/java
.gitignore
README.md
build.gradle

README.md

Capsule OSv

A caplet that wraps a capsule in an OSv image.

Requirements

In addition to Capsule's:

Usage

The Gradle-style dependency you need to embed in your Capsule JAR, which you can generate with the tool you prefer (f.e. with plain Maven/Gradle as in Photon and capsule-gui-demo or higher-level Capsule build plugins), is co.paralleluniverse:capsule-osv:0.1.0. Also include the caplet class in your Capsule manifest, for example:

    Caplets: MavenCapsule OsvCapsule

capsule-osv can also be run as a wrapper capsule without embedding it:

$ java -Dcapsule.log=verbose -jar capsule-osv-0.1.0.jar my-capsule.jar my-capsule-arg1 ...

It can be both run against (or embedded in) plain (e.g. "fat") capsules and Maven-based ones.

Additional Capsule manifest entries

The following additional manifest entries and system properties can be used (see the Capstan docs for further details):

  • capsule.osv.buildOnly system property: builds an image without launching the app (default: false).
  • capsule.osv.hypervisor system property: allows to specify a non-default hypervisor to be used by OSV (default: KVM on Linux).
  • Port-Forward manifest entry: configure OSv port forwarding (default: none). The capsule.osv.portForward system property can override it.
  • Network-Type: configure OSv network type (default: user networking on KVM). The capsule.osv.networkType system property can override it.
  • Physical-NIC-Name: configure OSv physical NIC name (needed with VirtualBox). The capsule.osv.physicalNICName system property can override it.

Known caveats

At present Java agents don't work (see this OSv issue).

License

MIT