https://github.com/fyralabs/anda

A modern Build/CI System
https://github.com/fyralabs/anda

ci docker-image flatpak mock packaging-tool rpm-spec rust

Last synced: 1 day ago
JSON representation

A modern Build/CI System

• Host: GitHub
• URL: https://github.com/fyralabs/anda
• Owner: FyraLabs
• License: mit
• Created: 2022-06-08T15:58:58.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-11-11T07:41:29.000Z (3 days ago)
• Last Synced: 2024-11-11T08:31:09.443Z (3 days ago)
• Topics: ci, docker-image, flatpak, mock, packaging-tool, rpm-spec, rust
• Language: Rust
• Homepage: https://crates.io/crates/anda
• Size: 2.54 MB
• Stars: 35
• Watchers: 5
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        


# Andaman

Andaman is a package build toolchain written in Rust. It is designed to simplify building various types of packages.

It is inspired by `umpkg` and aims to be a more modern and flexible alternative. It is also designed for monorepos in mind, so you can define multiple projects with multiple package formats in a single repository.

You can look into [the Fyra Wiki page](https://wiki.fyralabs.com/Andaman) and [the Terra Devdocs](https://developer.fyralabs.com/terra/autoupdate) for more technical details.

# Installation

On systems with [Terra](https://terra.fyralabs.com), you can install it with `sudo dnf5 in anda` (or dnf).

On systems with Cargo, you can install it with `cargo install anda`.

Alternatively you can also manually download the sources from GitHub:

```sh

git clone https://github.com/FyraLabs/anda

cd anda

git checkout 0.1.18

cargo install --path .

```

## How it works

Andaman is simply a meta-build system that calls upon other build systems to build and distribute packages. It works by reading a project manifest in `anda.hcl` and then calling the appropriate build system to build the package.

## Features

- Building RPMs

- Building Docker/Podman/OCI images

- Building Flatpak packages

## How we use it at Fyra Labs

We use Andaman to quickly build packages for our distributions, [Ultramarine Linux] and [TauOS].

Another notable usage is the [Terra] repository, which provides more than 1000 packages for Fedora-based distributions.

The artifacts generated by Andaman are then sent to [Subatomic], our compose and repository manager.

## History

The Andaman project has gone through many forms. We initially wrote Andaman as a custom RPM frontend as an alternative to DNF that is similar to that of an AUR helper. However, there were issues with rust and RPM support and we decided to move to a more general CI server based on BuildKit. This however turned into a massive feature creep of projects and so we decided to simply write a build system that can build artifacts for various package formats.

[Subatomic]: https://github.com/FyraLabs/subatomic

[Terra]: https://terra.fyralabs.com

[Ultramarine Linux]: https://ultramarine-linux.org

[TauOS]: https://github.com/tau-OS