1.2. Enabling extended support repositories for image building
If you have an extended support (EUS) release of MicroShift or Red Hat Enterprise Linux (RHEL), you must enable the RHEL EUS repositories for image builder to use. If you do not have an EUS version, you can skip these steps.
Prerequisites
- You have an EUS version of MicroShift or RHEL or are updating to one.
- You have root-user access to your build host.
- You reviewed the Red Hat Device Edge release compatibility matrix.
Keeping component versions in a supported configuration of Red Hat Device Edge can require updating MicroShift and RHEL at the same time. Ensure that your version of RHEL is compatible with the version of MicroShift you are updating to, especially if you are updating MicroShift across two minor versions. Otherwise, you can create an unsupported configuration, break your cluster, or both. For more information, see the Red Hat Device Edge release compatibility matrix.
Procedure
Create the
/etc/osbuild-composer/repositoriesdirectory by running the following command:$ sudo mkdir -p /etc/osbuild-composer/repositoriesCopy the
/usr/share/osbuild-composer/repositories/rhel-9.4.jsonfile into the/etc/osbuild-composer/repositoriesdirectory by running the following command:$ sudo cp /usr/share/osbuild-composer/repositories/rhel-9.4.json /etc/osbuild-composer/repositories/rhel-9.4.jsonUpdate the
baseossource by modifying the/etc/osbuild-composer/repositories/rhel-9.4.jsonfile with the following values:# ... "baseurl": "https://cdn.redhat.com/content/eus/rhel<9>/<9.4>//baseos/os",1 # ...- 1
- Replace <9> with the major RHEL version you are using, and replace <9.4> with the <major.minor> version. Be certain that the RHEL version you choose is compatible with the MicroShift version you are using.
Optional. Apply the
baseosupdate by running the following command:$ sudo sed -i "s,dist/rhel<9>/<9.4>/$(uname -m)/baseos/,eus/rhel<9>/<9.4>/$(uname -m)/baseos/,g" \ /etc/osbuild-composer/repositories/rhel-<9.4>.json1 - 1
- Replace <9> with the major RHEL version you are using, and replace <9.4> with the <major.minor> version. Be certain that the RHEL version you choose is compatible with the MicroShift version you are using.
Update the
appstreamsource by modifying the/etc/osbuild-composer/repositories/rhel-<major.minor>.jsonfile with the following values:# ... "baseurl": "https://cdn.redhat.com/content/eus/rhel<9>/<9.4>//appstream/os",1 # ...- 1
- Replace <9> with the major RHEL version you are using, and replace <9.4> with the <major.minor> version. Be certain that the RHEL version you choose is compatible with the MicroShift version you are using.
Optional. Apply the
appstreamupdate by running the following command:$ sudo sed -i "s,dist/rhel<9>/<9.4>/$(uname -m)/appstream/,eus/rhel<9>/<9.4>/$(uname -m)/appstream/,g" \ /etc/osbuild-composer/repositories/rhel-<9.4>.json1 - 1
- Replace <9> with the major RHEL version you are using, and replace <9.4> with the <major.minor> version. Be certain that the RHEL version you choose is compatible with the MicroShift version you are using.
Verification
You can verify the repositories by using the composer-cli tool to display information about the source.
Verify the
baseossource by running the following command:$ sudo composer-cli sources info baseos | grep 'url ='Example output
url = "https://cdn.redhat.com/content/eus/rhel9/9.4/x86_64/baseos/os"Verify the
appstreamsource by running the following command:$ sudo composer-cli sources info appstream | grep 'url ='Example output
url = "https://cdn.redhat.com/content/eus/rhel9/9.4/x86_64/appstream/os"