Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/golemfactory/ya-runtime-vm
Docker-like runtime enviroment implementation for Golem
https://github.com/golemfactory/ya-runtime-vm
golem ya-runtime
Last synced: 4 months ago
JSON representation
Docker-like runtime enviroment implementation for Golem
- Host: GitHub
- URL: https://github.com/golemfactory/ya-runtime-vm
- Owner: golemfactory
- License: gpl-2.0
- Created: 2020-06-01T09:09:43.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-30T12:55:13.000Z (4 months ago)
- Last Synced: 2024-10-01T01:57:00.360Z (4 months ago)
- Topics: golem, ya-runtime
- Language: C
- Homepage:
- Size: 24.8 MB
- Stars: 12
- Watchers: 11
- Forks: 15
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ya-runtime-vm
`ya-runtime-vm` is an implementation of a Docker-like runtime environment for Linux systems.
This repository consists of 2 crates:
- `ya-runtime-vm`
An application for running Virtual Machine images pre-built for yagna.
- `gvmkit`
A tool for converting Docker images into yagna Virtual Machine images and uploading them to a public repository.
Requires for [Docker](https://docs.docker.com/engine/install/ubuntu/) to be installed on your system.
## Building
Prerequisites:
- `rustc`
Recommendation: use the Rust toolchain installer from [https://rustup.rs/](https://rustup.rs/)
- `musl-gcc` and `gperf`
On a Ubuntu system, execute in terminal:
```bash
sudo apt install musl musl-tools gperf
```
Git checkout:
Init `runtime/init-container/liburing` submodule.
```bash
git submodule init
git submodule update
```
Building:
```bash
cd runtime
cargo build
```
## Installing
Prerequisites:
- `cargo-deb`
Cargo helper command which automatically creates binary Debian packages. With Rust already installed, execute in terminal:
```bash
cargo install cargo-deb
```
Installation:
In terminal, change the working directory to `runtime` and install a freshly minted Debian package.
```bash
cd runtime
sudo dpkg -i $(cargo deb | tail -n1)
```
This will install the binary at `/usr/lib/yagna/plugins/ya-runtime-vm/ya-runtime-vm`.
## Command line
Follow the installation section before executing.
```
ya-runtime-vm 0.2.5
USAGE:
ya-runtime-vm [OPTIONS]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-w, --workdir
-t, --task-package
--cpu-cores [default: 1]
--mem-gib [default: 0.25]
--storage-gib [default: 0.25]
SUBCOMMANDS:
test Perform a self-test
offer-template Print the market offer template (JSON)
deploy Deploy an image
start Start a deployed image
help Prints this message or the help of the given subcommand(s)
```
## Caveats
- Docker `VOLUME` command
Directories specified in the `VOLUME` command are a mountpoint for directories on the host filesystem. Contents
of those directories will appear as empty during execution.
If you need to place static assets inside the image, try not to use the `VOLUME` command for that directory.