Skip to main content

Deployment Overview

1. Introduction​

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

It integrates all of CSGHub's core components, dependent services, and configurations into a repeatable, scalable, and cloud-native AI platform installation package. This enables full-lifecycle automation from Deployment → Management → Upgrades. Using the Helm Chart, users can complete deployment on any compatible Kubernetes cluster within minutes, significantly reducing deployment complexity and maintenance costs.

2. Edition Description​

The CSGHub Helm Chart supports the deployment of both the Community Edition (CE) and Enterprise Edition (EE). Switch between editions using the parameter: global.edition.

3. Core Advantages​

3.1 Backward Compatibility​

  • Smooth Upgrade Path: Standardized version control mechanisms support helm upgrade for zero-downtime updates.
  • Reduced Production Risk: Ensures every version remains compatible with existing configurations during upgrades, minimizing downtime and compatibility issues.
  • Long-Term Support (LTS): Each Chart undergoes regression testing and performance validation, making it suitable for long-term production operations.

3.2 Continuous Architectural Optimization​

  • Parameterized Configuration: Flexibly define parameters for various components via the values.yaml file to adapt to multiple environments.
  • Performance Tuning: Continuous optimization of Chart templates to improve deployment speed and resource utilization.
  • Modular Design: Clear component layering for easier maintenance and custom extensions (e.g., integrating external databases or storage).

3.3 Enterprise-Grade Features​

  • Multi-Environment Support: A single Chart supports differentiated deployment across development, testing, and production environments.
  • Version Rollback: Supports one-click rollback to quickly restore the previous stable version.
  • Security & Compliance: Built-in RBAC, security policies, and certificate management to meet enterprise security requirements.
  • Observability Integration: Native support for monitoring and logging systems like Prometheus, Grafana, and Loki.

3.4 Cloud-Native Best Practices​

  • Declarative Configuration: All resources are managed through declarative YAML, ensuring deployment consistency.
  • Automated Deployment: Supports integration with CI/CD pipelines (e.g., GitLab CI, ArgoCD).
  • Resource Governance: Built-in templates for Resource Requests/Limits to optimize scheduling and performance.
  • High-Availability Architecture: Configurable multi-replica and load-balancing mechanisms to enhance system stability.

4. Target Scenarios​

4.1 Production Environment Deployment​

  • Suitable for Enterprise-grade High Availability and Large-scale Cluster deployments.
  • Requires strict version control, rollback mechanisms, and multi-node high-performance support.
  • Deeply integrates with the existing Kubernetes ecosystem.

4.2 Development and Testing Environments​

  • Quickly set up testing environments for functional verification.
  • Supports local development and temporary test cluster deployments.
  • Can be used in CI/CD for automated integration and performance regression testing.

4.3 Multi-Cluster and Hybrid Cloud Deployment​

  • Supports unified deployment and configuration synchronization across multiple Kubernetes clusters.
  • Centralized logging, monitoring, and access control.
  • Provides a unified Helm Values template to manage differences across multiple environments.

5. Support and Feedback​