aidevops 2.52.1 → 2.53.2

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

@@ -1,327 +0,0 @@
----
-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

@@ -1,287 +0,0 @@
----
-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.** 🚀