Merge branch 'main' into RHIDP-2384

modules/installation/proc-install-rhdh-airgapped-environment-ocp-helm.adoc

@@ -1,3 +1,8 @@
+// Module included in the following assemblies:
+//
+// * assemblies/assembly-install-rhdh-ocp.adoc
+
+:_mod-docs-content-type: PROCEDURE
 [id="proc-install-rhdh-airgapped-environment-ocp-helm_{context}"]
 = Installing {product} using the Helm Chart in an air-gapped environment
 
@@ -18,93 +23,90 @@ To install {product-short} in an air-gapped environment, you must have access to
 
 .Procedure
 
-. Log in to your {ocp-short} account using the `oc` command line tool:
+. Log in to your {ocp-short} account using the `oc` command line tool, by running the following command:
 +
---
-[source]
+[source,terminal]
 ----
 oc login -u <user> -p <password> https://api.<HOSTNAME>:6443
 ----
---
 
-. Log in to the {ocp-short} image registry using the `podman` command line tool:
+. Log in to the {ocp-short} image registry using the `podman` command line tool, by running the following command:
 +
---
-[source]
+[source,terminal]
 ----
 podman login -u kubeadmin -p $(oc whoami -t) default-route-openshift-image-registry.<HOSTNAME>
 ----
-
++
 [NOTE]
 ====
-You can use the following commands to get the full host name of the {ocp-short} image registry and than use the host name in a command to log in:
+You can run the following commands to get the full host name of the {ocp-short} image registry, and then use the host name in a command to log in:
 
-[source]
+[source,terminal]
 ----
 REGISTRY_HOST=$(oc get route default-route -n openshift-image-registry --template='{{ .spec.host }}')
+----
 
+[source,terminal]
+----
 podman login -u kubeadmin -p $(oc whoami -t) $REGISTRY_HOST
 ----
 ====
---
 
-. Log in to the `registry.redhat.io` in `podman` using the following command:
+. Log in to the `registry.redhat.io` in `podman` by running the following command:
 +
---
-[source]
+[source,terminal]
 ----
 podman login registry.redhat.io
 ----
-
++
 For more information about registry authentication, see https://access.redhat.com/RegistryAuthentication[{company-name} Container Registry Authentication].
---
 
-. Pull {product-short} and PostgreSQL images from https://catalog.redhat.com/software/containers/search[{company-name} Image registry] to your workstation:
+. Pull {product-short} and PostgreSQL images from https://catalog.redhat.com/software/containers/search[{company-name} Image registry] to your workstation, by running the following commands:
 +
---
-[source]
+[source,terminal]
+----
+podman pull registry.redhat.io/rhdh/rhdh-hub-rhel9:{product-chart-version}
+----
++
+[source,terminal]
 ----
-podman pull <DEVELOPERHUBIMAGE>
 podman pull registry.redhat.io/rhel9/postgresql-15:latest
 ----
---
 
-. Push both images to the internal {ocp-short} image registry.
+. Push both images to the internal {ocp-short} image registry by running the following command:
 +
---
-For more information about pushing images directly to the {ocp-short} image registry, see https://access.redhat.com/solutions/6959306[How do I push an Image directly into the OpenShift 4 registry].
-
-[source]
+[source,terminal]
 ----
-podman push --remove-signatures registry.redhat.io/rhel9/postgresql-15:latest default-route-openshift-image-registry.<hostname>/<yourProject>/postgresql-15:latest
+podman push --remove-signatures registry.redhat.io/rhel9/postgresql-15:latest default-route-openshift-image-registry.<hostname>/<project_name>/postgresql-15:latest
 ----
-
++
+For more information about pushing images directly to the {ocp-short} image registry, see https://access.redhat.com/solutions/6959306[How do I push an Image directly into the OpenShift 4 registry].
++
 [TIP]
 ====
 If an x509 error occurs, ensure you install the CA certificate used for {ocp-short} routes on your system.
 
 Optionally, you can append `--tls-verify=false` to the `podman` push command, note that this approach is not recommended.
 ====
---
 
 . Use the following command to verify that both images are present in the internal {ocp-short} registry:
 +
---
-[source]
+[source,terminal]
 ----
-oc get imagestream -n <projectName>
+oc get imagestream -n <project_name>
 ----
---
 
-. Enable local image lookup for both images using the following commands:
+. Enable local image lookup for both images by running the following commands:
 +
---
-[source]
+[source,terminal]
 ----
 oc set image-lookup postgresql-15
+----
++
+[source,terminal]
+----
 oc set image-lookup  rhdh-hub-rhel9
 ----
---
 
 . Go to *YAML view* and update the `image` section for `backstage` and `postgresql` using the following values:
 +