Este conteúdo não está disponível no idioma selecionado.
Chapter 2. Setting up RHEL image builder
Use RHEL image builder to create your customized RHEL for Edge images. After you install RHEL image builder on a RHEL system, RHEL image builder is available as an application in RHEL web console. You can also access RHEL image builder on the command line by using the composer-cli
tool.
It is recommended to install RHEL image builder on a virtual machine.
2.1. Image builder system requirements
The environment where RHEL image builder runs, for example a virtual machine, must meet the requirements that are listed in the following table.
Running RHEL image builder inside a container is not supported.
Parameter | Minimal Required Value |
System type | A dedicated virtual machine |
Processor | 2 cores |
Memory | 4 GiB |
Disk space | 20 GiB |
Access privileges | Administrator level (root) |
Network | Connectivity to Internet |
The 20 GiB disk space requirement is enough to install and run RHEL image builder in the host. To build and deploy image builds, you must allocate additional dedicated disk space.
2.2. Installing RHEL image builder
To install RHEL image builder on a dedicated virtual machine, follow these steps:
Prerequisites
- The virtual machine is created and is powered on.
- You have installed RHEL and you have subscribed to RHSM or Red Hat Satellite.
-
You have enabled the
BaseOS
andAppStream
repositories to be able to install the RHEL image builder packages.
Procedure
Install the following packages on the virtual machine.
- osbuild-composer
- composer-cli
- cockpit-composer
- bash-completion
- firewalld
# dnf install osbuild-composer composer-cli cockpit-composer bash-completion firewalld
RHEL image builder is installed as an application in RHEL web console.
- Reboot the virtual machine
Configure the system firewall to allow access to the web console:
# firewall-cmd --add-service=cockpit && firewall-cmd --add-service=cockpit --permanent
Enable RHEL image builder.
# systemctl enable osbuild-composer.socket cockpit.socket --now
The osbuild-composer and cockpit services start automatically on first access.
Load the shell configuration script so that the autocomplete feature for the
composer-cli
command starts working immediately without reboot:$ source /etc/bash_completion.d/composer-cli
Additional resources