Skip to content

cluster-3scale Cluster Chart : 3Scale (API Management)

Artifacthub

This helm chart is used to create a deployment of a 3scale, operator based, deployment of 3Scale API management tools.

This chart is part of the cluster-xxx startx helm chart series that doesn’t necessarily deploy pods but rather represent a cluster configuration state orchestrated by gitops tools like ArgoCD.

Requirements and guidelines

Read the startx helm-repository homepage for more information on how to use theses resources.

Deploy this helm chart on openshift

1. Connect to your Openshift cluster

oc login -t <token> <cluster-url>

2. Install the repository

helm repo add startx https://helm-repository.readthedocs.io/en/latest/repos/stable/

3. Get information about this chart

helm show chart startx/cluster-3scale

4. Install this chart

helm install cluster-3scale startx/cluster-3scale

Default values

Complete deployment of a project with the following characteristics :

  • 1 project: named startx-3scale with the following properties
  • 1 LimitRange: defined for this projet
  • 1 Quotas: defined for this projet
  • 3 RBAC: allowing mygroup_example to edit resources
  • 1 operator: named 3scale-operator configured with
  • The threescale-2.13 channel
  • The 0.10.5 version
  • Deployed under the openshift-operators project
  • The manager deployed
  • 1 Secret: named startx-3scale-rhn that hold rhn credentials used fo image pulling
# base configuration running default configuration
helm install cluster-3scale startx/cluster-3scale

Other available values

  • startx : Startx 3scale cluster wide service configuration using startx group (dev, devops and ops) (see values.yaml)
helm install cluster-3scale startx/cluster-3scale -f https://raw.githubusercontent.com/startxfr/helm-repository/master/charts/cluster-3scale/values-startx.yaml

Deploy via ArgoCD Application

Deploy cluster-3scale using three dedicated ArgoCD Applications sharing the same AppProject. The 3scale operator runs in openshift-operators (all-namespaces scope); APIManager instances are deployed in startx-3scale.

3scale 2.16+ requires external databases. The optional clusterRedis and clusterCrunchy sub-chart dependencies deploy a Redis cluster and a CrunchyDB PostgreSQL cluster, and externalComponents wires them into the APIManager via secrets (system-redis, backend-redis, system-database, zync).

git clone https://gitlab.com/startx1/helm.git
cd helm-repository/charts/cluster-3scale/examples/argocd/
oc apply -k .

Passwords: update externalComponents.database.password, externalComponents.zync.password, and externalComponents.zync.secretKeyBase in your ArgoCD Application values (or use a Sealed Secret / ExternalSecret). The initScript in clusterCrunchy.cluster.list[0] must use the same passwords.

Node selector: the 3scale operator deployment requests node-role.kubernetes.io/infra nodes. On clusters without dedicated infra nodes, set operator.subscription.operator.config.infra: false in the -operator Application values.

History

Release Date Description
16.19.59 2024-12-09 Align all chart to the 16.19.59 release
17.14.19 2025-03-12 Align all chart to the 17.14.19 release
17.14.90 2025-04-30 Publish stable release for 4.17 version
18.11.71 2025-11-27 Align all charts to the same releas
18.23.0 2026-02-28 Start 4.19 branch
19.23.15 2026-03-02 Prepare upgrading dependency to 19.23.11
19.23.17 2026-03-02 Align all dependencies to chart v19.23.11
20.14.7 2026-03-02 Update dependencies to version 20.14.0
20.14.15 2026-03-02 Update all chrat to OCP version 4.20.14
21.3.0 2026-03-02 Update all chart to OCP version 4.21.3
21.3.1 2026-03-02 Prepare release 21.3.x with 21.x dependencies
21.3.3 2026-03-02 Upgrade dependencies to v21.3.0
21.3.4 2026-03-03 Upgrade to operator v0.10.5
21.3.5 2026-06-17 21.3.9
21.3.11 2026-06-17 publish stable update for the full repository
21.3.12 2026-06-18 Improve cluster-3scale options
21.3.27 2026-06-19 publish stable update for the full repository
21.3.55 2026-06-19 publish stable update for the full repository
21.3.56 2026-06-19 Add cluster-redis/cluster-crunchy sub-charts and externalComponents support for 3scale 2.16+
21.3.57 2026-06-20 Auto-create openshift-crunchy-pgo namespace in project wave; fix secrets leaking into operator wave
21.3.56 2026-06-19 publish stable update for the full repository
21.3.56 2026-06-19 publish stable update for the full repository
21.3.67 2026-06-20 publish stable update for the full repository
21.3.68 2026-06-20 update basic dependencies to v21.3.70
21.3.68 2026-06-20 update all charts dependencies to v21.3.70
21.3.68 2026-06-20 update all charts dependencies to v21.3.70
21.3.102 2026-06-20 publish stable update for the full repository
21.3.103 2026-06-21 publish stable update for the full repository
21.3.103 2026-06-21 publish stable update for the full repository
21.3.104 2026-06-21 publish stable update for the full repository
21.3.105 2026-06-21 publish stable update for the full repository
21.3.105 2026-06-21 publish stable update for the full repository
21.3.105 2026-06-21 publish stable update for the full repository
21.3.106 2026-06-21 publish stable update for the full repository
21.3.107 2026-06-21 publish stable update for the full repository
21.3.167 2026-06-23 publish stable update for the full repository
21.3.181 2026-06-23 publish stable update for the full repository
21.3.182 2026-06-23 publish stable update for the full repository