aidevops 2.52.1

package/.agent/services/hosting/hetzner.md

@@ -0,0 +1,327 @@
+---
+description: Hetzner Cloud server provisioning
+mode: subagent
+tools:
+  read: true
+  write: false
+  edit: false
+  bash: true
+  glob: true
+  grep: true
+  webfetch: true
+---
+
+# Hetzner Cloud Provider Guide
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Type**: Cloud VPS, dedicated servers, storage
+- **Locations**: Germany, Finland, USA (Ashburn, Hillsboro)
+- **API**: REST API at `api.hetzner.cloud/v1`
+- **Auth**: Bearer token via API
+- **Config**: `configs/hetzner-config.json`
+- **Commands**: `hetzner-helper.sh [list|create|connect|start|stop|reboot|api] [account] [server]`
+- **Server types**: CX (shared), CPX (dedicated vCPU), CCX (dedicated CPU)
+- **SSH**: Full root access with SSH key authentication
+- **MCP**: Port 8081+ (configurable per account)
+<!-- AI-CONTEXT-END -->
+
+Hetzner Cloud is a German cloud infrastructure provider known for excellent price-to-performance ratio, reliable service, and developer-friendly features.
+
+## Provider Overview
+
+### **Hetzner Cloud Characteristics:**
+
+- **Infrastructure Type**: Cloud VPS, Dedicated servers, Storage
+- **Locations**: Germany, Finland, USA (Ashburn, Hillsboro)
+- **API**: Comprehensive REST API with excellent documentation
+- **SSH Access**: Full root access with SSH key authentication
+- **Pricing**: Exceptional price-to-performance ratio
+- **Performance**: High-performance SSD storage, fast networking
+- **Reliability**: 99.9% uptime SLA, German engineering quality
+
+### **Best Use Cases:**
+
+- **Production applications** requiring reliable infrastructure
+- **Development and staging** environments
+- **High-performance computing** workloads
+- **Cost-effective scaling** for growing applications
+- **European data residency** requirements
+- **Docker and Kubernetes** deployments
+
+## 🔧 **Configuration**
+
+### **Setup Configuration:**
+
+```bash
+# Copy template
+cp configs/hetzner-config.json.txt configs/hetzner-config.json
+
+# Edit with your actual API tokens and server details
+```
+
+### **Multi-Account Configuration:**
+
+```json
+{
+  "accounts": {
+    "main": {
+      "api_token": "YOUR_MAIN_HETZNER_API_TOKEN_HERE",
+      "description": "Main production account",
+      "account": "your-email@domain.com"
+    },
+    "client-project": {
+      "api_token": "YOUR_CLIENT_PROJECT_HETZNER_API_TOKEN_HERE",
+      "description": "Client project account",
+      "account": "your-email@domain.com"
+    },
+    "storagebox": {
+      "api_token": "YOUR_STORAGEBOX_HETZNER_API_TOKEN_HERE",
+      "description": "Storage and backup account",
+      "account": "your-email@domain.com"
+    }
+  },
+  "mcp_integration": {
+    "enabled": true,
+    "base_port": 8081,
+    "notes": "MCP servers will use sequential ports starting from base_port"
+  }
+}
+```
+
+### **API Token Setup:**
+
+1. **Login to Hetzner Cloud Console**
+2. **Go to Security** → API Tokens
+3. **Create new token** with appropriate permissions
+4. **Copy token** to your configuration file
+5. **Test access** with API call
+
+## 🚀 **Usage Examples**
+
+### **Server Management:**
+
+```bash
+# List all servers across accounts
+./.agent/scripts/hetzner-helper.sh list
+
+# List servers for specific account
+./.agent/scripts/hetzner-helper.sh list main
+
+# Create new server
+./.agent/scripts/hetzner-helper.sh create main web-server cx11 ubuntu-20.04
+
+# Connect to server
+./.agent/scripts/hetzner-helper.sh connect main web-server
+
+# Server operations
+./.agent/scripts/hetzner-helper.sh start main web-server
+./.agent/scripts/hetzner-helper.sh stop main web-server
+./.agent/scripts/hetzner-helper.sh reboot main web-server
+```
+
+### **API Operations:**
+
+```bash
+# Raw API calls
+./.agent/scripts/hetzner-helper.sh api main servers GET
+./.agent/scripts/hetzner-helper.sh api main images GET
+./.agent/scripts/hetzner-helper.sh api main server-types GET
+
+# Server details
+./.agent/scripts/hetzner-helper.sh api main servers/12345 GET
+```
+
+### **MCP Server Integration:**
+
+```bash
+# Start MCP server for specific account
+./.agent/scripts/hetzner-helper.sh mcp-start main
+
+# Test MCP server
+curl http://localhost:8081/health
+```
+
+## 🛡️ **Security Best Practices**
+
+### **API Token Security:**
+
+- **Separate tokens**: Use different tokens for different projects
+- **Minimal permissions**: Grant only required permissions
+- **Regular rotation**: Rotate tokens every 6-12 months
+- **Secure storage**: Store tokens in secure configuration files
+- **Environment variables**: Use env vars in CI/CD pipelines
+
+### **Server Security:**
+
+```bash
+# SSH key management
+./.agent/scripts/hetzner-helper.sh exec main web-server 'cat ~/.ssh/authorized_keys'
+
+# Firewall configuration
+./.agent/scripts/hetzner-helper.sh exec main web-server 'ufw status'
+
+# Security updates
+./.agent/scripts/hetzner-helper.sh exec main web-server 'apt update && apt upgrade -y'
+```
+
+### **Network Security:**
+
+- **Private networks**: Use Hetzner private networks for internal communication
+- **Firewalls**: Configure Hetzner Cloud Firewalls
+- **Load balancers**: Use Hetzner Load Balancers for high availability
+- **Floating IPs**: Use floating IPs for failover scenarios
+
+## 🔍 **Troubleshooting**
+
+### **Common Issues:**
+
+#### **API Authentication Errors:**
+
+```bash
+# Verify API token
+curl -H "Authorization: Bearer YOUR_TOKEN" https://api.hetzner.cloud/v1/servers
+
+# Check token permissions
+# Ensure token has required scopes (read, write)
+```
+
+#### **SSH Connection Issues:**
+
+```bash
+# Check server status
+./.agent/scripts/hetzner-helper.sh api main servers/12345 GET
+
+# Verify SSH key is added
+./.agent/scripts/hetzner-helper.sh api main ssh_keys GET
+
+# Check firewall rules
+./.agent/scripts/hetzner-helper.sh api main firewalls GET
+```
+
+#### **Server Performance Issues:**
+
+```bash
+# Check server metrics
+./.agent/scripts/hetzner-helper.sh exec main web-server 'htop'
+./.agent/scripts/hetzner-helper.sh exec main web-server 'iostat -x 1'
+
+# Monitor network
+./.agent/scripts/hetzner-helper.sh exec main web-server 'iftop'
+```
+
+## 📊 **Performance Optimization**
+
+### **Server Types:**
+
+- **CX series**: Shared vCPU, cost-effective
+- **CPX series**: Dedicated vCPU, consistent performance
+- **CCX series**: Dedicated CPU, high-performance computing
+
+### **Storage Options:**
+
+- **Local SSD**: High IOPS, included with server
+- **Volumes**: Network-attached storage, scalable
+- **Snapshots**: Point-in-time backups
+
+### **Networking:**
+
+```bash
+# Private networks for internal communication
+./.agent/scripts/hetzner-helper.sh api main networks POST
+
+# Load balancers for high availability
+./.agent/scripts/hetzner-helper.sh api main load_balancers POST
+
+# Floating IPs for failover
+./.agent/scripts/hetzner-helper.sh api main floating_ips POST
+```
+
+## 🔄 **Backup & Disaster Recovery**
+
+### **Automated Backups:**
+
+```bash
+# Enable automatic backups
+./.agent/scripts/hetzner-helper.sh api main servers/12345/actions/enable_backup POST
+
+# Create manual snapshot
+./.agent/scripts/hetzner-helper.sh api main servers/12345/actions/create_image POST
+```
+
+### **Volume Snapshots:**
+
+```bash
+# Create volume snapshot
+./.agent/scripts/hetzner-helper.sh api main volumes/12345/actions/create_snapshot POST
+
+# Restore from snapshot
+./.agent/scripts/hetzner-helper.sh api main volumes POST
+```
+
+## 🐳 **Container & Kubernetes**
+
+### **Docker Setup:**
+
+```bash
+# Install Docker
+./.agent/scripts/hetzner-helper.sh exec main web-server 'curl -fsSL https://get.docker.com | sh'
+
+# Docker Compose
+./.agent/scripts/hetzner-helper.sh exec main web-server 'curl -L "https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose'
+```
+
+### **Kubernetes Integration:**
+
+- **Hetzner Cloud Controller Manager**: For Kubernetes integration
+- **CSI Driver**: For persistent volume support
+- **Load Balancer**: Automatic load balancer provisioning
+
+## 📚 **Best Practices**
+
+### **Infrastructure as Code:**
+
+```bash
+# Use Terraform for infrastructure management
+# Hetzner provider available
+terraform init
+terraform plan
+terraform apply
+```
+
+### **Monitoring & Alerting:**
+
+- **Prometheus**: For metrics collection
+- **Grafana**: For visualization
+- **AlertManager**: For alerting
+- **Uptime monitoring**: External monitoring services
+
+### **Cost Optimization:**
+
+- **Right-sizing**: Choose appropriate server types
+- **Scheduling**: Use scheduling for development environments
+- **Snapshots**: Regular cleanup of old snapshots
+- **Monitoring**: Track resource utilization
+
+## 🎯 **AI Assistant Integration**
+
+### **Automated Infrastructure:**
+
+- **Auto-scaling**: Automated server provisioning
+- **Health monitoring**: Automated health checks
+- **Backup management**: Automated backup scheduling
+- **Security updates**: Automated security patching
+- **Cost monitoring**: Automated cost tracking and alerts
+
+### **Development Workflows:**
+
+- **Environment provisioning**: Automated dev/staging environments
+- **CI/CD integration**: Automated deployments
+- **Testing environments**: Ephemeral test environments
+- **Database management**: Automated database operations
+
+---
+
+**Hetzner Cloud provides exceptional value with enterprise-grade features, making it ideal for production workloads and cost-conscious scaling.** 🚀

package/.agent/services/hosting/hostinger.md

@@ -0,0 +1,287 @@
+---
+description: Hostinger web hosting provider integration
+mode: subagent
+tools:
+  read: true
+  write: false
+  edit: false
+  bash: true
+  glob: true
+  grep: true
+  webfetch: true
+---
+
+# Hostinger Provider Guide
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Type**: Shared/VPS/Cloud hosting, budget-friendly
+- **SSH**: Port 65002, password auth (no SSH keys on shared)
+- **Panel**: Custom hPanel
+- **Config**: `configs/hostinger-config.json`
+- **Commands**: `hostinger-helper.sh [list|connect|upload|download|exec] [site] [args]`
+- **Username format**: `u[0-9]+`
+- **Password file**: `~/.ssh/hostinger_password` (chmod 600)
+- **Requires**: `sshpass` for password authentication
+<!-- AI-CONTEXT-END -->
+
+Hostinger is a popular web hosting provider offering shared hosting, VPS, and cloud hosting solutions with competitive pricing and good performance.
+
+## Provider Overview
+
+### **Hostinger Characteristics:**
+
+- **Hosting Type**: Shared hosting, VPS, Cloud hosting
+- **SSH Access**: Available on VPS and higher plans
+- **Control Panel**: Custom hPanel (user-friendly)
+- **SSH Authentication**: Password-based (SSH keys not supported on shared hosting)
+- **API Support**: Limited API functionality
+- **Pricing**: Budget-friendly with good value
+- **Performance**: Good performance for the price point
+
+### **Best Use Cases:**
+
+- **Small to medium websites** with moderate traffic
+- **WordPress hosting** with optimized performance
+- **Development environments** for testing and staging
+- **Cost-effective hosting** for multiple domains
+- **Beginner-friendly** hosting with easy management
+
+## 🔧 **Configuration**
+
+### **Setup Configuration:**
+
+```bash
+# Copy template
+cp configs/hostinger-config.json.txt configs/hostinger-config.json
+
+# Edit with your actual server details
+```
+
+### **Configuration Structure:**
+
+```json
+{
+  "sites": {
+    "example.com": {
+      "server": "server-hostname-or-ip",
+      "port": 65002,
+      "username": "u123456789",
+      "password_file": "~/.ssh/hostinger_password",
+      "domain_path": "/domains/example.com/public_html",
+      "description": "Main website"
+    }
+  },
+  "default_settings": {
+    "port": 65002,
+    "username_pattern": "u[0-9]+",
+    "password_authentication": true,
+    "ssh_keys_supported": false
+  }
+}
+```
+
+### **Password File Setup:**
+
+```bash
+# Create secure password file
+echo 'your-hostinger-password' > ~/.ssh/hostinger_password
+chmod 600 ~/.ssh/hostinger_password
+
+# Install sshpass for password authentication
+brew install sshpass  # macOS
+sudo apt-get install sshpass  # Linux
+```
+
+## 🚀 **Usage Examples**
+
+### **Basic Commands:**
+
+```bash
+# List all Hostinger sites
+./.agent/scripts/hostinger-helper.sh list
+
+# Connect to a site
+./.agent/scripts/hostinger-helper.sh connect example.com
+
+# Upload files to a site
+./.agent/scripts/hostinger-helper.sh upload example.com /local/path /remote/path
+
+# Download files from a site
+./.agent/scripts/hostinger-helper.sh download example.com /remote/path /local/path
+
+# Execute command on server
+./.agent/scripts/hostinger-helper.sh exec example.com 'ls -la'
+```
+
+### **File Management:**
+
+```bash
+# Upload website files
+./.agent/scripts/hostinger-helper.sh upload example.com ./dist/ /domains/example.com/public_html/
+
+# Backup website
+./.agent/scripts/hostinger-helper.sh download example.com /domains/example.com/public_html/ ./backup/
+
+# Update specific files
+./.agent/scripts/hostinger-helper.sh upload example.com ./index.html /domains/example.com/public_html/index.html
+```
+
+### **Database Operations:**
+
+```bash
+# Access MySQL (if available)
+./.agent/scripts/hostinger-helper.sh exec example.com 'mysql -u username -p database_name'
+
+# Backup database
+./.agent/scripts/hostinger-helper.sh exec example.com 'mysqldump -u username -p database_name > backup.sql'
+```
+
+## 🛡️ **Security Considerations**
+
+### **Password Security:**
+
+- **Secure storage**: Store passwords in files with 600 permissions
+- **Never commit**: Add password files to .gitignore
+- **Regular rotation**: Change passwords periodically
+- **Strong passwords**: Use complex, unique passwords
+
+### **SSH Security:**
+
+- **Non-standard port**: Hostinger uses port 65002
+- **Password authentication**: SSH keys not supported on shared hosting
+- **Connection limits**: Be aware of concurrent connection limits
+- **IP restrictions**: Consider IP-based access restrictions if available
+
+### **File Permissions:**
+
+```bash
+# Set proper permissions for web files
+./.agent/scripts/hostinger-helper.sh exec example.com 'chmod 644 /domains/example.com/public_html/*.html'
+./.agent/scripts/hostinger-helper.sh exec example.com 'chmod 755 /domains/example.com/public_html/scripts/'
+```
+
+## 🔍 **Troubleshooting**
+
+### **Common Issues:**
+
+#### **Connection Refused:**
+
+```bash
+# Check if SSH is enabled on your plan
+# Verify server hostname and port (usually 65002)
+# Ensure password is correct
+```
+
+#### **Permission Denied:**
+
+```bash
+# Verify username format (usually u followed by numbers)
+# Check password file permissions (should be 600)
+# Ensure sshpass is installed
+```
+
+#### **File Upload Issues:**
+
+```bash
+# Check destination path exists
+./.agent/scripts/hostinger-helper.sh exec example.com 'ls -la /domains/example.com/'
+
+# Verify disk space
+./.agent/scripts/hostinger-helper.sh exec example.com 'df -h'
+
+# Check file permissions
+./.agent/scripts/hostinger-helper.sh exec example.com 'ls -la /domains/example.com/public_html/'
+```
+
+## 📊 **Performance Optimization**
+
+### **Website Performance:**
+
+```bash
+# Enable compression (if supported)
+./.agent/scripts/hostinger-helper.sh exec example.com 'echo "gzip on;" >> /domains/example.com/.htaccess'
+
+# Optimize images before upload
+# Use tools like imagemin or tinypng before uploading
+
+# Monitor resource usage
+./.agent/scripts/hostinger-helper.sh exec example.com 'top'
+./.agent/scripts/hostinger-helper.sh exec example.com 'df -h'
+```
+
+### **Caching Strategies:**
+
+- **Browser caching**: Configure .htaccess for static assets
+- **CDN integration**: Use Cloudflare or similar CDN
+- **Image optimization**: Compress images before upload
+- **Minification**: Minify CSS/JS before deployment
+
+## 🔄 **Backup & Deployment**
+
+### **Automated Backups:**
+
+```bash
+# Create backup script
+#!/bin/bash
+DATE=$(date +%Y%m%d_%H%M%S)
+./.agent/scripts/hostinger-helper.sh download example.com /domains/example.com/public_html/ ./backups/example.com_$DATE/
+```
+
+### **Deployment Workflow:**
+
+```bash
+# Build and deploy
+npm run build
+./.agent/scripts/hostinger-helper.sh upload example.com ./dist/ /domains/example.com/public_html/
+
+# Verify deployment
+./.agent/scripts/hostinger-helper.sh exec example.com 'ls -la /domains/example.com/public_html/'
+```
+
+## 📚 **Best Practices**
+
+### **Development Workflow:**
+
+1. **Local development**: Develop and test locally first
+2. **Staging environment**: Use subdomain for staging
+3. **Backup before deploy**: Always backup before major changes
+4. **Incremental updates**: Upload only changed files when possible
+5. **Monitor performance**: Check site performance after deployments
+
+### **File Organization:**
+
+- **Consistent structure**: Maintain consistent directory structure
+- **Version control**: Use Git for source code management
+- **Documentation**: Document deployment procedures
+- **Environment configs**: Separate configs for different environments
+
+### **Monitoring:**
+
+- **Uptime monitoring**: Use services like UptimeRobot
+- **Performance monitoring**: Monitor page load times
+- **Error logging**: Check server logs regularly
+- **Resource usage**: Monitor disk space and bandwidth
+
+## 🎯 **AI Assistant Integration**
+
+### **Automated Tasks:**
+
+- **Deployment automation**: Automated file uploads after builds
+- **Backup scheduling**: Regular automated backups
+- **Performance monitoring**: Automated performance checks
+- **Security scanning**: Regular security audits
+- **Content updates**: Automated content deployment
+
+### **Monitoring & Alerts:**
+
+- **Uptime alerts**: Notifications for site downtime
+- **Performance alerts**: Warnings for slow performance
+- **Security alerts**: Notifications for security issues
+- **Resource alerts**: Warnings for high resource usage
+
+---
+
+**Hostinger provides excellent value for money with good performance, making it ideal for small to medium websites and development environments.** 🚀