Bug 1992236 - Docs for Installing a Helm chart on an OCP deprecated
Summary: Docs for Installing a Helm chart on an OCP deprecated
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 4.9
Hardware: Unspecified
OS: Unspecified
unspecified
medium
Target Milestone: ---
: 4.10.0
Assignee: Petr Kovar
QA Contact: Xiaoli Tian
Srivaralakshmi Ramani
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2021-08-10 19:09 UTC by Tom Dale
Modified: 2022-04-19 10:35 UTC (History)
5 users (show)

Fixed In Version: 4.10.0
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2022-04-19 10:31:29 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Github openshift openshift-docs pull 43087 0 None Merged Fixing the helm repo source and version of the helm chart 2022-04-19 10:26:11 UTC
Red Hat Issue Tracker RHDEVDOCS-3762 0 None None None 2022-02-14 08:45:37 UTC

Description Tom Dale 2021-08-10 19:09:43 UTC
Document URL: https://docs.openshift.com/container-platform/4.8/cli_reference/helm_cli/getting-started-with-helm-on-openshift-container-platform.html#installing-a-helm-chart-on-an-openshift-cluster_getting-started-with-helm-on-openshift

Section Number and Name: "Installing a Helm chart on an OpenShift Container Platform cluster"

Describe the issue: 
Step 2 results in 
```
$ helm repo add stable https://kubernetes-charts.storage.googleapis.com/
Error: repo "https://kubernetes-charts.storage.googleapis.com/" is no longer available; try "https://charts.helm.sh/stable" instead
```
When I use the suggested source https://charts.helm.sh/stable instead that step works but then for step 4 I get the warning: "this chart is deprecated"
```
$ helm install example-mysql stable/mysql
WARNING: This chart is deprecated
NAME: example-mysql
LAST DEPLOYED: Tue Aug 10 14:54:32 2021
NAMESPACE: helm-test
STATUS: deployed
REVISION: 1
NOTES:
MySQL can be accessed via port 3306 on the following DNS name from within your cluster:
example-mysql.helm-test.svc.cluster.local
```


Suggestions for improvement: 
Correct helm repo source and if stable/mysql is indeed deprecated, use a different example repo.

Comment 1 Silke Niemann 2021-09-08 07:56:27 UTC
dperaza abai Can you please take a look at this issue?   

Also Helm CLI docs have been restructured the relevant doc is located here starting with 4.9, but entry is still the same:    

https://docs.openshift.com/container-platform/4.9/applications/working_with_helm_charts/configuring-custom-helm-chart-repositories.html

Comment 2 Tom Dale 2021-09-08 14:17:42 UTC
Let me know if I should open a separate bug for this, but I think it is the same issue with deprecated helm chart installation. 

In step 4 of https://docs.openshift.com/container-platform/4.9/applications/working_with_helm_charts/configuring-custom-helm-chart-repositories.html#creating-a-custom-helm-chart-on-openshift_configuring-custom-helm-chart-repositories the Chart.yaml example file does not contain the required field "version: x.x.x" . When trying to follow through the docs as stated I get 
```
helm lint
==> Linting .
[ERROR] Chart.yaml: version is required
[ERROR] templates/: validation: chart.metadata.version is required
[ERROR] : unable to load chart
        validation: chart.metadata.version is required
```
After adding "version: 0.0.1" to the Chart.yaml, the helm lint command runs fine.

Comment 4 Tom Dale 2021-11-30 20:16:13 UTC
Changing tag to 4.9 since the deprecated helm source is used in latest 4.9 docs.

Comment 6 Srivaralakshmi Ramani 2022-02-14 08:44:47 UTC
Now tracking this in https://issues.redhat.com/browse/RHDEVDOCS-3762

Comment 7 Srivaralakshmi Ramani 2022-04-19 10:20:46 UTC
The documentation for this issue is updated with the requested inputs. For reference, check this PR: https://github.com/openshift/openshift-docs/pull/43087

Comment 8 Srivaralakshmi Ramani 2022-04-19 10:21:59 UTC
The documentation for this issue is updated with the requested inputs. For reference, check this PR: https://github.com/openshift/openshift-docs/pull/43087

Comment 9 Srivaralakshmi Ramani 2022-04-19 10:31:29 UTC
Closed with https://github.com/openshift/openshift-docs/pull/43087


Note You need to log in before you can comment on or make changes to this bug.