SCLORG Helm Charts is a repository hosting Helm Charts available out-of-the-box with OpenShift. It contains popular technologies, tools and services. Helm Charts on this repository can be provided by the community, by partners or Red Hat.
Charts go through an automated Red Hat OpenShift certification workflow, which guarantees security compliance as well as best integration and experience with the platform.
.
└── charts
└── <centos|redhat>
└── <chart-name>
└── src
├── Chart.yaml
├── README.md
├── templates
│ ├── deployment.yaml
│ ├── _helpers.tpl
│ ├── hpa.yaml
│ ├── ingress.yaml
│ ├── NOTES.txt
│ ├── serviceaccount.yaml
│ ├── service.yaml
│ └── tests
│ └── test-connection.yaml
├── values.schema.json
└── values.yaml
The chart can also be packaged using the following command:
$ helm package ./charts/<centos|redhat>/<chart-name>
Package can then be placed directly under ./charts/<centos|redhat>/<chart-name> for example: ./charts/redhat/postgresql-persistent/.
Once this repository is available and configured, Helm Charts will be available in the OpenShift Developer Perspective
You can also use Helm CLI commands, please refere to Using Helm Guide for detailed instructions on how to use the Helm client.
In case of Helm chart is related to CentOS, CentOS Stream 8, or CentOS Stream 9 then use centos directory.
In case of Helm chart is related to RHEL system then use redhat directory.
As soon as your Helm chart follows directory structure as mentioned above, let’s test it.
Each helm chart name has to contain file OWNERS. E.g. OWNERS
Each helm chart change, in templates,
Chart.yaml,
values.yaml,
values.schema.json,
or OWNERS file
has to bump version.
Bump the version appVersion and version in Chart.yaml file.
description: |-
PostgreSQL database service, with persistent storage. For more information about using this template, including OpenShift considerations, see https://github.com/sclorg/postgresql-container/.
NOTE: Scaling to more than one replica is not supported. You must have persistent volumes available in your cluster to use this template.
annotations:
charts.openshift.io/name: Red Hat PostgreSQL database service, with persistent storage
apiVersion: v2
appVersion: 0.0.2
name: postgresql-persistent
tags: database,postgresql
sources:
- https://github.com/sclorg/helm-charts
version: 0.0.2
As a prerequisite to testing Helm charts, you need to be connected to the OpenShift 4 cluster using the oc binary generated from the cluster itself. To get access to OpenShift 4 cluster please ask phracek@redhat.com.
Before any testing proposes and deploying Helm chart to OpenShift cluster, you have to create a package using command:
$ helm package <path_to_helm_chart>
E.g. Using postgresql-persistent Helm chart:
$ helm package charts/redhat/postgresql-persistent/src
Successfully packaged chart and saved it to: <FULL_PATH_TO_CWD>/helm-charts/postgresql-persistent-0.0.1.tgz
You can deploy the Helm chart to the OpenShift cluster using command:
$ helm install <helm_chart_name> <tarball_path>
E.g Using postgresql-persistent Helm chart:
$ helm install postgresql-imagestreams postgresql-imagestreams-0.0.1.tgz
NAME: postgresql-imagestreams
LAST DEPLOYED: Tue Apr 4 10:29:33 2023
NAMESPACE: pgsql-13
STATUS: deployed
REVISION: 1
TEST SUITE: None
To check if Helm chart is really deployed, run command:
helm list
Examples of the helm list output:
$ helm list
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
postgresql-imagestreams pgsql-13 1 2023-04-04 10:29:33.878674 +0200 CEST deployed postgresql-imagestreams-0.0.1 0.0.1
postgresql-persistent pgsql-13 1 2023-03-28 16:59:56.498783 +0200 CEST deployed postgresql-persistent-0.0.1
As soon as a Helm chart is deployed on OpenShift 4 cluster, let’s test it. Use the following command to test
$ helm test <helm_chart_name> --logs
The output should be like:
$ helm test postgresql-persistent --logs
NAME: postgresql-persistent
LAST DEPLOYED: Tue Mar 28 16:59:56 2023
NAMESPACE: pgsql-13
STATUS: deployed
REVISION: 1
TEST SUITE: postgresql-persistent-connection-test
Last Started: Tue Apr 4 10:31:44 2023
Last Completed: Tue Apr 4 10:31:52 2023
Phase: Succeeded
POD LOGS: postgresql-persistent-connection-test
postgresql-testing:5432 - accepting connections
The end of the output shows, that PostgreSQL server accepts connections.
As soon as a Helm chart is ready and tested let’s verify it.
In case the Helm chart has already been merged, use the following command to verify if all the required information is contained within the Helm chart.
docker run --rm -i -e KUBECONFIG=/.kube/config -v "${HOME}/.kube":/.kube \
"quay.io/redhat-certification/chart-verifier:latest" \
verify \
https://sclorg.github.io/helm-charts/<helm-chart-name>.tgz
Use the following command to verify if all the required information for local testing is contained within the Helm chart.
docker run --rm -i -e KUBECONFIG=/.kube/config -v "${HOME}/.kube":/.kube \
-v "<full_path_to_this_dir>":/helm-charts
"quay.io/redhat-certification/chart-verifier:latest" \
verify \
/helm-charts/<helm-chart-name>.tgz
The output from commands mentioned above could look like:
results:
- check: v1.0/required-annotations-present
type: Mandatory
outcome: PASS
reason: All required annotations present
- check: v1.0/signature-is-valid
type: Mandatory
outcome: SKIPPED
reason: 'Chart is not signed : Signature verification not required'
- check: v1.0/chart-testing
type: Mandatory
outcome: FAIL
reason: |-
Chart Install failure: values don't meet the specifications of the schema(s) in the following chart(s):
postgresql-persistent:
enum items must be unique
[snipped]
- check: v1.0/helm-lint
type: Mandatory
outcome: FAIL
reason: |
Helm lint has failed: [INFO] Chart.yaml: icon is recommended
[ERROR] values.yaml: enum items must be unique
[ERROR] templates/: values don't meet the specifications of the schema(s) in the following chart(s):
postgresql-persistent:
enum items must be unique
[snipped]
- check: v1.1/has-kubeversion
type: Mandatory
outcome: FAIL
reason: Kubernetes version is not specified
- check: v1.1/images-are-certified
type: Mandatory
outcome: FAIL
reason: |-
Failed to certify images : Failed to get images, error running helm template : values don't meet the specifications of the schema(s) in the following chart(s):
postgresql-persistent:
enum items must be unique
[snipped]
- check: v1.0/contains-values
type: Mandatory
outcome: PASS
reason: Values file exist
- check: v1.0/not-contains-crds
type: Mandatory
outcome: PASS
reason: Chart does not contain CRDs
Address all issues detected by chart-verifier.
Before any questions, see https://github.com/openshift-helm-charts/charts/blob/main/docs/README.md.