Red Hat Summit第2章 Installing Red Hat Developer Hub in an air-gapped environment with the Operator
You can install Red Hat Developer Hub in a fully disconnected or partially disconnected environment using the Red Hat Developer Hub Operator. For a list of supported platforms, see the Red Hat Developer Hub Life Cycle page.
2.1. Installing Red Hat Developer Hub in a fully disconnected environment with the Operator
In environments without internet access — whether for security, compliance, or operational reasons — a fully disconnected installation ensures that Red Hat Developer Hub can run reliably without external dependencies.
If your network has access to the registry through a bastion host, you can use the helper script to install Red Hat Developer Hub by mirroring the Operator-related images to disk and transferring them to your air-gapped environment without any connection to the internet.
Prerequisites
- You have installed Podman 5.3 or later. For more information, see Podman Installation Instructions.
- You have installed Skopeo 1.17 or later.
-
You have installed
yq4.44 or later. -
You have installed the GNU
sedcommand line text editor. -
You have installed
umociCLI tool. -
You have an active
oc registry,podman, orskopeosession to theregistry.redhat.ioRed Hat Ecosystem Catalog. For more information, see link:Red Hat Container Registry Authentication. -
You have installed the
opmCLI tool. For more information, see Installing the opm CLI. -
Recommended on OpenShift Container Platform: You have installed the
oc-mirrortool, with a version corresponding to the version of your OpenShift Container Platform cluster. - Make sure that your system meets the minimum sizing requirements. See Sizing requirements for Red Hat Developer Hub.
Procedure
Download the mirroring script to disk by running the following command:
curl -sSLO https://raw.githubusercontent.com/redhat-developer/rhdh-operator/refs/heads/release-1.7/.rhdh/scripts/prepare-restricted-environment.shRun the mirroring script by using the
bashcommand with the appropriate set of options:bash prepare-restricted-environment.sh --filter-versions "1.7" --to-dir <my_pulled_image_location> [--use-oc-mirror true]where:
--to-dir <my_pulled_image_location>-
Enter the absolute path to a directory where you want to pull all of the necessary images, for example,
/home/user/rhdh-operator-mirror-dir. --use-oc-mirror true(Recommended on OpenShift Container Platform) Use the
oc-mirrorOpenShift Container Platform CLI plugin to mirror images.注記The script can take several minutes to complete as it copies multiple images to the mirror registry.
-
Transfer the directory specified by the
--to-diroption to your disconnected environment. From a machine in your disconnected environment that has access to both the cluster and the target mirror registry, run the mirroring script by using the
bashcommand with the appropriate set of options:bash <my_pulled_image_location>/install.sh --from-dir <my_pulled_image_location> [--to-registry <my.registry.example.com>] [--use-oc-mirror true]where:
<my_pulled_image_location>/install.sh- Enter the downloaded installation script and the absolute path to the directory where it is stored on your system.
--from-dir <my_pulled_image_location>- Enter the directory where you want to pull all of the necessary images.
--to-registry- (Optional) Enter the URL for the target mirror registry where you want to mirror the images.
--use-oc-mirror trueRecommended on OpenShift Container Platform: Use the
oc-mirrorOpenShift Container Platform CLI plugin to mirror images.重要If you used
oc-mirrorto mirror the images to disk, you must also useoc-mirrorto mirror the images from disk due to the folder layout thatoc-mirroruses.注記The script can take several minutes to complete as it automatically installs the Red Hat Developer Hub Operator.
Verification
- If you are using Red Hat OpenShift Container Platform, the Red Hat Developer Hub Operator is in the Installed Operators list in the web console.
If you are using a supported Kubernetes platform, you can check the list of pods running in the
rhdh-operatornamespace by running the following command in your terminal:kubectl -n rhdh-operator get pods
Next steps
Use the Operator to create a Red Hat Developer Hub instance on a supported platform. For more information, see the following documentation for the platform that you want to use:
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}