Helm Charts Repository

Official Helm repository for deploying and managing CloudNexus infrastructure components on Kubernetes. All charts are maintained by the CloudNexus Platform Engineering team.

Overview

CloudNexus provides pre-built, production-ready Helm charts for core platform services. These charts are optimized for high availability, automated scaling, and seamless integration with our managed control plane.

ℹ️ Prerequisites

Helm 3.12+ and kubectl 1.27+ are required. Ensure your cluster has network access to charts.cloudnexus.io and registry credentials configured.

Quick Start

Add the Repository

bash

helm repo add cloudnexus https://charts.cloudnexus.io
helm repo update

Install Core Chart

bash

helm install cn-core cloudnexus/cloudnexus-core \
  --namespace cloudnexus-system --create-namespace \
  --set global.clusterId="prod-us-east-1" \
  --set image.pullSecrets[0].name="registry-creds"

⚠️ Authentication Required

Production clusters require an API key. Set it via --set apiKey=\"\" or reference a secret.

Available Charts

The following charts are actively maintained and tested against Kubernetes 1.26-1.30.

Chart Name	Version	App Version	Description	Status
`cloudnexus-core`	3.2.1	2.8.0	Control plane, API gateway, and scheduler	Stable
`cloudnexus-monitoring`	1.4.0	0.9.2	Prometheus stack, Loki, Grafana dashboards	Stable
`cloudnexus-gateway`	2.1.0	1.3.0	Edge ingress, TLS termination, rate limiting	Stable
`cloudnexus-storage`	0.8.4	0.5.1	Object storage proxy, S3-compatible layer	Beta
`cloudnexus-db-agent`	1.0.2	1.0.2	Managed database connectivity & backup agent	Stable

Configuration

Chart behavior is controlled via values.yaml. All charts follow the standard global. prefix pattern for cluster-wide settings.

Key Parameters

yaml

# values.yaml
global:
  clusterId: "prod-us-east-1"
  region: "us-east-1"
  environment: "production"
  apiEndpoint: "https://api.cloudnexus.io/v2"

replicaCount: 3

image:
  repository: cn-registry.io/cloudnexus/core
  tag: "2.8.0"
  pullPolicy: IfNotPresent

resources:
  requests:
    cpu: "500m"
    memory: "1Gi"
  limits:
    cpu: "2000m"
    memory: "4Gi"

ingress:
  enabled: true
  className: "cloudnexus-gateway"
  annotations:
    cert-manager.io/cluster-issuer: "letsencrypt-prod"

💡 Tip

Run helm show values cloudnexus/cloudnexus-core to view the complete parameter reference for any chart.

Lifecycle Management

Upgrading

CloudNexus charts support zero-downtime upgrades. Rollbacks are automatically triggered on health check failures.

bash

# Upgrade to latest version
helm upgrade cn-core cloudnexus/cloudnexus-core \
  --namespace cloudnexus-system --wait --timeout 5m

# Rollback on failure
helm rollback cn-core 2 --namespace cloudnexus-system

Uninstallation

bash

helm uninstall cn-core --namespace cloudnexus-system
kubectl delete namespace cloudnexus-system

Troubleshooting

Common Issues

Issue	Cause	Resolution
`ImagePullBackOff`	Missing registry credentials	Create secret or set `image.pullSecrets`
`Readiness probe failed`	API endpoint unreachable	Verify `global.apiEndpoint` and network policies
`Hook failed: pre-install`	CRD not registered	Run `helm dependency update` or check webhook logs
`PVC Pending`	Storage class mismatch	Set `pvc.storageClassName` to match cluster provisioner

Debugging

Enable verbose logging for Helm operations:

bash

HELM_DEBUG=true helm install cn-core cloudnexus/cloudnexus-core --namespace cn-system
kubectl logs -n cn-system -l app.kubernetes.io/name=cn-core --tail=100