You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Alexander Jung a186c3bd73 kraft v0.4.0 released 8 months ago
.github/ISSUE_TEMPLATE Update issue templates 1 year ago
docker docker: Include copyright notice 8 months ago
kraft kraft v0.4.0 released 8 months ago
package/debian kraft v0.4.0 released 8 months ago
scripts kraft/scripts: Introduce new kraft-net network helper and dir rename. 9 months ago
.gitignore Introducing the `kraft` command-line utility for the Unikraft! 10 months ago
CONTRIBUTING.md Update documentation. 11 months ago
COPYING.md Update documentation. 11 months ago
MAINTAINERS.md kraft: Update MAINTAINERS list 9 months ago
MANIFEST.in kraft: Include MANIFEST.in to include specification JSON files. 9 months ago
Makefile kraft v0.4.0 released 8 months ago
README.md doc: Include supported applications. 9 months ago
requirements.txt kraft: Fix missing gitdb dependency with GitPython upgrade 9 months ago
setup.py kraft: Update Github URL. 9 months ago

README.md

kraft

To begin using Unikraft you can use the command-line utility kraft, which is a companion tool used for defining, configuring, building, and running Unikraft applications. With kraft you can seamlessly create a build environment for your unikernel and painlessly manage dependencies for its build.

Installing kraft

The kraft tool and Unikraft build system have a number of package requirements; please run the following command (on apt-get-based systems) to install the requirements:

apt-get install -y --no-install-recommends build-essential libncurses-dev libyaml-dev flex git wget socat bison unzip uuid-runtime; 

To install kraft simply run:

pip3 install git+https://github.com/unikraft/kraft.git

You can then type kraft to see its help menu

Building an Application

The simplest way to get the sources for, build and run an application is by running the following commands:

kraft list
kraft up -p PLATFORM -m ARCHITECTURE APP

At present, Unikraft and kraft support the following applications:

For more information about that command type kraft up -h. For more information about kraft type kraft -h or read the documentation at Unikraft’s website. If you find any problems please fill out an issue. Thank you!

Contributing

Please refer to the README.md as well as the documentation in the doc/ subdirectory of the main Unikraft repository.