This project aims to build a command-line interface for Agama, a service-based Linux installer featuring a nice web interface.
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.
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.
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 .
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
You can build and run the project using the cargo command:
cargo build
sudo ./target/debug/agama --help
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.
- If no product is selected, the
probecommand fails.