Kontainer Runtime

Kontainer Runtime is a low layer container runtime written in Kotlin/Native.

Documentation

Full documentation is published at https://ternbusty.github.io/kontainer-runtime/.

• Getting started
• Architecture
• containerd integration
• Contributing

How to Run

Build

./gradlew linkDebugExecutableLinuxX64

Run

To create a container whose name is test from a bundle located at test-bundle, use the following command

sudo ./build/bin/linuxX64/debugExecutable/kontainer-runtime.kexe create --bundle test-bundle test

To start the container

sudo ./build/bin/linuxX64/debugExecutable/kontainer-runtime.kexe start test

To create and start the container in a single step

sudo ./build/bin/linuxX64/debugExecutable/kontainer-runtime.kexe run --bundle test-bundle test

To get the status of the container

sudo ./build/bin/linuxX64/debugExecutable/kontainer-runtime.kexe state test

To list all containers

sudo ./build/bin/linuxX64/debugExecutable/kontainer-runtime.kexe list

To pause the container

sudo ./build/bin/linuxX64/debugExecutable/kontainer-runtime.kexe pause test

To resume the container

sudo ./build/bin/linuxX64/debugExecutable/kontainer-runtime.kexe resume test

To update the container's resource limits

sudo ./build/bin/linuxX64/debugExecutable/kontainer-runtime.kexe update --memory 134217728 --pids-limit 100 test

To get a snapshot of the container's resource usage

sudo ./build/bin/linuxX64/debugExecutable/kontainer-runtime.kexe events --stats test

To list processes in the container

sudo ./build/bin/linuxX64/debugExecutable/kontainer-runtime.kexe ps test

To execute a process in the container

sudo ./build/bin/linuxX64/debugExecutable/kontainer-runtime.kexe exec test -- sh -c "echo hello"

To stop the container

sudo ./build/bin/linuxX64/debugExecutable/kontainer-runtime.kexe kill test SIGKILL

To delete the container

sudo ./build/bin/linuxX64/debugExecutable/kontainer-runtime.kexe delete test

License

Apache License 2.0. See LICENSE for the full text.