Services#

Documentation for services deployed on the Kubernetes cluster.

This section covers the various applications and services running on the cluster:

Available Services#

• JupyterHub - Multi-user Jupyter notebook environment with GPU support
• PostgreSQL - Relational database service
• MinIO - S3-compatible object storage
• GitHub Actions Runners - Self-hosted CI/CD runners
• vLLM - High-performance LLM inference

Prerequisites#

Before deploying services, ensure the infrastructure is properly configured:

• K3s is installed and running
• Storage backend is configured (if needed)
• SSL certificates are set up (for external access)
• DNS is configured (for external access)
• GPU support is enabled (if using GPU services)

Service Deployment#

Most services include deployment scripts in their respective directories. General pattern:

cd <service-directory>
./up.sh      # Deploy
./down.sh    # Remove

Or use kubectl and Helm directly:

kubectl apply -f <service>.yaml
helm install <service> <chart> -f values.yaml