HeliosDB Deployment Quick Reference

HeliosDB Deployment Quick Reference

One-Line Deployments

# Rolling deployment (default)
./scripts/deploy/deploy.sh --environment production --version 7.0.1

# Blue-green deployment
./scripts/deploy/deploy.sh --environment production --version 7.0.1 --strategy blue-green

# Canary deployment
./scripts/deploy/deploy.sh --environment production --version 7.0.1 --strategy canary

# Dry run
./scripts/deploy/deploy.sh --environment production --version 7.0.1 --dry-run

Quick Operations

# Rollback
./scripts/deploy/rollback.sh --environment production

# Health check
./scripts/deploy/health-check.sh --namespace heliosdb

# Scale
./scripts/deploy/scale.sh --replicas 7

# Enable autoscaling
./scripts/deploy/scale.sh --enable-hpa --min 5 --max 15 --cpu-target 70

Infrastructure Setup

# Deploy infrastructure
cd infrastructure/terraform
terraform init
terraform apply -var-file="environments/production.tfvars"

# Configure kubectl
aws eks update-kubeconfig --name heliosdb-production-cluster --region us-west-2

# Verify
kubectl cluster-info
kubectl get nodes

File Locations

Infrastructure

• Terraform: /home/claude/HeliosDB/infrastructure/terraform/
• Modules: /home/claude/HeliosDB/infrastructure/terraform/modules/

Deployment

• Scripts: /home/claude/HeliosDB/scripts/deploy/
• Helm Chart: /home/claude/HeliosDB/helm/heliosdb-prod/
• K8s Manifests: /home/claude/HeliosDB/k8s/production/

Automation

• GitHub Actions: /home/claude/HeliosDB/.github/workflows/

Documentation

• Deployment Guides: /home/claude/HeliosDB/docs/deployment/
• Infrastructure README: /home/claude/HeliosDB/infrastructure/README.md
• Summary: /home/claude/HeliosDB/DEPLOYMENT_INFRASTRUCTURE_SUMMARY.md

Key Scripts

Script	Purpose	Location
deploy.sh	Main deployment (3 strategies)	/scripts/deploy/
rollback.sh	Rollback to previous version	/scripts/deploy/
health-check.sh	Comprehensive health checks	/scripts/deploy/
scale.sh	Scaling operations	/scripts/deploy/

Terraform Modules

Module	Purpose	Files
vpc	Multi-AZ VPC	main.tf, variables.tf, outputs.tf
eks	Kubernetes cluster	main.tf, variables.tf, outputs.tf, user-data.sh
rds	PostgreSQL 17	main.tf, variables.tf, outputs.tf
elasticache	Redis 7.1	main.tf, variables.tf, outputs.tf
s3	Buckets (backup/logs)	main.tf, variables.tf, outputs.tf
iam	IRSA roles	main.tf, variables.tf, outputs.tf
route53	DNS	main.tf, variables.tf, outputs.tf
monitoring	CloudWatch	main.tf, variables.tf, outputs.tf
security-groups	Network ACLs	main.tf, variables.tf, outputs.tf

Deployment Strategies

Strategy	Use Case	Resources	Rollback
Rolling	Minor updates	No extra	Automatic
Blue-Green	Major updates	2x temp	Instant
Canary	Risky changes	+1 replica	Any phase

Health Check Endpoints

• PostgreSQL: <endpoint>:5432
• MySQL: <endpoint>:3306
• HTTP API: https://<endpoint>:8443/health
• Metrics: http://<endpoint>:9090/metrics

Monitoring

# Prometheus
kubectl port-forward -n monitoring svc/prometheus-server 9090:80

# Grafana
kubectl port-forward -n monitoring svc/prometheus-grafana 3000:80

# Metrics
kubectl top pods -n heliosdb
kubectl top nodes

Common Issues

# Pods not ready
kubectl get pods -n heliosdb
kubectl logs -n heliosdb <pod-name>
kubectl describe pod -n heliosdb <pod-name>

# Service unreachable
kubectl get svc,endpoints -n heliosdb
kubectl get ingress -n heliosdb

# Resource issues
kubectl top pods -n heliosdb
./scripts/deploy/scale.sh --replicas 7

Production Checklist

• Customize Terraform variables in environments/production.tfvars
• Deploy infrastructure: terraform apply
• Configure kubectl with cluster
• Test in staging first
• Review deployment strategy
• Configure monitoring alerts
• Set up notifications (Slack/PagerDuty)
• Train operations team
• Document runbooks
• Deploy to production

Support

• Docs: /docs/deployment/
• Infrastructure: /infrastructure/terraform/
• Scripts: /scripts/deploy/
• Ops: ops-oncall@example.com
• Slack: #heliosdb-ops