Experimental implementation of the oci-runtime in Rust
youki is an implementation of runtime-spec in Rust, referring to runc. This project is in the experimental stage at this point. I think Rust is one of the best languages to implement oci-runtime, so I'm having fun experimenting with it.
Two types of building are available: devcontainer or local. You can choose whichever you like, but the local one will only work on Linux.
- Rust(See here)
$ git clone [email protected]:utam0k/youki.git $ cargo build $ RUST_BACKTRACE=full YOUKI_LOG_LEVEL=debug YOUKI_MODE=/var/lib/docker/containers/ dockerd --experimental --add-runtime="youki=$(pwd)/target/x86_64-unknown-linux-gnu/debug/youki"
The following explanation assumes that devcontainer is used. The first time it starts up will take a while, so have a cup of coffee and wait ;)
This commands should be run runs in your local terminal.
$ git clone [email protected]:utam0k/youki.git $ code youki
And use devcontainer in your vscode.
dockerd is already running when you start devcontainer. You can get more information about the startup process by referring to
youki with Docker
$ docker run -it --rm --runtime youki hello-world $ docker run -it --rm --runtime youki busybox
$ /workspaces/youki/.devcontainer/scripts/setup_test.sh # only the first time $ /workspaces/youki/.devcontainer/scripts/test.sh
HelloWorld with youki
Hello, World using the log function of Youki. If you want to explore youki, please use it.
Try adding the following code to the line in
src/main.rs after initializing the logger of the main function and try to
cargo build in your terminal.
When you run busybox, sh will start and stop.
$ docker run -it --rm --runtime youki --name youki busybox
If you run the following command in a different terminal, you will see the
Hello, World that you added above.
$ docker logs youki
- somehow works
- run with docker
This project welcomes your PR and issues. For example, refactoring, adding features, correcting English, etc. If you need any help, you can contact me on Twitter.