forked from unikraft/unikraft
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
README.md: Update the way we build the application
Signed-off-by: Sergiu Moga <[email protected]> Reviewed-by: Gabriel Mocanu <[email protected]> Approved-by: Razvan Deaconescu <[email protected]> Tested-by: Unikraft CI <[email protected]> GitHub-Pull-Request: unikraft#3
- Loading branch information
1 parent
fb343bf
commit 09c3e4c
Showing
1 changed file
with
43 additions
and
4 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,10 +1,49 @@ | ||
# Unikraft "hello world" Application | ||
|
||
To build and run this application please use the `kraft` script: | ||
This application prints a basic "Hello World!" message. | ||
|
||
pip3 install git+https://github.com/unikraft/kraft.git | ||
mkdir my-first-unikernel && cd my-first-unikernel | ||
kraft up -p PLATFORM -m ARCHITECTURE helloworld | ||
To configure, build and run the application you need to have [kraft](https://github.com/unikraft/kraft) installed. | ||
|
||
To be able to run it, configure the application to run on the desired platform and architecture: | ||
``` | ||
$ kraft configure -p PLATFORM -m ARCH | ||
``` | ||
|
||
Build the application: | ||
``` | ||
$ kraft build | ||
``` | ||
|
||
And, finally, run the application: | ||
``` | ||
$ kraft run | ||
Hello World! | ||
``` | ||
|
||
If you want to have more control you can also configure, build and run the application manually. | ||
|
||
To configure it with the desired features: | ||
``` | ||
$ make menuconfig | ||
``` | ||
|
||
Build the application: | ||
``` | ||
$ make | ||
``` | ||
|
||
Run the application: | ||
- If you built the application for `kvm`: | ||
``` | ||
sudo qemu-system-x86_64 -kernel "build/app-helloworld_kvm-x86_64" \ | ||
-enable-kvm \ | ||
-nographic | ||
``` | ||
|
||
- If you built the application for `linuxu`: | ||
``` | ||
./build/app-helloworld_linuxu-x86_64 | ||
``` | ||
|
||
For more information about `kraft` type ```kraft -h``` or read the | ||
[documentation](http://docs.unikraft.org). |