Repository files navigation

This is the CoreOS Assembler (often abbreviated COSA) build environment. It isa collection of various tools used to buildFedora CoreOS stylesystems, including RHEL CoreOS. The goal is that everything needed to build andtest the OS comes encapsulated in one (admittedly large) container.

A high level goal of this tool is to support two highly related use cases, andto 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)

Seefedora-coreos-pipeline as an example pipeline.

The container itself is available onQuay.io atquay.io/coreos-assembler/coreos-assembler. It includes thefollowing tools:

• cosa: entrypoint for the COSA container and dispatcher to othercommands:
  • To learn how to use COSA, see theBuilding Fedora CoreOS guide and theWorking with CoreOS Assembler guide.
  • To learn how to develop on COSA, see theCoreOS Assembler Design guide and theWorking on CoreOS Assembler guide.
• kola: for launching instances and running tests on them
• kolet: an agent for kola that runs on instances
• ore: for interfacing with cloud providers
• plume: for releasing Fedora CoreOS and Fedora Cloud

See theBuilding Fedora CoreOS guide to learn how tobuild Fedora CoreOS with COSA.

For more information about building a custom OS derived or based on FedoraCoreOS, seeCustom OS.