You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -8,90 +8,108 @@ You can install {product} in a fully disconnected or partially disconnected envi
8
8
9
9
== Installing {product} in a partially disconnected environment with the Helm chart
10
10
11
-
If your network has access to the internal {company-name} registries, you can deploy your {product} instance in your partially disconnected environment by mirroring the specified resources directly to the target registry.
11
+
If your network has access to the `registry.redhat.io` registry and the `charts.openshift.io` Helm Chart repository, you can deploy your {product} instance in your partially disconnected environment by mirroring the specified resources directly to the target registry.
12
12
13
13
.Prerequisites
14
14
15
-
* You have installed an {ocp-brand-name} {ocp-version-min} or later.
15
+
* You have installed {ocp-brand-name} {ocp-version-min} or later.
16
16
* You have access to the `registry.redhat.io`.
17
-
* You have access to the {ocp-brand-name} image registry of your cluster. For more information about exposing the image registry, see the {ocp-brand-name} documentation about https://docs.redhat.com/en/documentation/openshift_container_platform/{ocp-version}/html-single/registry/index#securing-exposing-registry[Exposing the registry].
17
+
* You have access to the `charts.openshift.io` Helm chart repository.
18
+
* You have access to a mirror registry that can be reached from the disconnected cluster, for example, the {ocp-brand-name} image registry. For more information about exposing the {ocp-brand-name} image registry, see https://docs.redhat.com/en/documentation/openshift_container_platform/{ocp-version}/html-single/registry/index#securing-exposing-registry[Exposing the registry].
19
+
* You are logged in to your target mirror registry and have permissions to push images to it. For more information, see link:https://docs.openshift.com/container-platform/4.17/disconnected/mirroring/installing-mirroring-disconnected.html#installation-adding-registry-pull-secret_installing-mirroring-disconnected[Configuring credentials that allow images to be mirrored].
18
20
* You have installed the {openshift-cli} on your workstation.
19
-
* You have installed the `podman` command line tools on your workstation.
20
21
* You have installed the oc-mirror {openshift-cli} plugin, for more information see https://docs.openshift.com/container-platform/4.17/disconnected/mirroring/installing-mirroring-disconnected.html#installation-oc-mirror-installing-plugin_installing-mirroring-disconnected[Installing the oc-mirror OpenShift CLI plugin].
21
22
* You have an account in https://developers.redhat.com/[{rhdeveloper-name}] portal.
22
23
23
24
.Procedure
24
25
. Log in to your {ocp-short} account using the {openshift-cli} by running the following command:
`<mirror-configuration-file>` :: Specifies the name of your mirror configuration yaml file, for example, `mirror-config.yaml`
52
65
53
-
. Log in to the `registry.redhat.io` in `podman` by running the following command:
54
-
+
55
-
[source,terminal]
56
-
----
57
-
podman login registry.redhat.io
58
-
----
66
+
`<target-mirror-registry>` :: Specifies the location and name of your target mirror registry, for example,`docker://registry.example:5000`.
67
+
--
59
68
+
60
-
. Create an `ImageSetConfiguration` file to specify the resources that you want to mirror. For example:
69
+
[NOTE]
70
+
====
71
+
Running the `oc-mirror` command creates a `ImageContentSourcePolicy` (ICSP) manifest that you can apply against the cluster in a later step.
72
+
====
61
73
+
62
-
[source,terminal]
74
+
.Example output
75
+
[source,terminal,subs="attributes+"]
63
76
----
64
-
apiVersion: mirror.openshift.io/v1alpha2
65
-
kind: ImageSetConfiguration
66
-
storageConfig:
67
-
local:
68
-
path: ./mirror-output
69
-
mirror:
70
-
helm:
71
-
repositories:
72
-
- name: openshift-charts
73
-
url: https://charts.openshift.io
74
-
charts:
75
-
- name: redhat-developer-hub
76
-
version: "{product-version}"
77
+
Writing image mapping to oc-mirror-workspace/results-1738070846/mapping.txt
78
+
Writing ICSP manifests to oc-mirror-workspace/results-1738070846
77
79
----
78
-
. Mirror the resources specified in the`ImageSetConfiguration` file directly to the target registry by running the following command:
79
80
+
80
-
[source,terminal]
81
+
. In the `oc-mirror` command output, find the directory containing the Helm chart that you want to use, for example, `mapping.txt`.
82
+
. Locate the `ImageContentSourcePolicy` (ICSP) manifest that was automatically generated by running the `oc-mirror` command and apply it against the cluster by running the `oc create` command. For example:
. Ensure that the route matches the expected URL based on the router base of the cluster. If necessary, update the route to align with your expected configuration.
95
113
96
114
== Installing {product} in a fully disconnected environment with the Helm chart
97
115
@@ -101,104 +119,88 @@ You can use the Helm chart to install {product} by mirroring specified resources
101
119
102
120
* You have installed {ocp-brand-name} {ocp-version-min} or later.
103
121
* You have access to the `registry.redhat.io`.
104
-
* You have access to the {ocp-brand-name} image registry for your cluster. For more information about exposing the image registry, see the {ocp-brand-name} documentation about https://docs.openshift.com/container-platform/{ocp-version}/registry/securing-exposing-registry.html[Exposing the registry].
122
+
* You have access to a mirror registry that can be reached from the disconnected cluster, for example, the {ocp-brand-name} image registry. For more information about exposing the {ocp-brand-name} image registry, see https://docs.redhat.com/en/documentation/openshift_container_platform/{ocp-version}/html-single/registry/index#securing-exposing-registry[Exposing the registry].
105
123
* You have installed the {openshift-cli} on your workstation.
106
-
* You have installed the `podman` command line tools on your workstation.
124
+
* You are logged in to your target mirror registry and have permissions to push images to it. For more information, see link:https://docs.openshift.com/container-platform/4.17/disconnected/mirroring/installing-mirroring-disconnected.html#installation-adding-registry-pull-secret_installing-mirroring-disconnected[Configuring credentials that allow images to be mirrored].
107
125
* You have installed the oc-mirror {openshift-cli} plugin, for more information see https://docs.openshift.com/container-platform/4.17/disconnected/mirroring/installing-mirroring-disconnected.html#installation-oc-mirror-installing-plugin_installing-mirroring-disconnected[Installing the oc-mirror OpenShift CLI plugin].
108
126
* You have an account in https://developers.redhat.com/[{rhdeveloper-name}] portal.
109
127
110
128
.Procedure
111
-
112
-
. Log in to your {ocp-short} account using the {openshift-cli} by running the following command:
. Transfer the generated `.tar` archive file (for example, `mirror++_++seq1++_++000000.tar`) to the air-gapped environment using `scp` or another file transfer tool. For example:
173
168
+
174
-
[source,terminal]
169
+
. Transfer the generated `.tar` archive file (for example, `mirror_seq1_000000.tar`) to the air-gapped environment.
170
+
. Connect to following your air-gapped environment and make sure that you are also connected to the following objects:
171
+
+
172
+
* The target registry
173
+
* The target {ocp-brand-name} cluster
174
+
+
175
+
. From the air-gapped environment, mirror the resources from the archive to the target registry by running the `oc-mirror` command. For example:
. Extract the contents of the archive into a directory (for example, `/tmp`) by running the `tar` command. For example:
179
181
+
180
-
[source,terminal]
182
+
.Example output
183
+
[source,terminal,subs="attributes+"]
181
184
----
182
-
tar -xvf /mirror-archive/mirror_seq1_000000.tar -C /tmp
185
+
Wrote release signatures to oc-mirror-workspace/results-1738075410
186
+
Writing image mapping to oc-mirror-workspace/results-1738075410/mapping.txt
187
+
Writing ICSP manifests to oc-mirror-workspace/results-1738075410
183
188
----
184
-
. In your air-gapped environment, deploy the Helm chart to the `rhdh` namespace by running the `helm install` command. For example:
189
+
. In the `oc-mirror` command output, find the directory containing the Helm chart that you want to use, for example, `mapping.txt`.
190
+
. Locate the `ImageContentSourcePolicy` (ICSP) manifest that was automatically generated by running the `oc-mirror` command and apply it against the cluster by running the `oc apply` command. For example:
. Ensure that the route matches the expected URL based on the router base of the cluster. If necessary, update the route to align with your expected configuration.
0 commit comments