herolib/examples/builder/remote_executor/README.md

Remote Executor Example

This example demonstrates how to compile and execute V code remotely using SSH.

It shows a practical implementation of the herolib builder's remote execution capabilities, its good for debugging.

Components

toexec.v

A V program that demonstrates remote execution of system operations:

• Uses herolib's osal and installer modules
• Currently configured to uninstall brew as an example operation
• Can be modified to execute any remote system commands

important the source & target system needs to be same architecture

run.sh

A bash script that:

1. Compiles the V program
2. Copies it to a remote machine using SCP
3. Executes it remotely using SSH

Prerequisites

1. SSH access to the remote machine
2. The SECRET environment variable must be set
3. V compiler installed locally

Configuration

The run.sh script uses the following default configuration:

remote_user='despiegk'
remote_host='192.168.99.1'
remote_path='/Users/despiegk/hero/bin/toexec'
remote_port='2222'

Modify these values to match your remote system configuration.

Usage

1. Set the required environment variable:

export SECRET=your_secret_value

2. Make the script executable:

chmod +x run.sh

3. Run the script:

./run.sh

Integration with Builder

This example demonstrates practical usage of the herolib builder module's remote execution capabilities. For more complex implementations, see the builder documentation in lib/builder/readme.md.

The builder module provides a more structured way to manage remote nodes and execute commands:

import incubaid.herolib.builder
mut b := builder.new()!
mut n := b.node_new(ipaddr:"user@host:port")!
// Execute commands on the remote node