Skip to content

Commit

Permalink
README.md: Update the way we build the application
Browse files Browse the repository at this point in the history
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
mogasergiu authored and unikraft-bot committed Nov 27, 2021
1 parent fb343bf commit 09c3e4c
Showing 1 changed file with 43 additions and 4 deletions.
47 changes: 43 additions & 4 deletions README.md
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).

0 comments on commit 09c3e4c

Please sign in to comment.