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 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 9 web console document. Log in to the web console using an administrative user account. On the web console, in the left hand menu, click Apps . Click Image Builder . 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 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 Create Blueprint . The Create Blueprint dialogue box opens. On the Details page: Enter the name of the blueprint and, optionally, its description. Click . Optional: In the Packages page: On the Available packages search, 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 . Note These customizations are all optional unless otherwise specified. On the Kernel page, enter a kernel name and the command-line arguments. On the File system page, select Use automatic partitioning . OSTree systems do not support filesystem customization, because OSTree images have their own mount rule, such as read-only. Click . On the Services page, 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 Enter key. Click . On the Firewall page, set up your firewall setting: Enter the Ports , and the firewall services you want to enable or disable. Click the Add zone button to manage your firewall rules for each zone independently. Click . On the Users page, add a users by following the steps: Click Add user . Enter a Username , a password , and a SSH key . You can also mark the user as a privileged user, by clicking the Server administrator checkbox. Click . On the Groups page, add groups by completing the following steps: Click the Add groups button: Enter a Group name and a Group ID . You can add more groups. Click . On the SSH keys page, add a key: Click the Add key button. Enter the SSH key. Enter a User . Click . On the Timezone page, set your timezone settings: On the Timezone field, 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 NTP servers. Click . On the Locale page, complete the following steps: On the Keyboard search field, enter the package name you want to add to your system image. For example: ["en_US.UTF-8"]. On the Languages search field, enter the package name you want to add to your system image. For example: "us". Click . On the Others page, complete the following steps: On the Hostname field, 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 Devices field, enter a valid node for your system image. For example: dev/sda . Click . Mandatory only when building FIDO images: On the FIDO device onboarding page, complete the following steps: On the Manufacturing server URL field, enter the following information: On the DIUN public key insecure field, enter the insecure public key. On the DIUN public key hash field, enter the public key hash. On the DIUN public key root certs field, enter the public key root certs. Click . On the OpenSCAP page, complete the following steps: On the Datastream field, enter the datastream remediation instructions you want to add to your system image. On the Profile ID field, enter the profile_id security profile you want to add to your system image. Click . Mandatory only when building Ignition images: On the Ignition page, complete the following steps: On the Firstboot URL field, enter the package name you want to add to your system image. On the Embedded Data field, drag or upload your file. Click . . On the Review page, review the details about the blueprint. Click Create . The RHEL image builder view opens, listing existing blueprints. 4.3. Creating a RHEL for Edge image 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 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 Create Image . 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 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/9/USDARCH/edge . The "USDARCH" value is determined by the host machine. Click . On the Review page, check the customizations and click Create . RHEL image builder starts to create a RHEL for Edge Commit image for the blueprint that you created. Note The image creation process takes up to 20 minutes to complete. Verification To check the RHEL for Edge Commit image creation progress: Click the Images tab. After the image creation process is complete, you can download the resulting "RHEL for Edge Commit (.tar)" image. Additional resources Downloading a RHEL for Edge image 4.3.2. Creating a RHEL for Edge Container image by using RHEL image builder in RHEL web console 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 Create Image . 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.conf file. To find which URL to use, access the running container and check the nginx.conf file. Inside the nginx.conf file, find the root directory 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 the nginx.conf file. Parent commit : specify a 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/9/USDARCH/edge . The "USDARCH" value is determined by the host machine. Click . On the Review page, check the customizations. Click Save blueprint . Click Create . RHEL image builder starts to create a RHEL for Edge Container image for the blueprint that you created. Note The image creation process takes up to 20 minutes to complete. Verification To check the RHEL for Edge Container image creation progress: Click the Images tab. After the image creation process is complete, you can download the resulting "RHEL for Edge Container (.tar)" image. Additional resources Downloading a RHEL for Edge image 4.3.3. Creating a RHEL for Edge Installer image by using image builder in RHEL web console 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 Create Image . 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/9/USDARCH/edge . The "USDARCH" value is determined by the host machine. Click . On the Review page, check the customizations. Click Save blueprint . Click Create . RHEL image builder starts to create a RHEL for Edge Installer image for the blueprint that you created. Note The image creation process takes up to 20 minutes to complete. Verification To check the RHEL for Edge Installer image creation progress: Click the Images 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. Additional resources Downloading a RHEL for Edge image 4.4. Downloading a RHEL for Edge image 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 Download . 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. 4.5. Additional resources Composing a RHEL for Edge image using image builder command-line .

Commands: