Viam Agent

A self-updating service manager that maintains the lifecycle for viam-server (as built from RDK) and other Viam provided system services.

For more information, see the Viam Agent documentation.

Agent is designed to run as a systemd service. First-time setup is sudo ./viam-agent --install and it will automatically update itself when new updates are released.

Development

Required tools

We use mise-en-place to manage golangci-lint. In the future this may expand to include other development tools. You can install it on MacOS and most Linux distributions with the following command:

curl https://mise.run | sh

Mise is also available in Homebrew and several package repositories. See the official documentation for a list of installation methods.

Makefile Targets

• make will build a viam-agent for your current CPU architecture. Note that as only linux is supported, this will be a linux binary.
• make arm64 arm64 specific build.
• make amd64 amd64 specific.
• make all will build for all (both) supported architectures.
• make lint to lint.

Version Tagging

The makefile will attempt to get a tagged version from Git. If you want to manually force a version, set TAG_VERSION=0.1.2 in the make command.
Note that there is no "v" in the actual version, though it is expected in git. E.g. a git tag of v0.1.2 becomes TAG_VERSION=0.1.2
Ex: make all TAG_VERSION=0.1.2

DevMode

Agent can be run directly (./viam-agent) outside of systemd for local development purposes. It will only manage viam-server by default. Network and system configuration management can be enabled with --enable-networking and --enable-syscfg. --viam-dir can be used to override the default /opt/viam location. See --help for the full list of options.

Systemd

The service configration lives in both viam-agent.service and preinstall.sh, and the two should be kept in sync when making changes.

Testing via serial

Some end-to-end workflows can be tested by connecting to a Raspberry Pi with a serial adapter. These tests can be run via a mise task but require additional setup:

• You must have a USB to serial adapter or some other means to connect to the serial port on your Raspberry Pi.
• Your Raspberry Pi must be configured to enable login on the serial port. This can be accomplished with the raspi-config cli or by manually editing config files. Refer to the upstream Raspberry Pi docs for details.
• The serial connection must already have a shell logged in as a user that can use sudo to become root without a password. To log in over the serial connection we recommend picocom. You can use it to connect to the serial terminal and login with picocom -b 115200 /dev/ttyUSB0. Depending on your setup the previous command may require sudo and the path to the tty device may be different. Once you have logged in you can disconnect from the serial console by typing Ctrl-a Ctrl-x.
• You must have a file named agent-test.toml in the root of this repo with app.viam API keys and other values required by the tests. You can also use this file to specify optional parameters, such as the path to the serial device. Refer to agent-test-example.toml for details.

Once these dependencies are satisfied you can execute the serial tests with mise r test-e2e-serial.