capsule-osv

OSv Caplet

License	MIT
Categories	Capsule Build Tools Distribution
GroupId	co.paralleluniverse
ArtifactId	capsule-osv
Last Version	0.1.0
Release Date	Sep 10, 2015
Type	zip
Description	capsule-osv OSv Caplet
Project URL	https://github.com/puniverse/capsule-osv
Source Code Management	https://github.com/puniverse/capsule-osv

Download capsule-osv

Filename	Size
capsule-osv-0.1.0.pom
capsule-osv-0.1.0.zip	156 KB
capsule-osv-0.1.0-sources.jar	4 KB
capsule-osv-0.1.0-javadoc.jar	19 KB

Dependencies

compile (1)

Group / Artifact	Type	Version
co.paralleluniverse : capsule	jar	1.0

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.10

Project Modules

There are no modules declared in this project.

Capsule OSv

A caplet that wraps a capsule in an OSv image.

Requirements

In addition to Capsule's:

• Capstan correctly installed.

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

Parallel Universe

Versions

Version
0.1.0 Sep 10, 2015