|
Packit |
63bb0d |
================
|
|
Packit |
63bb0d |
osbuild-composer
|
|
Packit |
63bb0d |
================
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
------------------------
|
|
Packit |
63bb0d |
OSBuild Composer Service
|
|
Packit |
63bb0d |
------------------------
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
:Manual section: 7
|
|
Packit |
63bb0d |
:Manual group: Miscellaneous
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
DESCRIPTION
|
|
Packit |
63bb0d |
===========
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
The composer project is a set of HTTP services for composing operating system
|
|
Packit |
63bb0d |
images. It builds on the pipeline execution engine of *osbuild* [#osbuild]_ and
|
|
Packit |
63bb0d |
defines its own class of images that it supports building.
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
Multiple APIs are available to access a composer service. This includes
|
|
Packit |
63bb0d |
support for the *lorax-composer* [#lorax-github]_ API, and as
|
|
Packit |
63bb0d |
such can serve as drop-in replacement for lorax-composer.
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
You can control a composer instance either directly via the provided APIs, or
|
|
Packit |
63bb0d |
through higher-level user-interfaces from external projects. This, for
|
|
Packit |
63bb0d |
instance, includes a *Cockpit Module* [#cockpit-composer]_ or using the
|
|
Packit |
63bb0d |
*composer-cli* [#composer-cli]_ command-line tool.
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
Frontends
|
|
Packit |
63bb0d |
---------
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
*Composer* does not ship with frontends itself. However, several external
|
|
Packit |
63bb0d |
frontends for *Composer* already exist. These include:
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
**Cockpit Composer**
|
|
Packit |
63bb0d |
This module for *Cockpit* [#cockpit]_ allows a great level of control of a
|
|
Packit |
63bb0d |
*Composer* instance running on a cockpit-managed machine.
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
**Composer CLI**
|
|
Packit |
63bb0d |
This command-line tool originated in the *lorax* [#lorax-github]_ project,
|
|
Packit |
63bb0d |
but can be used with *Composer* just as well.
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
RUNNING
|
|
Packit |
63bb0d |
=======
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
To deploy a composer instance, all you need is to
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
|
|
|
Packit |
63bb0d |
| # systemctl start osbuild-composer.socket
|
|
Packit |
63bb0d |
|
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
Now you can access the service using `composer-cli`, for example:
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
|
|
|
Packit |
63bb0d |
| # composer-cli status show
|
|
Packit |
63bb0d |
|
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
or using *Cockpit* with the *Cockpit Composer* module from a
|
|
Packit |
63bb0d |
browser: `http://localhost:9090`
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
SEE ALSO
|
|
Packit |
63bb0d |
========
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
``osbuild``\(1), ``osbuild-manifest``\(5)
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
NOTES
|
|
Packit |
63bb0d |
=====
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
.. [#osbuild] OSBuild:
|
|
Packit |
63bb0d |
https://www.osbuild.org
|
|
Packit |
63bb0d |
.. [#lorax-github] Lorax Composer:
|
|
Packit |
63bb0d |
https://github.com/weldr/lorax
|
|
Packit |
63bb0d |
.. [#cockpit-composer] Cockpit Composer:
|
|
Packit |
63bb0d |
https://github.com/osbuild/cockpit-composer
|
|
Packit |
63bb0d |
.. [#composer-cli] Composer CLI:
|
|
Packit |
63bb0d |
https://weldr.io/lorax/composer-cli.html
|
|
Packit |
63bb0d |
.. [#cockpit] Cockpit Project:
|
|
Packit |
63bb0d |
https://www.cockpit-project.org/
|