Bug 1992236

Summary: Docs for Installing a Helm chart on an OCP deprecated
Product: OpenShift Container Platform Reporter: Tom Dale <tdale>
Component: DocumentationAssignee: Petr Kovar <pkovar>
Status: CLOSED CURRENTRELEASE QA Contact: Xiaoli Tian <xtian>
Severity: medium Docs Contact: Srivaralakshmi Ramani <srr>
Priority: unspecified    
Version: 4.9CC: aos-bugs, lmurthy, sniemann, srr, tdale
Target Milestone: ---   
Target Release: 4.10.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: 4.10.0 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2022-04-19 10:31:29 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

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