Skip to content

docs: Modernize USoC21 Session 04 with KraftKit and x86_64 targets#556

Open
TudorGabrielDanciu wants to merge 1 commit into
unikraft:mainfrom
TudorGabrielDanciu:resurface-complex-apps-USOC2021
Open

docs: Modernize USoC21 Session 04 with KraftKit and x86_64 targets#556
TudorGabrielDanciu wants to merge 1 commit into
unikraft:mainfrom
TudorGabrielDanciu:resurface-complex-apps-USOC2021

Conversation

@TudorGabrielDanciu
Copy link
Copy Markdown

Description:
This PR updates the "Complex Applications" guide (formerly USoC 21 Session 04) to use the modern KraftKit declarative workflow.

Changes:
-Replaced all legacy Make-based instructions with kraft.yaml.
-Configured standard x86_64/qemu targets.
-Updated filesystem configurations (9pfs, initrd) and networking (lwip) to use modern Kconfig arguments.
-Fixed the SQLite setup script to generate the SQL file properly before running.

Note on Testing / Upstream Behavior:
While testing these updated instructions locally (KraftKit v0.6.x), the build completes successfully but outputs a bare kernel (~251kB) that exits immediately with weak main() called. It appears that lib-sqlite on the stable branch is currently not linking its main function or dependencies properly into the final image under this basic configuration.

Signed-off-by: Tudor Danciu <gabrieltdanciu@gmail.com>
@TudorGabrielDanciu TudorGabrielDanciu force-pushed the resurface-complex-apps-USOC2021 branch from 8da4417 to 0366216 Compare May 9, 2026 08:25
@razvand razvand self-requested a review May 9, 2026 09:08
@razvand razvand self-assigned this May 9, 2026
@razvand razvand added the enhancement New feature or request label May 9, 2026
Copy link
Copy Markdown
Contributor

@razvand razvand left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use Modernize (capitalized).

What is the aim of the public/images/nginx_output.png file?

@TudorGabrielDanciu
Copy link
Copy Markdown
Author

Use Modernize (capitalized).

What is the aim of the public/images/nginx_output.png file?

The image is optional and shows how the Nginx website should look like, the original guide had 7 images, of which most of them were not useful to understanding the current configuration of Unikraft. I can remove it as it is fully optional.

@TudorGabrielDanciu TudorGabrielDanciu changed the title docs: modernize USoC21 Session 04 with KraftKit and x86_64 targets docs: Modernize USoC21 Session 04 with KraftKit and x86_64 targets May 9, 2026
@TudorGabrielDanciu TudorGabrielDanciu requested a review from razvand May 9, 2026 09:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants