Skip to main content

Introduction and Advantages

📘 Overview​

The CSGHub Helm Chart is the official deployment solution for CSGHUB in Kubernetes environments.

It integrates all CSGHub core components, dependencies, and configurations into a single, repeatable, and scalable cloud-native AI platform package, enabling a fully automated lifecycle from deployment → management → upgrade.

With Helm Charts, users can deploy CSGHub on any compatible Kubernetes cluster within minutes, dramatically reducing deployment complexity and maintenance overhead.

🧩 Version Information​

The Community Edition (CE) and Enterprise Edition (EE) Charts are now unified into a single version.

You can easily select your desired edition through configuration parameters:

helm install csghub csghub/csghub \
  --set global.edition=ce   # or ee

💡 Tip: The Community Edition is suitable for development and testing, while the Enterprise Edition provides high availability, auditing, security, and multi-tenancy support.

💎 Key Advantages​

1️⃣ Backward Compatibility​

  • 🔄 Seamless Upgrade Path: Supports zero-downtime upgrades via standardized Helm version control.
  • 🧩 Reduced Production Risks: Ensures backward compatibility with existing configurations during upgrades.
  • 🛡️ Long-Term Support (LTS): Each Chart is regression-tested and performance-validated for production readiness.

2️⃣ Continuous Architecture Optimization​

  • ⚙️ Parameterized Configuration: Flexible customization through values.yaml for multi-environment adaptation.
  • 🚀 Performance Optimization: Ongoing structural improvements enhance deployment speed and resource efficiency.
  • 🧱 Modular Design: Clear component layering for easier maintenance and customization (e.g., external database or storage integration).

3️⃣ Enterprise-Grade Features​

  • 🏗️ Multi-Environment Support: One Chart covers development, testing, and production deployments.
  • ⏪ Rollback Capability: Instantly revert to a stable previous version.
  • 🔐 Security & Compliance: Built-in RBAC, security policies, and certificate management meet enterprise standards.
  • 📈 Observability Integration: Native support for Prometheus, Grafana, and Loki monitoring and logging.

4️⃣ Cloud-Native Best Practices​

  • 🧾 Declarative Configuration: All resources managed via declarative YAML for consistent deployments.
  • ⚙️ Automated Deployment: Integrates seamlessly with CI/CD pipelines (GitLab CI, ArgoCD, Tekton, etc.).
  • 📦 Resource Governance: Built-in Requests/Limits templates for optimal scheduling and performance.
  • 🔁 High Availability Architecture: Configurable replicas and load balancing enhance system resilience.

🧠 Use Cases​

🏢 Production Deployment​

  • Designed for enterprise-grade, high-availability, large-scale deployments.
  • Offers strict version control, rollback mechanisms, and high-performance multi-node support.
  • Deep integration with the Kubernetes ecosystem (e.g., Istio, ArgoCD, Vault).

🧪 Development & Testing​

  • Rapidly spin up test environments for feature validation.
  • Supports local development and temporary testing clusters.
  • Ideal for automated integration and performance regression testing within CI/CD pipelines.

☁️ Multi-Cluster & Hybrid Cloud Deployment​

  • Enables unified deployment and configuration synchronization across multiple clusters.
  • Centralized logging, monitoring, and access control.
  • Unified Helm values templates to manage environment-specific configurations.

🏗️ Technical Architecture​

The CSGHub Helm Chart adopts a layered architecture design to ensure component decoupling, flexibility, and scalability:

LayerDescription
Core LayerKubernetes-native resources such as Deployment, Service, ConfigMap, and Secret.
Middleware LayerFoundational services like databases, caches, message queues, and object storage.
Application LayerCore CSGHub service modules (API, Web, Scheduler, Runner, etc.).
Networking LayerHandles Ingress, Gateway, and Service Mesh integrations.
Storage LayerProvides persistent volume configurations and backup strategies.

This design ensures:

  • Independent upgrades and replacements for each component.
  • High system reliability and observability.
  • Smooth scalability across multi-cluster and multi-region environments.

🔍 Summary​

CSGHUB Helm Chart, built on cloud-native principles and enterprise-grade automation,

empowers organizations to quickly build scalable, secure, and stable AI platform infrastructure.

💬 Support and Feedback​