Merge branch 'feature/terraform_module' into 'main'

feat: Add Terraform modules for AWS deployment

See merge request postgres-ai/postgres_ai!58

Author: bogdan-ts

docker-compose.yml

@@ -99,7 +99,7 @@ services:
     container_name: grafana-with-datasources
     environment:
       GF_SECURITY_ADMIN_USER: monitor
-      GF_SECURITY_ADMIN_PASSWORD: demo
+      GF_SECURITY_ADMIN_PASSWORD: ${GRAFANA_PASSWORD:-demo}
       GF_INSTALL_PLUGINS: yesoreyeram-infinity-datasource
     ports:
       - "3000:3000"

terraform/README.md

@@ -0,0 +1,92 @@
+# Terraform deployment modules
+
+Infrastructure as Code modules for deploying postgres_ai monitoring to cloud providers.
+
+## Available modules
+
+### AWS (EC2)
+Single EC2 instance deployment with Docker Compose.
+
+- **Path**: `aws/`
+- **Architecture**: Single EC2 instance with Docker Compose
+- **Best for**: Small to medium deployments (1-10 databases)
+- **Documentation**: [aws/README.md](aws/README.md)
+
+### GCP (Coming soon)
+Deploy to Google Cloud Platform using Compute Engine or Cloud Run.
+
+### Azure (Coming soon)
+Deploy to Microsoft Azure using Virtual Machines or Container Instances.
+
+## Quick start
+
+### AWS deployment
+
+```bash
+cd terraform/aws
+
+# Copy example variables
+cp terraform.tfvars.example terraform.tfvars
+
+# Edit variables with your settings
+vim terraform.tfvars
+
+# Initialize Terraform
+terraform init
+
+# Review the plan
+terraform plan
+
+# Deploy infrastructure (takes 5-10 minutes)
+terraform apply
+```
+
+## Architecture overview
+
+The AWS deployment creates:
+
+1. **Compute**
+   - Single EC2 instance (t3.medium default)
+   - Ubuntu 22.04 LTS (Jammy) with Docker and Docker Compose
+   - Systemd service for automatic startup
+
+2. **Storage**
+   - EBS volume for persistent data
+   - Automated snapshots available via AWS Backup
+
+3. **Networking**
+   - VPC with public subnet
+   - Security Group with restricted access
+   - Optional Elastic IP for stable addressing
+
+4. **Monitoring stack**
+   - Runs docker-compose from cloned repository
+   - Grafana accessible on port 3000
+
+## Security considerations
+
+- EC2 instance in public subnet (can be changed to private with bastion)
+- Security groups restrict access to SSH and Grafana only
+- All data encrypted at rest (EBS encryption)
+- Recommended: Use AWS Systems Manager Session Manager instead of SSH
+- Recommended: Restrict `allowed_cidr_blocks` to your office/VPN IP
+
+## Instance types
+
+Recommended instance types based on workload:
+
+- **t3.medium**: 2 vCPU, 4 GiB RAM - suitable for 1-3 databases (default)
+- **t3.large**: 2 vCPU, 8 GiB RAM - suitable for 3-10 databases
+- **t3.xlarge**: 4 vCPU, 16 GiB RAM - suitable for 10+ databases
+
+Additional options:
+- Use Spot Instances for non-critical workloads (subject to interruption)
+- Disable Elastic IP if stable address not required
+
+## Support
+
+For issues or questions:
+- Open an issue on GitLab
+- Contact PostgresAI support
+- Check documentation at https://postgres.ai
+

terraform/aws/.gitignore

@@ -0,0 +1,33 @@
+# Terraform files
+*.tfstate
+*.tfstate.*
+*.tfvars
+!terraform.tfvars.example
+.terraform/
+.terraform.lock.hcl
+crash.log
+override.tf
+override.tf.json
+*_override.tf
+*_override.tf.json
+tfplan
+plan.log
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE files
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Backup files
+*.bak
+*.backup
+
+# SSH keys
+*.pem
+*.key

terraform/aws/QUICKSTART.md

@@ -0,0 +1,97 @@
+# Quick start
+
+## Prerequisites
+
+```bash
+# Create SSH key
+aws ec2 create-key-pair --key-name postgres-ai-key \
+  --query 'KeyMaterial' --output text > ~/.ssh/postgres-ai-key.pem
+chmod 400 ~/.ssh/postgres-ai-key.pem
+
+# Configure AWS credentials
+aws configure
+```
+
+## Configure
+
+```bash
+cd terraform/aws
+
+# Copy example config
+cp terraform.tfvars.example terraform.tfvars
+vim terraform.tfvars
+```
+
+Set required parameters:
+- `ssh_key_name` - your AWS SSH key name
+- `grafana_password` - custom password (optional, defaults to "demo")
+
+## Add monitoring instances
+
+Edit `terraform.tfvars` to add PostgreSQL instances to monitor:
+
+```hcl
+monitoring_instances = [
+  {
+    name        = "prod-db"
+    conn_str    = "postgresql://monitor:pass@db.example.com:5432/postgres"
+    environment = "production"
+    cluster     = "main"
+    node_name   = "primary"
+  }
+]
+```
+
+## Deploy
+
+```bash
+# Validate
+./validate.sh
+
+# Deploy
+terraform init
+terraform plan
+terraform apply
+
+# Get access info
+terraform output grafana_url
+terraform output ssh_command
+```
+
+## Access
+
+```bash
+# Grafana dashboard
+open $(terraform output -raw grafana_url)
+# Login: monitor / demo (or your custom password)
+
+# SSH
+ssh -i ~/.ssh/postgres-ai-key.pem ubuntu@$(terraform output -raw public_ip)
+```
+
+## Operations
+
+```bash
+# View logs
+ssh ubuntu@IP "sudo cat /var/log/user-data.log"
+
+# Restart services
+ssh ubuntu@IP "sudo systemctl restart postgres-ai"
+
+# Destroy
+terraform destroy
+```
+
+## Troubleshooting
+
+```bash
+# Check installation log
+ssh ubuntu@IP "sudo cat /var/log/user-data.log"
+
+# Check service status
+ssh ubuntu@IP "sudo systemctl status postgres-ai"
+
+# Check containers
+ssh ubuntu@IP "sudo docker ps"
+```
+