https://github.com/iximiuz/shimmy
Simplistic container runtime shim
https://github.com/iximiuz/shimmy
container-runtime containers rust
Last synced: about 2 months ago
JSON representation
Simplistic container runtime shim
- Host: GitHub
- URL: https://github.com/iximiuz/shimmy
- Owner: iximiuz
- Created: 2019-10-09T20:25:48.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-12-25T11:25:03.000Z (over 2 years ago)
- Last Synced: 2025-03-14T21:46:38.083Z (2 months ago)
- Topics: container-runtime, containers, rust
- Language: Rust
- Homepage: https://iximiuz.com/en/posts/implementing-container-runtime-shim/
- Size: 88.9 KB
- Stars: 41
- Watchers: 3
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# shimmy - container runtime shim
Shimmy is a simplistic shim between _container manager_ and _container runtime_. It's primary designed to make programmatic _runc_ execution more friendly for the launching process. It does a couple of handy things:
- Detaches container runtime process from the launching process.
- Forwards container STDOUT and STDERR to logs.
- Tracks container termination and writes its status on disk.
- [TODO] Allows attaching to container STDIN to forward some data in.
- [TODO] Allows attaching to container STDOUT & STDERR to read some data from.
- [TODO] PTY-driven attaching.
Similar projects:
- conmon
- containerd runtime shim
Read more about the project on my blog:
- Implementing container runtime shim: runc
- Implementing container runtime shim: first code
## Usage
```bash
# build debug version
cargo build --bin shimmy
# build release version
cargo build --bin shimmy --release
# integrational tests (conman is required)
https://github.com/iximiuz/conman/blob/v0.0.2/test/shimmy/shimmy_test.go
```