Skip to content
This repository has been archived by the owner on Jan 8, 2021. It is now read-only.

Latest commit

 

History

History
85 lines (48 loc) · 2.27 KB

README.md

File metadata and controls

85 lines (48 loc) · 2.27 KB
Raw

Cunik

(The project is under development.)

Build Status

Cunik is a solution for easily building, packaging, delivering, fetching, deploying and managing unikernel images over different unikernel implementations like Rumprun, OSv, MirageOS and IncludeOS, which enables people launching unikernel applications by several command lines.

Read more about Cunik here.

Getting started

These instructions will get you running Cunik Engine and a Cunik-nginx on your machine.

Get Source Code

git clone https://github.com/Cunik/Cunik-engine.git

Install System Package Dependencies

On Debian, install the following using apt:

  • libvirt-daemon-system
  • libvirt-dev

Install Python Package Dependencies

pip3 install -r requirements.txt

Create Cunik-Root Manually

Cunik intends to load its images and other information from a single folder(/var/cunik). For now, you need to create it manually: get this, decompress it, and copy or link to /var/cunik.

Start Cunik-engine

A Cunik Engine is a daemon that listens on the host and waits for requests from clients. Now, let's launch the Cunik Engine.

Run the daemon:

python3 engine.py runserver

Actually, we need to be root to configure network and manage vm. So run the command line above as root or use sudo, and use what ever techniques to prevent unexpected damage.

Start a Cunik and Test It

Use Cunik-cli to start a Cunik. Example:

cunik-cli create nginx 10.0.125.3

Don't change 10.0.125 since it is hard-coded for now.

Then curl 10.0.125.3 to see if it works.

Following are the images that you can give it a try:

  • nginx

    Runmrun implementation of nginx.

  • redis-server

    Rumprun implementation of redis. Test it with redis-cli -h <address>.

  • redis-server-osv

    OSv implementation of reids. Unable to access for now(we are sure it's online(nmap-ed it)). We'd be glad if you can help us fix it.

Contributing

(none)

Links

(none)

Licensing

The code in this project is licensed under MIT license.