https://github.com/coreos/coreos-assembler
Tooling container to assemble CoreOS-like systems
https://github.com/coreos/coreos-assembler
buildsystem coreos fedora
Last synced: 7 months ago
JSON representation
Tooling container to assemble CoreOS-like systems
- Host: GitHub
- URL: https://github.com/coreos/coreos-assembler
- Owner: coreos
- License: apache-2.0
- Created: 2018-05-18T20:07:27.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2025-05-07T17:12:22.000Z (7 months ago)
- Last Synced: 2025-05-07T18:26:49.108Z (7 months ago)
- Topics: buildsystem, coreos, fedora
- Language: Go
- Homepage: https://coreos.github.io/coreos-assembler/
- Size: 83.8 MB
- Stars: 362
- Watchers: 33
- Forks: 174
- Open Issues: 91
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: code-of-conduct.md
Awesome Lists containing this project
README
# The CoreOS Assembler
This is the CoreOS Assembler (often abbreviated COSA) build environment. It is
a collection of various tools used to build [Fedora CoreOS][fcos] style
systems, including RHEL CoreOS. The goal is that everything needed to build and
test the OS comes encapsulated in one (admittedly large) container.
A high level goal of this tool is to support two highly related use cases, and
to keep them as similar as possible:
- Local development ("test a kernel change")
- Be a production build system orchestrated by an external tool (e.g. Jenkins)
See [fedora-coreos-pipeline][pipeline] as an example pipeline.
The container itself is available on [Quay.io](https://quay.io) at
[`quay.io/coreos-assembler/coreos-assembler`][quay-cosa]. It includes the
following tools:
- [`cosa`](docs/cosa.md): entrypoint for the COSA container and dispatcher to other
commands:
- To learn how to use COSA, see the
[Building Fedora CoreOS](docs/building-fcos.md) guide and the
[Working with CoreOS Assembler](docs/working.md) guide.
- To learn how to develop on COSA, see the
[CoreOS Assembler Design](docs/design.md) guide and the
[Working on CoreOS Assembler](docs/devel.md) guide.
- [`kola`](docs/kola.md): for launching instances and running tests on them
- [`kolet`](docs/kola.md#kolet): an agent for kola that runs on instances
- [`ore`](docs/mantle/ore.md): for interfacing with cloud providers
- [`plume`](docs/mantle/plume.md): for releasing Fedora CoreOS and Fedora Cloud
## Building Fedora CoreOS
See the [Building Fedora CoreOS](docs/building-fcos.md) guide to learn how to
build Fedora CoreOS with COSA.
## Building a custom OS with COSA
For more information about building a custom OS derived or based on Fedora
CoreOS, see [Custom OS](docs/custom.md).
[fcos]: https://coreos.fedoraproject.org
[pipeline]: https://github.com/coreos/fedora-coreos-pipeline
[quay-cosa]: https://quay.io/repository/coreos-assembler/coreos-assembler