ya-runtime-dbg

A debugging tool for yagna runtimes based on runtime API.

Runtimes are execution environments for applications built on yagna; e.g. ya-runtime-vm executes user-built images in a Virtual Machine environment. A tutorial on building an app can be found here.

Installation

In order to use this tool, you need to install the runtime of your interest. To install the default runtimes, follow this part of the handbook.

Check the releases page for deb and tar.gz packages (x64 and Linux only) of this tool.

Command line

USAGE:
    ya-runtime-dbg [FLAGS] [OPTIONS] --runtime <runtime> --task-package <task-package> --workdir <workdir> [varargs]...

FLAGS:
        --no-deploy    Skip deployment phase
    -h, --help         Prints help information
    -V, --version      Prints version information

OPTIONS:
        --exec-mode <exec-mode>          Mode to execute commands in [default: shell]  [possible values:
                                         Shell, Exec]
        --exec-shell <exec-shell>        Execution shell (for "--exec-mode shell" or default mode) [default:
                                         bash]
    -r, --runtime <runtime>              Runtime binary
    -w, --workdir <workdir>              Working directory
    -t, --task-package <task-package>    Task package to deploy
    -p, --protocol <protocol>            Service protocol version [default: 0.1.0]

ARGS:
    <varargs>...    Additional runtime arguments

Example invocation

ya-runtime-dbg --runtime /usr/lib/yagna/plugins/ya-runtime-vm/ya-runtime-vm \
    --task-package /tmp/image.gvmi \
    --workdir /tmp/runtime \
    -- --cpu-cores 2

Available runtimes

Available runtimes can be discovered via ya-runtime topic on GH.