agama/rust

Agama Command Line Interface

This project aims to build a command-line interface for Agama, a service-based Linux installer featuring a nice web interface.

Code organization

We have set up Cargo workspace with three packages:

• agama-lib: code that can be reused to access the Agama DBus API and a model for the configuration settings.
• agama-cli: code specific to the command line interface.
• agama-derive: includes a procedural macro to reduce the boilerplate code.

Status

Agama CLI is still a work in progress, although it is already capable of doing a few things:

• Querying and setting the configuration for the users, storage and software services.
• Handling the auto-installation profiles.
• Triggering the probing and the installation processes.

Installation

You can grab the RPM package from the YaST:Head:Agama project.

If you prefer, you can install it from sources with Cargo:

git clone https://github.com/yast/agama-cli
cargo install --path .

Running

Take into account that you need to run agama-cli as root when you want to query or change the Agama configuration. Assuming that the Agama D-Bus service is running, the next command prints the current settings using JSON (hint: you can use jq to make result look better):

$ sudo agama --format json config show
{"user":{"fullName":"","userName":"","password":"","autologin":false},"software":{"product":""}}

To set one or multiple parameters, just use the config set command:

$ sudo agama config set software.product=Tumbleweed user.fullName="Jane Doe" user.userName="jane.doe" user.password="12345" user.autologin=true

The following operation can take some time. Please, make sure to read the Caveats section for more information.

$ sudo agama config show
{"user":{"fullName":"Jane Doe","userName":"jane.doe","password":"","autologin":true},"software":{"product":"Tumbleweed"}}

If, at some point you want to force a new probing, you can ask Agama to repeat the process again:

$ sudo agama probe

It is possible to handle auto-installation profiles too:

$ agama profile download http://192.168.122.1/profile.jsonnet
$ agama profile evaluate profile.jsonnet > profile.json
$ agama profile validate profile.json

Now that you have a ready to use profile, you can load it into Agama:

$ sudo agama config load profile.json

Building and running

You can build and run the project using the cargo command:

cargo build
sudo ./target/debug/agama --help

A Testing Backend

The previous section assumes that the Agama D-Bus services are running on the same machine.

For an alternative setup using a containerized backend, see How to set up a backend for testing this frontend.

Caveats

• If no product is selected, the probe command fails.