Services
The following is a list of methods to use for debugging and running services.
Run a service locally (without roverd)
If your service is a valid Linux program, you can run it locally (on your own machine) without using roverd to build or execute it. This can be useful to quickly test without the Rover, or to run advanced debug tooling.
To execute locally, you will need to inject the correct bootspec into the service's runtime environment. The easiest way to do this is to create a bootspec.json file and cat it into the ASE_SERVICE environment, like so:
# Inject the variable
export ASE_SERVICE=$(cat bootspec.json)
# Now run the command in your service.yaml commands.run field
# For example:
./bin/my-service
Be aware that you need to create the bootspec yourself. Normally, ports and protocols are chosen by roverd, but if you want to run multiple services locally, you need to ensure that the ports and protocols in each bootspec align.
Modify service files on the Rover
It is not recommended to change or manage service files on the Rover. You should use roverctl upload instead.
After uploading a service, connect to the Rover over SSH or UART and cd into the service directory. You can attempt building and running the service on the Rover without roverd similar to building and running locally.