Skip to main content

​
Container Orchestration Installation

NeuralTrust’s infrastructure deployment to container orchestration platforms utilizes industry-standard deployment charts for reliable, scalable container management. This comprehensive guide walks you through setting up the self-hosted Data Plane in your container environment, providing enterprise-grade AI monitoring capabilities with the flexibility and scalability that container orchestration offers. Container orchestration deployment is ideal for organizations that require container management, auto-scaling capabilities, and integration with existing container infrastructure. This approach provides maximum flexibility for resource management, monitoring integration, and operational control while maintaining the security and performance benefits of containerized deployments.

​
Prerequisites

Ensure your system meets these requirements before beginning the installation: • kubectl - Container orchestration command-line tool for cluster management • [container package manager] - Package manager for container applications • Container Cluster: Version 1.20+ with RBAC enabled for proper security controls • Resource Requirements: Minimum 4 CPU cores and 8GB RAM for development environments • Storage: Persistent volume support with 100GB+ available storage • Network: LoadBalancer service type support or ingress controller configuration • SSL Certificate: Valid SSL certificate for HTTPS endpoint configuration

​
Installation

​
Step 1: Repository Setup

Begin by cloning the NeuralTrust Deployment Charts repository, which contains all necessary container manifests, configuration templates, and installation scripts: 
git clone https://github.com/NeuralTrust/neuraltrust-deployment-charts.git
cd neuraltrust-deployment-charts
This repository includes production-ready deployment charts that have been tested across various container distributions and cloud providers, ensuring reliable deployment regardless of your specific container environment.

​
Step 2: Environment Configuration

Configure your deployment environment by copying the template and customizing it for your specific requirements: 
cp environments/production.example.env environments/production.env
Edit the configuration file with your specific deployment parameters including cluster configuration, security settings, and integration endpoints that match your organizational requirements and compliance standards.

​
Step 3: Automated Deployment

Execute the automated installation script that handles all aspects of the container deployment: 
chmod +x install.sh
./install.sh environments/production.env
The script automatically handles container namespace creation, secret management, persistent volume provisioning, service deployment, and ingress configuration. All components are deployed with appropriate security contexts, resource limits, and health checks to ensure optimal security and performance.

​
Step 4: DNS Configuration

Configure your DNS records to point to your container ingress controller. You can use either a CNAME record (preferred for most cloud environments) or an A record depending on your DNS provider and infrastructure setup: Option A: CNAME Record (Recommended) 
# Get the ingress controller hostname
kubectl get svc -n <namespace> ingress-controller -o jsonpath='{.status.loadBalancer.ingress[0].hostname}'

# Create CNAME record: neuraltrust.yourcompany.com -> ingress-hostname
Option B: A Record 
# Get the ingress controller IP address
kubectl get svc -n <namespace> ingress-controller -o jsonpath='{.status.loadBalancer.ingress[0].ip}'

# Create A record: neuraltrust.yourcompany.com -> IP address

​
Step 5: Control Plane Connection

Complete the setup by connecting your Data Plane to the NeuralTrust Control Plane:
  1. Obtain Connection Details - Retrieve your Data Plane endpoint URL and authentication tokens from the deployment output
  2. Configure Control Plane - Add your Data Plane connection in the NeuralTrust Control Plane interface
  3. Verify Integration - Test the connection between Control Plane and Data Plane components
  4. Connection Validation - Save the connection settings and verify successful communication between the Control Plane and your container-deployed Data Plane

​
Analytics Database

The Data Plane deployment includes a comprehensive analytics database configured specifically for AI monitoring workloads. This high-performance columnar database provides real-time analytics capabilities with optimized storage and query performance tailored for AI monitoring data patterns. Database Configuration: The deployment includes a single database server optimized for standard AI monitoring workloads, with a 100GB persistent volume for data storage that automatically scales based on usage patterns. The database is pre-configured with optimized schemas, indexes, and partitioning strategies designed specifically for efficient AI monitoring data storage and retrieval operations. Scaling Considerations: Note that the current version focuses on single-server deployments optimized for most enterprise use cases. Multi-node database deployments with sharding capabilities are planned for future releases to support ultra-high-volume scenarios.

​
Configuration Updates

​
Rolling Updates

The container deployment supports seamless updates and configuration changes through the same installation process used for initial deployment. To apply updates or configuration changes, modify your environment configuration file and re-run the installation script. The deployment system automatically detects changes and applies them using rolling updates that maintain service availability. Update Process:
  1. Modify configuration in your environment file
  2. Run the installation script with the updated configuration
  3. Monitor the deployment status during the rolling update process
  4. Verify that all services are operational after the update completes
The system preserves all existing data and configuration during updates, ensuring continuity of operations and preventing data loss during the update process.

​
Troubleshooting

IssueDiagnostic CommandSolution
Service connectivitykubectl get pods -n neuraltrustVerify pod status, check logs, and ensure proper resource allocation
Analytics database connectivitykubectl get pods -n neuraltrust | grep analyticsVerify pod health, persistent volume mounting, and service configuration
Ingress issueskubectl describe ingress -n neuraltrustCheck ingress controller, SSL certificates, and DNS configuration
Performance issueskubectl top pods -n neuraltrustMonitor resource usage and consider scaling or resource adjustment
Common Solutions: • Pod startup issues: Check resource limits, persistent volume availability, and image pull permissions • Network connectivity: Verify security groups, network policies, and service configurations • Storage issues: Ensure persistent volume claims are bound and storage class is properly configured • SSL/TLS issues: Verify certificate installation and ingress TLS configuration Getting Help: For additional support, contact our technical team at support@neuraltrust.ai with detailed information about your container environment, deployment configuration, and specific error messages for fastest resolution.

​
What’s Next

Our development roadmap includes enhanced container orchestration features based on customer feedback and emerging container ecosystem developments. Stay Updated: Follow our [deployment documentation updates] for the latest features and improvements.
Production Ready: Container orchestration deployment provides enterprise-grade container management with auto-scaling, rolling updates, and comprehensive observability integration, making it ideal for production AI monitoring environments.
⌘I