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
Copy file name to clipboardExpand all lines: docs/vendor/helm-install-troubleshooting.mdx
+6-4Lines changed: 6 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -30,16 +30,18 @@ Alternatively, if a release contains charts that must use the same name, convert
30
30
31
31
You see an empty or incomplete list of application images in the Helm air gap installation instructions provided in the Replicated Enterprise Portal or Download Portal.
32
32
33
-
Or, when attempting to install, you see an error such as ErrImagePull or ImagePullBackOff because Kubernetes is not able to access one or more images referenced in the Helm deployment.
33
+
Or, when attempting to install, you get an ImagePullBackOff error because Kubernetes is not able to access one or more images referenced in the Helm deployment.
34
34
35
35
### Cause
36
36
37
37
The Enterprise Portal and Download Portal provide instructions for installing with Helm in air-gapped environments. As part of installing with Helm in air-gapped environments, users are instructed to pull all required images for the Helm chart and then push them to their local image registry.
38
38
39
-
To create this list of images provided in the Helm air gap installation instructions, the Vendor Portal uses the values in the HelmChart custom resource `builder` key. If the `builder` key was not configured, then the Vendor Portal uses the default values in the Helm chart. However, if the default values do not expose all the images that customers might need to install the chart, the installation fails when Kubernetes is unable to access one or more images specified in the Helm chart's deployment on the user's local registry.
39
+
To create the list of images for the Helm air gap installation instructions, the Vendor Portal uses the Helm values provided in the HelmChart custom resource `builder` key to template the chart and then parse the output for image references.
40
+
41
+
If the `builder` key was not configured, then the Vendor Portal uses the default values for the chart when running `helm template`. If the Helm values used when templating the chart do not expose all the images that customers might need to install, then the installation fails when Kubernetes is unable to access one or more images in the Helm deployment from the user's local registry.
40
42
41
43
### Solution
42
44
43
-
Configure the `builder` key so that the ouput of `helm template` exposes all the images that might be required to install and run the chart in an air-gapped environment. For more information about how to configure the `builder` key, see [builder](/reference/custom-resource-helmchart-v2#builder) in _HelmChart v2_.
45
+
Configure the `builder` key so that the ouput of `helm template` exposes all the images that might be required for users to install the chart in an air-gapped environment. For more information about how to configure the `builder` key, see [builder](/reference/custom-resource-helmchart-v2#builder) in _HelmChart v2_.
44
46
45
-
For more information, see [Why you should create `HelmChart` resources for your Helm-only releases](https://community.replicated.com/t/why-you-should-create-helmchart-resources-for-your-helm-only-releases/1539) in the Replicated Community site
47
+
For more information about why the `builder` key is required to support air gap installations with Helm, see [Why you should create `HelmChart` resources for your Helm-only releases](https://community.replicated.com/t/why-you-should-create-helmchart-resources-for-your-helm-only-releases/1539) in the Replicated Community site.
0 commit comments