Este conteúdo não está disponível no idioma selecionado.

Chapter 1. RHEL image builder description


You can use RHEL image builder to create customized RHEL system images, including images for deployment on cloud platforms. By using RHEL image builder, you can automatically handle setup details for each output type, making it easier and faster than manual image creation. You can access RHEL image builder by using the image-builder CLI tool or the graphical user interface in the RHEL web console.

The image-builder tool, available as a Technology Preview, has the following characteristics:

  • A simpler installation and environment configuration.
  • You can work with a container-friendly daemonless model, removing the complexity of a client/server architecture.
  • You can use image-builder for automated pipelines and container-based builds.
  • image-builder supports creating a container image that you can use as a portable environment to build other images.

1.1. RHEL image builder terminology

RHEL image builder uses specific terminology for its core concepts.

Blueprint

A blueprint is a description of a customized system image. It lists the packages and customizations that will be part of the system. You can edit blueprints with customizations and save them as a particular version. When you create a system image from a blueprint, the image is associated with the blueprint in the RHEL image builder interface.

Create blueprints in the TOML format.

Compose
Composes are individual builds of a system image, based on a specific version of a particular blueprint. Compose as a term refers to the system image, the logs from its creation, inputs, metadata, and the process itself.
Customizations
Customizations are specifications for the image that are not packages. This includes users, groups, and SSH keys.

1.2. RHEL image builder output formats

RHEL image builder can create images in multiple output formats shown in the table.

Expand
Table 1.1. RHEL image builder output formats
DescriptionCLI nameFile extensionArchitecture

Amazon Web Services

ami

.ami

aarch64, x86_64

Disk Archive

tar

.tar

aarch64, x86_64, ppc64le, s390x

Google Cloud

gce

.tar.gz

x86_64

Microsoft Azure

vhd

.vhd

aarch64, x86_64

OpenStack

qcow2

.qcow2

aarch64, x86_64, ppc64le, s390x

Oracle Cloud Infrastructure

.oci

.qcow2

x86_64

QEMU Image

qcow2

.qcow2

aarch64, x86_64, ppc64le, s390x

RHEL Installer

image-installer

.iso

aarch64, x86_64

VMware vSphere

vmdk

.vmdk

x86_64

VMware vSphere

ova

.ova

x86_64

Vagrant

vagrant-libvirt

.qcow2

aarch64, x86_64

Windows Subsystem for Linux

wsl

.wsl

aarch64, x86_64

To check the supported types, run the command:

# image-builder list

1.3. Supported architectures for image builds

RHEL image builder supports building images for several architectures.

The supported architectures include:

  • AMD and Intel 64-bit (x86_64)
  • ARM64 (aarch64)
  • IBM Z (s390x)
  • IBM POWER systems (ppc64)

However, RHEL image builder does not support multi-architecture builds. It only builds images of the same system architecture that it is running on. For example, if RHEL image builder is running on an x86_64 system, it can only build images for the x86_64 architecture.

Red Hat logoGithubredditYoutubeTwitter

Aprender

Experimente, compre e venda

Comunidades

Sobre a documentação da Red Hat

Ajudamos os usuários da Red Hat a inovar e atingir seus objetivos com nossos produtos e serviços com conteúdo em que podem confiar. Explore nossas atualizações recentes.

Tornando o open source mais inclusivo

A Red Hat está comprometida em substituir a linguagem problemática em nosso código, documentação e propriedades da web. Para mais detalhes veja o Blog da Red Hat.

Sobre a Red Hat

Fornecemos soluções robustas que facilitam o trabalho das empresas em plataformas e ambientes, desde o data center principal até a borda da rede.

Theme

© 2026 Red Hat
Voltar ao topo