Ce contenu n'est pas disponible dans la langue sélectionnée.
Chapter 4. Composing a RHEL for Edge image using image builder in RHEL web console
Use RHEL image builder to create a custom RHEL for Edge image (OSTree commit).
To access RHEL image builder and to create your custom RHEL for Edge image, you can either use the RHEL web console interface or the command line.
You can compose RHEL for Edge images by using RHEL image builder in RHEL web console by performing the following high-level steps:
- Access RHEL image builder in RHEL web console
- Create a blueprint for RHEL for Edge image.
Create a RHEL for Edge image. You can create the following images:
- RHEL for Edge Commit image.
- RHEL for Edge Container image.
- RHEL for Edge Installer image.
- Download the RHEL for Edge image
4.1. Accessing RHEL image builder in the RHEL web console Copier lienLien copié sur presse-papiers!
To access RHEL image builder in RHEL web console, ensure that you have met the following prerequisites and then follow the procedure.
Prerequisites
- You have installed a RHEL system.
- You have administrative rights on the system.
- You have subscribed the RHEL system to Red Hat Subscription Manager (RHSM) or to Red Hat Satellite Server.
- Your system is powered on and accessible over the network.
- You have installed RHEL image builder on the system.
Procedure
- On your RHEL system, access https://localhost:9090/ in a web browser.
- For more information about how to remotely access RHEL image builder, see Managing systems using the RHEL 8 web console document.
- Log in to the web console using an administrative user account.
- On the web console, in the left hand menu, click .
Click .
The RHEL image builder dashboard opens in the right pane. You can now proceed to create a blueprint for the RHEL for Edge images.
4.2. Creating a blueprint for a RHEL for Edge image using image builder in the web console Copier lienLien copié sur presse-papiers!
To create a blueprint for a RHEL for Edge image by using RHEL image builder in RHEL web console, ensure that you have met the following prerequisites and then follow the procedure.
Prerequisites
- On a RHEL system, you have opened the RHEL image builder dashboard.
Procedure
On the RHEL image builder dashboard, click .
The Create Blueprint dialogue box opens.
On the
Detailspage:- Enter the name of the blueprint and, optionally, its description. Click .
Optional: In the
Packagespage:On the
Available packagessearch, enter the package name and click the button to move it to the Chosen packages field. Search and include as many packages as you want. Click .NoteThese customizations are all optional unless otherwise specified.
-
On the
Kernelpage, enter a kernel name and the command-line arguments. -
On the
File systempage, selectUse automatic partitioning. OSTree systems do not support filesystem customization, because OSTree images have their own mount rule, such as read-only. Click . On the
Servicespage, you can enable or disable services:- Enter the service names you want to enable or disable, separating them by a comma, by space, or by pressing the key. Click .
On the
Firewallpage, set up your firewall setting:-
Enter the
Ports, and the firewall services you want to enable or disable. - Click the button to manage your firewall rules for each zone independently. Click .
-
Enter the
On the
Userspage, add a users by following the steps:- Click .
-
Enter a
Username, apassword, and aSSH key. You can also mark the user as a privileged user, by clicking theServer administratorcheckbox. Click .
On the
Groupspage, add groups by completing the following steps:Click the button:
-
Enter a
Group nameand aGroup ID. You can add more groups. Click .
-
Enter a
On the
SSH keyspage, add a key:Click the button.
- Enter the SSH key.
-
Enter a
User. Click .
On the
Timezonepage, set your timezone settings:On the
Timezonefield, enter the timezone you want to add to your system image. For example, add the following timezone format: "US/Eastern".If you do not set a timezone, the system uses Universal Time, Coordinated (UTC) as default.
-
Enter the
NTPservers. Click .
On the
Localepage, complete the following steps:-
On the
Keyboardsearch field, enter the package name you want to add to your system image. For example: ["en_US.UTF-8"]. -
On the
Languagessearch field, enter the package name you want to add to your system image. For example: "us". Click .
-
On the
On the
Otherspage, complete the following steps:-
On the
Hostnamefield, enter the hostname you want to add to your system image. If you do not add a hostname, the operating system determines the hostname. -
Mandatory only for the Simplifier Installer image: On the
Installation Devicesfield, enter a valid node for your system image. For example:dev/sda. Click .
-
On the
Mandatory only when building FIDO images: On the
FIDO device onboardingpage, complete the following steps:On the
Manufacturing server URLfield, enter the following information:-
On the
DIUN public key insecurefield, enter the insecure public key. -
On the
DIUN public key hashfield, enter the public key hash. -
On the
DIUN public key root certsfield, enter the public key root certs. Click .
-
On the
On the
OpenSCAPpage, complete the following steps:-
On the
Datastreamfield, enter thedatastreamremediation instructions you want to add to your system image. -
On the
Profile IDfield, enter theprofile_idsecurity profile you want to add to your system image. Click .
-
On the
Mandatory only when building Ignition images: On the
Ignitionpage, complete the following steps:-
On the
Firstboot URLfield, enter the package name you want to add to your system image. -
On the
Embedded Datafield, drag or upload your file. Click .
-
On the
-
. On the
Reviewpage, review the details about the blueprint. Click .
The RHEL image builder view opens, listing existing blueprints.
4.3. Creating a RHEL for Edge image Copier lienLien copié sur presse-papiers!
Create a RHEL for Edge image. Choose one of the following image types, according to your needs.
4.3.1. Creating a RHEL for Edge Commit image by using image builder in web console Copier lienLien copié sur presse-papiers!
You can create a “RHEL for Edge Commit” image by using RHEL image builder in RHEL web console. The “RHEL for Edge Commit (.tar)” image type contains a full operating system, but it is not directly bootable. To boot the Commit image type, you must deploy it in a running container.
Prerequisites
- On a RHEL system, you have accessed the RHEL image builder dashboard.
Procedure
- On the RHEL image builder dashboard click .
On the Image output page, perform the following steps:
- From the Select a blueprint dropdown menu, select the blueprint you want to use.
- From the Image output type dropdown list, select “RHEL for Edge Commit (.tar)”.
- Click .
On the OSTree settings page, enter:
- Repository URL: specify the URL to the OSTree repository of the commit to embed in the image. For example, http://10.0.2.2:8080/repo/.
- Parent commit: specify a previous commit, or leave it empty if you do not have a commit at this time.
-
In the Ref text box, specify a reference path for where your commit is going to be created. By default, the web console specifies
rhel/8/$ARCH/edge. The "$ARCH" value is determined by the host machine. Click .
On the Review page, check the customizations and click .
RHEL image builder starts to create a RHEL for Edge Commit image for the blueprint that you created.
NoteThe image creation process takes up to 20 minutes to complete.
Verification
To check the RHEL for Edge Commit image creation progress:
- Click the tab.
After the image creation process is complete, you can download the resulting “RHEL for Edge Commit (.tar)” image.
4.3.2. Creating a RHEL for Edge Container image by using RHEL image builder in RHEL web console Copier lienLien copié sur presse-papiers!
You can create RHEL for Edge images by selecting “RHEL for Edge Container (.tar)”. The RHEL for Edge Container (.tar) image type creates an OSTree commit and embeds it into an OCI container with a web server. When the container is started, the web server serves the commit as an OSTree repository.
Follow the steps in this procedure to create a RHEL for Edge Container image using image builder in RHEL web console.
Prerequisites
- On a RHEL system, you have accessed the RHEL image builder dashboard.
- You have created a blueprint.
Procedure
- On the RHEL image builder dashboard click .
- On the Image output page, perform the following steps:
From the Select a blueprint dropdown menu, select the blueprint you want to use.
- From the Image output type dropdown list, select “RHEL for Edge Container (.tar)”.
- Click .
On the OSTree page, enter:
Repository URL: specify the URL to the OSTree repository of the commit to embed in the image. For example, http://10.0.2.2:8080/repo/. By default, the repository folder for a RHEL for Edge Container image is "/repo".
To find the correct URL to use, access the running container and check the
nginx.conffile. To find which URL to use, access the running container and check thenginx.conffile. Inside thenginx.conffile, find therootdirectory entry to search for the/repo/folder information. Note that, if you do not specify a repository URL when creating a RHEL for Edge Container image(.tar)by using RHEL image builder, the default/repo/entry is created in thenginx.conffile.- Parent commit: specify a previous commit, or leave it empty if you do not have a commit at this time.
-
In the Ref text box, specify a reference path for where your commit is going to be created. By default, the web console specifies
rhel/8/$ARCH/edge. The "$ARCH" value is determined by the host machine. Click .
- On the Review page, check the customizations. Click .
Click .
RHEL image builder starts to create a RHEL for Edge Container image for the blueprint that you created.
NoteThe image creation process takes up to 20 minutes to complete.
Verification
To check the RHEL for Edge Container image creation progress:
- Click the tab.
After the image creation process is complete, you can download the resulting “RHEL for Edge Container (.tar)” image.
4.3.3. Creating a RHEL for Edge Installer image by using image builder in RHEL web console Copier lienLien copié sur presse-papiers!
You can create RHEL for Edge Installer images by selecting RHEL for Edge Installer (.iso). The RHEL for Edge Installer (.iso) image type pulls the OSTree commit repository from the running container served by the RHEL for Edge Container (.tar) and creates an installable boot ISO image with a Kickstart file that is configured to use the embedded OSTree commit.
Follow the steps in this procedure to create a RHEL for Edge image using image builder in RHEL web console.
Prerequisites
- On a RHEL system, you have accessed the image builder dashboard.
- You created a blueprint.
- You created a RHEL for Edge Container image and loaded it into a running container. See Creating a RHEL for Edge Container image for non-network-based deployments.
Procedure
- On the RHEL image builder dashboard click .
On the Image output page, perform the following steps:
- From the Select a blueprint dropdown menu, select the blueprint you want to use.
-
From the Image output type dropdown list, select RHEL for Edge Installer (
.iso) image. - Click .
On the OSTree settings page, enter:
- Repository URL: specify the URL to the OSTree repository of the commit to embed in the image. For example, http://10.0.2.2:8080/repo/.
-
In the Ref text box, specify a reference path for where your commit is going to be created. By default, the web console specifies
rhel/8/$ARCH/edge. The "$ARCH" value is determined by the host machine. Click .
- On the Review page, check the customizations. Click .
Click .
RHEL image builder starts to create a RHEL for Edge Installer image for the blueprint that you created.
NoteThe image creation process takes up to 20 minutes to complete.
Verification
To check the RHEL for Edge Installer image creation progress:
- Click the tab.
After the image creation process is complete, you can download the resulting RHEL for Edge Installer (.iso) image and boot the ISO image into a device.
4.4. Downloading a RHEL for Edge image Copier lienLien copié sur presse-papiers!
After you successfully create the RHEL for Edge image by using RHEL image builder, download the image on the local host.
Procedure
To download an image:
From the More Options menu, click .
The RHEL image builder tool downloads the file at your default download location.
The downloaded file consists of a .tar file with an OSTree repository for RHEL for Edge Commit and RHEL for Edge Container images, or a .iso file for RHEL for Edge Installer images, with an OSTree repository. This repository contains the commit and a json file which contains information metadata about the repository content.