STARTX helm repository
helm charts for various infrastructure configuration and services running under an Openshift Container Platform (or OKD). For more informations and access to the helm index, you can visit the startx helm-repository homepage.
Helm repository content
This repository host various helm chart targeting the Openshift Container Platform environment. Charts could be divided into 3 main category (basic charts, cluster charts, , chaos charts and examples charts)
Cluster Helm charts
Helm chart prefixed with cluster- are Cluster chart. Cluster charts configure cluster configuration or enable cluster service.
| Chart | Source | Description |
|---|---|---|
| cluster-config | source | global configuration of an openshift cluster |
| cluster-rbac | source | configure various RBAC aspects |
| cluster-auth | source | configure Auth at the cluster level |
| cluster-console | source | configure the openshift console at the cluster level |
| cluster-storage | source | enable StoragesClass at the cluster level |
| cluster-localstorage | source | enable local storage at the cluster level |
| cluster-logging | source | deploy a EFK (puit de log) at the cluster level |
| cluster-pipeline | source | enable tekton pipeline at the cluster level |
| cluster-metering | source | enable Metering at the cluster level |
| cluster-istio | source | enable ServiceMesh at the cluster level |
| cluster-knative | source | enable Serverless (knative) at the cluster level |
| cluster-ocs | source | enable Openshift Container Storage at the cluster level |
| cluster-kubevirt | source | enable kubevirt at the cluster level |
| cluster-vault | source | enable hashicorp vault service at the cluster level |
| cluster-vault-config | source | enable hashicorp vault configuration service at the cluster level |
| cluster-quay | source | enable Quay.io private repository at the cluster level |
| cluster-ansible | source | enable Ansible automation at the cluster level |
| cluster-3scale | source | deploy a 3Scale infrastructure at the cluster level |
| cluster-workspace | source | enable codeready workspace at the cluster level |
| cluster-vpa | source | enable VerticalPodAutoscaler at the cluster level |
| cluster-sso | source | enable Redhat-SSO at the cluster level |
| cluster-ptp | source | enable Precision Time Protocol at the cluster level |
| cluster-nexus | source | enable Nexus at the cluster level |
| cluster-keycloak | source | enable Keycloak at the cluster level |
| cluster-jenkins | source | enable Jenkins at the cluster level |
| cluster-gitlab | source | enable Gitlab at the cluster level |
| cluster-compliance | source | enable Compliance at the cluster level |
| cluster-machine | source | enable Machine management at the cluster level |
Use Cluster charts
helm repo add startx https://startxfr.github.io/helm-repository/packages/
helm install startx/cluster-config
helm install startx/cluster-rbac
helm install startx/cluster-auth
helm install startx/cluster-console
helm install startx/cluster-storage
helm install startx/cluster-logging
helm install startx/cluster-pipeline
helm install startx/cluster-metering
helm install startx/cluster-istio
helm install startx/cluster-knative
helm install startx/cluster-ocs
helm install startx/cluster-kubevirt
helm install startx/cluster-vault
helm install startx/cluster-quay
helm install startx/cluster-3scale
helm install startx/cluster-workspace
helm install startx/cluster-vpa
helm install startx/cluster-sso
helm install startx/cluster-ptp
helm install startx/cluster-nexus
helm install startx/cluster-keycloak
helm install startx/cluster-jenkins
helm install startx/cluster-gitlab
helm install startx/cluster-compliance
helm install startx/cluster-machine
Basic Helm charts
Helm chart without prefix are basic chart. Basic charts configure basic element and are mainly used as a dependency of more complex chart.
| Chart | Source | Description |
|---|---|---|
| project | source | create a project with limits, quotas, networkpolicy and rbac set |
| operator | source | create an operator with subscription (openshift) or CRD (k8s) |
| sxapi | source | deploy a small micro-service endpoint |
Use Basic charts
helm repo add startx https://startxfr.github.io/helm-repository/packages/
helm install startx/project
helm install startx/operator
helm install startx/sxapi
Chaos Helm charts
Helm chart prefixed with chaos- are part of the chaos suite.
You can deploy various tools used for chaos-testing openshift and kubernetes clusters.
| Chart | Source | Description |
|---|---|---|
| chaos | source | Deploy a full chaos test suite |
| chaos-cerberus | source | Deploy Cerberus component as part of a chaos environment |
| chaos-kraken | source | Deploy Kraken component as part of a chaos environment |
| chaos-mesh | source | Deploy Chaos-mesh component as part of a chaos environment |
| chaos-litmus | source | Deploy Litmus component as part of a chaos environment |
| chaos-monkey | source | Deploy Kubemonkey component as part of a chaos environment |
Use Chaos charts
helm repo add startx https://startxfr.github.io/helm-repository/packages/
helm install startx/chaos
helm install startx/chaos-cerberus
helm install startx/chaos-kraken
helm install startx/chaos-mesh
helm install startx/chaos-litmmus
helm install startx/chaos-monkey
Examples Helm charts
Helm chart prefixed with example- are Example chart. Example are used in demo and various workshop to show how to use helm as part of a gitops toolchain.
| Chart | Source | Description |
|---|---|---|
| example-imagestreams | source | An example on how to deploy multiple image streams using helm |
| example-knative | source | An example on how to deploy application using serverless |
| example-deployment | source | An example on how to deploy simple applications using helm and a deployment |
| example-html | source | An example on how to deploy webserver using helm and a deployment |
| example-php | source | An example on how to deploy PHP application |
| example-pod | source | An example on how to deploy simple applications using helm and a pod |
| example-sxapi | source | An example on how to deploy simple micro-applications using helm and an sxapi toolkit |
| example-catalog | source | Various demo examples |
| example-chaos | source | An example for deploying a choas test suite |
| example-fruitapp-project | source | Deploy fruitapp CI/CD demo with common and project structure (like namespaces) |
| example-fruitapp-shared | source | Deploy shared component like database and secrets |
| example-fruitapp-app | source | Deploy application stack into an environment |
Use Examples charts
helm repo add startx https://startxfr.github.io/helm-repository/packages/
helm install startx/example-deployment
helm install startx/example-html
helm install startx/example-imagestreams
helm install startx/example-knative
helm install startx/example-php
helm install startx/example-pod
helm install startx/example-sxapi
helm install startx/example-chaos
helm install startx/example-fruitapp-project
helm install startx/example-fruitapp-shared
helm install startx/example-fruitapp-app
Install a local copy of this repository
1. Requirements
1.1. install cli dependencies
yum install yq helm -y
1.2. Connect to an openshift cluster
oc login -t <my-token> <my-openshift-api>
If you don’t have access to an openshift cluster, consider using codeready-container to run locally a simulated cluster.
2. Install helm-repository
2.1. Deploy via HelmChartRepository
cat <<EOF | oc apply -f -
apiVersion: helm.openshift.io/v1beta1
kind: HelmChartRepository
metadata:
name: "startx"
labels:
app.kubernetes.io/name: "startx-chart"
spec:
name: "startx"
connectionConfig:
url: "https://startxfr.github.io/helm-repository/packages"
EOF
2.2. Deploy via HelmChartRepository (archive)
If you need to run your in an older version of Openshift, or access to archived version of helm chart, you can load the archive repository
cat <<EOF | oc apply -f -
apiVersion: helm.openshift.io/v1beta1
kind: HelmChartRepository
metadata:
name: "startx-archives"
labels:
app.kubernetes.io/name: "startx-archives-chart"
spec:
name: "startx-archives"
connectionConfig:
url: "https://startxfr.github.io/helm-repository/packages-archives"
EOF
2.3. List all charts
You can use the Openshift developper perspective of your console
3. Install local helm
3.1. Clonning this repository
git clone https://startxfr.github.io/helm-repository.git
cd helm-repository
3.2. List all charts
ls charts
3.3 Install a local chart
# oc apply -k charts/<chart>
helm install startx/chaos
helm install startx/chaos-cerberus
helm install startx/chaos-kraken
helm install startx/chaos-mesh
helm install startx/chaos-litmmus
helm install startx/chaos-monkey
helm install charts/cluster-config
helm install charts/cluster-rbac
helm install charts/cluster-auth
helm install charts/cluster-console
helm install charts/cluster-storage
helm install charts/cluster-logging
helm install charts/cluster-pipeline
helm install charts/cluster-metering
helm install charts/cluster-istio
helm install charts/cluster-knative
helm install charts/cluster-ocs
helm install charts/cluster-kubevirt
helm install charts/cluster-vault
helm install charts/cluster-quay
helm install charts/cluster-3scale
helm install charts/cluster-workspace
helm install startx/cluster-vpa
helm install startx/cluster-sso
helm install startx/cluster-ptp
helm install startx/cluster-nexus
helm install startx/cluster-keycloak
helm install startx/cluster-jenkins
helm install startx/cluster-gitlab
helm install startx/cluster-compliance
helm install startx/cluster-machine
helm install charts/project
helm install charts/operator
helm install charts/sxapi
helm install charts/example-deployment
helm install startx/example-html
helm install startx/example-imagestreams
helm install startx/example-knative
helm install startx/example-php
helm install charts/example-pod
helm install charts/example-chaos
helm install charts/example-sxapi
helm install startx/example-fruitapp-project
helm install startx/example-fruitapp-shared
helm install startx/example-fruitapp-app
Install using ArgoCD
If you whan to deploy theses charts using ArgoCD, you can follow the install using ArgoCD guide
Install building environment
In order to contribute to this repository, you must get the full developement environment by following the install build environment guide
History and releases
Read history traceback for more information on change and released version. Complementary information could be found in the release convention Notice that every chart in this repository follow it’s own release lifecycle. You can refer to it by reading every chart documentation page.