Helm

​

Prerequisites

• Kubernetes cluster (v1.19+)
• Helm 3.x installed
• kubectl configured to access your cluster

​

Quick Start

​

1. Clone the Repository

git clone https://github.com/NRAI/NRAI.git
cd NRAI

​

2. Install Dependencies

helm dependency update

​

3. Create a Values File

​

4. Install NRAI

helm install NRAI deploy/NRAI-helm -f my-values.yaml

​

5. Verify Installation

# Check deployment status
kubectl get pods
kubectl get services

​

Production Checklist

• Set strong passwords for PostgreSQL and Redis
• Configure proper ingress with TLS
• Set appropriate resource limits
• Configure persistent storage
• Review environment variables for proper configuration
• Choose appropriate execution mode for your security requirements
• Consider using a separate workers setup for better availability and security

​

Upgrading

# Update dependencies
helm dependency update

# Upgrade release
helm upgrade NRAI deploy/NRAI-helm -f my-values.yaml

# Check upgrade status
kubectl rollout status deployment/NRAI

​

Troubleshooting

​

Common Issues

1. Pod won’t start: Check logs with kubectl logs deployment/NRAI
2. Database connection: Verify PostgreSQL credentials and connectivity
3. Frontend URL: Ensure frontendUrl is accessible from external sources
4. Webhooks not working: Check ingress configuration and DNS resolution

​

Useful Commands

# View logs
kubectl logs deployment/NRAI -f

# Port forward for testing
kubectl port-forward svc/NRAI 4200:80 --namespace default

# Get all resources
kubectl get all --namespace default

​

Environment Variables

​

Execution Modes

​

Uninstalling

helm uninstall NRAI

# Clean up persistent volumes (optional)
kubectl delete pvc -l app.kubernetes.io/instance=NRAI