ceos/agama

Ladislav Slezák d4f44b8a8e

## Problem

The Live ISO sources are not maintained at GitHub, that makes the
development complicated:

- Cannot track the changes easily, working with history in OBS is
limited and more complicated than with Git
- Changing files in tarballs is difficult, you have to unpack it, modify
a file and then manually compress back with correct parameters
- Building the Live ISO locally is not trivial

## Solution

- Move the sources into the `/live` subdirectory
- Add GitHub action for automatic submission from `master` to the
[systemsmanagement:Agama:Staging](https://build.opensuse.org/project/show/systemsmanagement:Agama:Staging)
OBS project
- Allow running the ISO build locally via `make build`

## Changes

The individual files were not touched, I just copied them from the
current OBS project. I only moved the `fw_cleanup.rb` script to the
`/tmp` directory as the script is temporary and it is deleted at the end
of the ISO build.

- All Kiwi tarballs were unpacked to Git
- Simple `make` builds the sources to the `dist` subdirectory and builds
the tarballs
- The ISO can be built locally using `make build`
- Updated/extended the documentation in README.md (There are two
README.md files, the main in `/live` which documents the details and the
`/live/src/README.md` which is copied to OBS. Mostl importantly it says
"do not touch this in OBS, use GitHub".)

## Testing

- Tested manually
- The autosubmission works (see the [GitHub action
log](https://github.com/lslezak/agama/actions/runs/8780447151/job/24090382501))
- The built ISO works (tested in my [agama-live
branch](https://build.opensuse.org/package/show/home:lslezak:branches:systemsmanagement:Agama:Staging/agama-live)
project)
- Local build works as well

---------

Co-authored-by: Imobach González Sosa <igonzalezsosa@suse.com>

2024-04-23 10:03:43 +02:00

2.6 KiB

Raw Permalink Blame History

Agama ISO Installer

Agama installer is deployed as a regular application which can be installed and run on a local system. However, the most expected way of using Agama is by running it on a live ISO image.

Sources

The Live ISO sources are maintained in the live subdirectory, See more details in a live/README.md documentation.

Live ISO Requirements

A live ISO for running Agama should provide the following software:

Hardware drivers.
Agama installer and related tools (lvm, cryptsetup, networkmanager, etc).
A browser to locally render the Agama web UI.
Optionally, repository packages of the products to install.

Notes:

If no browser is included, then the installation has to be remotely performed by using a browser from another machine. This would be the typical case for s390x installations.
If no repositories are included, then the installation would require internet connection to download the packages of the product to install.

Agama Live ISO (only for development and testing)

The Agama project provides a live ISO image for testing purposes and it is intended to be used for developers only. It has some limitations and it is not optimized for production usage.

Disclaimer: Agama project is focused on develop the Agama installer applications. Generating and optimizing production ready live ISO images for both SUSE and openSUSE projects is out of the scope.

Description

The live ISO is based on openSUSE Tumbleweed.
Allows installing both SUSE and openSUSE products.
Weighs around 1 GiB.
Contains Agama installer and tools, and hardware drivers.
Includes Firefox (except for ppc64le and s390x).
Does not include packages from product repositories.
Supported archs: x86_64, aarch64, ppc64le and s390x.