{"id":21273267,"url":"https://github.com/sclorg/helm-charts","last_synced_at":"2025-07-11T06:33:03.265Z","repository":{"id":154630477,"uuid":"617827478","full_name":"sclorg/helm-charts","owner":"sclorg","description":null,"archived":false,"fork":false,"pushed_at":"2024-11-13T19:40:05.000Z","size":936,"stargazers_count":1,"open_issues_count":4,"forks_count":6,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-11-13T20:30:29.855Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sclorg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-23T07:37:28.000Z","updated_at":"2024-11-13T19:40:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"e1cc0202-c409-400b-bac3-0f102e37d1a3","html_url":"https://github.com/sclorg/helm-charts","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sclorg%2Fhelm-charts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sclorg%2Fhelm-charts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sclorg%2Fhelm-charts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sclorg%2Fhelm-charts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sclorg","download_url":"https://codeload.github.com/sclorg/helm-charts/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225700924,"owners_count":17510448,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-21T09:13:15.621Z","updated_at":"2024-11-21T09:13:16.419Z","avatar_url":"https://github.com/sclorg.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SCLORG helm-charts\n\nSCLORG Helm Charts is a repository hosting [Helm Charts](https://github.com/helm/helm) available out-of-the-box with [OpenShift](https://www.openshift.com/). It contains popular technologies, tools and services. Helm Charts on this repository can be provided by the community, by partners or Red Hat. \n\nCharts go through an automated Red Hat OpenShift certification workflow, which guarantees security compliance as well as best integration and experience with the platform.\n\n## Structure of the repository\n\n```\n.\n└── charts\n    └── \u003ccentos|redhat\u003e\n        └── \u003cchart-name\u003e\n            └── src\n                ├── Chart.yaml\n                ├── README.md\n                ├── templates\n                │   ├── deployment.yaml\n                │   ├── _helpers.tpl\n                │   ├── hpa.yaml\n                │   ├── ingress.yaml\n                │   ├── NOTES.txt\n                │   ├── serviceaccount.yaml\n                │   ├── service.yaml\n                │   └── tests\n                │       └── test-connection.yaml\n                ├── values.schema.json\n                └── values.yaml\n```\n\nThe chart can also be packaged using the following command:\n\n```bash\n$ helm package ./charts/\u003ccentos|redhat\u003e/\u003cchart-name\u003e\n```\n\nPackage can then be placed directly under `./charts/\u003ccentos|redhat\u003e/\u003cchart-name\u003e` for example: `./charts/redhat/postgresql-persistent/`.\n\n## Using Helm\n\nOnce this repository is available and configured, Helm Charts will be available in the [OpenShift Developer Perspective](https://docs.openshift.com/container-platform/latest/applications/application_life_cycle_management/odc-working-with-helm-charts-using-developer-perspective.html)\n\nYou can also use Helm CLI commands, please refere to [Using Helm Guide](https://helm.sh/docs/intro/using_helm/) for detailed instructions on how to use the Helm client.\n\n## How to contribute to this repository\n\nIn case of Helm chart is related to CentOS, CentOS Stream 8, or CentOS Stream 9 then use [centos](charts/centos) directory.\n\nIn case of Helm chart is related to RHEL system then use [redhat](charts/redhat) directory.\n\nAs soon as your Helm chart follows directory structure as mentioned above, let's test it.\n\n### General notes for Helm charts\nEach helm chart name has to contain file OWNERS. E.g. [OWNERS](./charts/redhat/postgresql-imagestreams/OWNERS)\n\nEach helm chart change, in [templates](./charts/redhat/postgresql-persistent/src/templates),\n[Chart.yaml](./charts/redhat/postgresql-persistent/src/Chart.yaml),\n[values.yaml](./charts/redhat/postgresql-persistent/src/values.yaml),\n[values.schema.json](./charts/redhat/postgresql-persistent/src/values.schema.json),\nor [OWNERS](./charts/redhat/postgresql-persistent/OWNERS) file\nhas to bump version.\nBump the version `appVersion` and `version` in `Chart.yaml` file.\n\n```commandline\ndescription: |-\n  PostgreSQL database service, with persistent storage. For more information about using this template, including OpenShift considerations, see https://github.com/sclorg/postgresql-container/.\n\n  NOTE: Scaling to more than one replica is not supported. You must have persistent volumes available in your cluster to use this template.\nannotations:\n  charts.openshift.io/name: Red Hat PostgreSQL database service, with persistent storage\napiVersion: v2\nappVersion: 0.0.2\nname: postgresql-persistent\ntags: database,postgresql\nsources:\n  - https://github.com/sclorg/helm-charts\nversion: 0.0.2\n\n```\n\n### How to test Helm chart\n\nAs 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.\nTo get access to OpenShift 4 cluster please ask phracek@redhat.com.\n\n#### Create a Helm chart package\n\nBefore any testing proposes and deploying Helm chart to OpenShift cluster, you have to create a package using command:\n\n```commandline\n$ helm package \u003cpath_to_helm_chart\u003e\n```\n\nE.g. Using postgresql-persistent Helm chart:\n\n```commandline\n$ helm package charts/redhat/postgresql-persistent/src\nSuccessfully packaged chart and saved it to: \u003cFULL_PATH_TO_CWD\u003e/helm-charts/postgresql-persistent-0.0.1.tgz\n```\n\n#### Deploy Helm chart to OpenShift\n\nYou can deploy the Helm chart to the OpenShift cluster using command:\n\n```commandline\n$ helm install \u003chelm_chart_name\u003e \u003ctarball_path\u003e\n```\n\nE.g Using postgresql-persistent Helm chart:\n\n```commandline\n$ helm install postgresql-imagestreams postgresql-imagestreams-0.0.1.tgz\nNAME: postgresql-imagestreams\nLAST DEPLOYED: Tue Apr  4 10:29:33 2023\nNAMESPACE: pgsql-13\nSTATUS: deployed\nREVISION: 1\nTEST SUITE: None\n```\n\nTo check if Helm chart is really deployed, run command:\n\n```bash\nhelm list\n```\n\nExamples of the `helm list` output:\n\n```commandline\n$ helm list\nNAME                      \tNAMESPACE\tREVISION\tUPDATED                              \tSTATUS  \tCHART                        \tAPP VERSION\npostgresql-imagestreams  \tpgsql-13 \t1       \t2023-04-04 10:29:33.878674 +0200 CEST\tdeployed\tpostgresql-imagestreams-0.0.1\t0.0.1\npostgresql-persistent     \tpgsql-13 \t1       \t2023-03-28 16:59:56.498783 +0200 CEST\tdeployed\tpostgresql-persistent-0.0.1\n```\n\n#### How to test Helm chart\n\nAs soon as a Helm chart is deployed on OpenShift 4 cluster, let's test it.\nUse the following command to test\n\n```commandline\n$ helm test \u003chelm_chart_name\u003e --logs\n```\n\nThe output should be like:\n\n```commandline\n$ helm test postgresql-persistent --logs\nNAME: postgresql-persistent\nLAST DEPLOYED: Tue Mar 28 16:59:56 2023\nNAMESPACE: pgsql-13\nSTATUS: deployed\nREVISION: 1\nTEST SUITE:     postgresql-persistent-connection-test\nLast Started:   Tue Apr  4 10:31:44 2023\nLast Completed: Tue Apr  4 10:31:52 2023\nPhase:          Succeeded\n\nPOD LOGS: postgresql-persistent-connection-test\npostgresql-testing:5432 - accepting connections\n```\n\nThe end of the output shows, that PostgreSQL server accepts connections.\n\n### How to verify Helm chart\n\nAs soon as a Helm chart is ready and tested let's verify it.\n\nIn case the Helm chart has already been merged,\nuse the following command to verify if all the required information is contained within the Helm chart.\n\n```commandline\ndocker run --rm -i -e KUBECONFIG=/.kube/config -v \"${HOME}/.kube\":/.kube \\\n          \"quay.io/redhat-certification/chart-verifier:latest\" \\\n          verify \\\n          https://sclorg.github.io/helm-charts/\u003chelm-chart-name\u003e.tgz\n```\n\nUse the following command to verify if all the required information for local testing is contained within the Helm chart.\n\n```commandline\ndocker run --rm -i -e KUBECONFIG=/.kube/config -v \"${HOME}/.kube\":/.kube \\\n          -v \"\u003cfull_path_to_this_dir\u003e\":/helm-charts\n          \"quay.io/redhat-certification/chart-verifier:latest\" \\\n          verify \\\n          /helm-charts/\u003chelm-chart-name\u003e.tgz\n```\n\nThe output from commands mentioned above could look like:\n\n```commandline\nresults:\n    - check: v1.0/required-annotations-present\n      type: Mandatory\n      outcome: PASS\n      reason: All required annotations present\n    - check: v1.0/signature-is-valid\n      type: Mandatory\n      outcome: SKIPPED\n      reason: 'Chart is not signed : Signature verification not required'\n    - check: v1.0/chart-testing\n      type: Mandatory\n      outcome: FAIL\n      reason: |-\n        Chart Install failure: values don't meet the specifications of the schema(s) in the following chart(s):\n        postgresql-persistent:\n        enum items must be unique\n[snipped]\n    - check: v1.0/helm-lint\n      type: Mandatory\n      outcome: FAIL\n      reason: |\n        Helm lint has failed:  [INFO] Chart.yaml: icon is recommended\n        [ERROR] values.yaml: enum items must be unique\n        [ERROR] templates/: values don't meet the specifications of the schema(s) in the following chart(s):\n        postgresql-persistent:\n        enum items must be unique\n[snipped]\n    - check: v1.1/has-kubeversion\n      type: Mandatory\n      outcome: FAIL\n      reason: Kubernetes version is not specified\n    - check: v1.1/images-are-certified\n      type: Mandatory\n      outcome: FAIL\n      reason: |-\n        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):\n        postgresql-persistent:\n        enum items must be unique\n[snipped]\n    - check: v1.0/contains-values\n      type: Mandatory\n      outcome: PASS\n      reason: Values file exist\n    - check: v1.0/not-contains-crds\n      type: Mandatory\n      outcome: PASS\n      reason: Chart does not contain CRDs\n```\n\nAddress all issues detected by chart-verifier.\n\n## Troubleshooting\n\nBefore any questions, see [https://github.com/openshift-helm-charts/charts/blob/main/docs/README.md](https://github.com/openshift-helm-charts/charts/blob/main/docs/README.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsclorg%2Fhelm-charts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsclorg%2Fhelm-charts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsclorg%2Fhelm-charts/lists"}