Documentation Index
Fetch the complete documentation index at: https://qovery-erebe-skills.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Qovery integrates with Amazon Elastic Kubernetes Service (EKS) to provide managed Kubernetes deployments on AWS. Choose between Qovery-managed EKS (fully automated) or BYOK (bring your existing EKS cluster).Deployment Options
Qovery-Managed EKS
Zero ConfigurationQovery creates and manages your EKS cluster in your AWS account. Automated setup, updates, and scaling.✅ Full automation
✅ 15-30 minute setup
✅ Best practices built-in
✅ Auto-scaling with Karpenter
✅ Spot instance support
✅ Graviton (ARM) support
Bring Your Own EKS (BYOK)
Full ControlConnect your existing EKS cluster to Qovery. You manage the cluster, Qovery manages deployments.✅ Use existing clusters
✅ Custom configurations
✅ Compliance requirements
✅ Multi-tenant setups
✅ Your cluster upgrade schedule
Features
- Qovery-Managed
- BYOK
What Qovery Creates:
- EKS cluster (latest stable version)
- VPC with public/private subnets
- NAT Gateways for outbound traffic
- Security groups and network ACLs
- IAM roles and policies
- Karpenter for auto-scaling
- AWS Load Balancer Controller
- EBS CSI driver for volumes
- Cluster autoscaler
- Metrics server
- Karpenter for intelligent node provisioning
- Supports On-Demand and Spot instances
- Automatically right-sizes nodes
- Fast scale-up (< 1 minute)
- Cost-optimized instance selection
- VPC with /16 CIDR
- Public subnets for load balancers
- Private subnets for pods
- NAT Gateways for internet access
- VPC endpoints for AWS services
- Network policies support
- Private EKS endpoint option
- Encryption at rest (EBS volumes)
- Secrets encryption with KMS
- IAM for service accounts (IRSA)
- Pod security policies
- Network policies
Supported Configurations
Instance Types
- General Purpose
- Compute Optimized
- Memory Optimized
- Spot Instances
T3/T3a (Burstable):
- t3.medium, t3.large, t3.xlarge
- Best for: Development, staging
- Cost: $
- m5.large, m5.xlarge, m5.2xlarge
- Best for: Production workloads
- Cost: $$
- m6g.large, m6g.xlarge, m7g.large
- Best for: Cost-optimized production
- Cost: $$ (20% cheaper than Intel)
Kubernetes Versions
| Version | Status | Support End |
|---|---|---|
| 1.29 | ✅ Recommended | Jan 2025 |
| 1.28 | ✅ Supported | Nov 2024 |
| 1.27 | ✅ Supported | Jul 2024 |
| 1.26 | ⚠️ End of life soon | May 2024 |
| 1.25 | ❌ End of life | Feb 2024 |
Regions
All AWS regions supported:- US East: us-east-1, us-east-2
- US West: us-west-1, us-west-2
- Europe: eu-west-1, eu-west-2, eu-west-3, eu-central-1, eu-north-1
- Asia Pacific: ap-southeast-1, ap-southeast-2, ap-northeast-1, ap-northeast-2, ap-south-1
- Others: ca-central-1, sa-east-1, af-south-1, me-south-1
Cost Breakdown
Qovery-Managed EKS
EKS Control Plane: 73/month)- Managed by AWS
- Highly available across 3 AZs
- Automatic version upgrades
- Backed by AWS SLA
- Instance cost: 0.288/hour (~$210/month)
- EBS volumes: ~$10/month
- Data transfer: ~$10-50/month
- NAT Gateway: 100/month
- Load Balancer: ~$20/month
- Use Spot instances (60-90% discount)
- Use Graviton instances (20% cheaper)
- Right-size instances with Karpenter
- Use single NAT Gateway for dev/staging
- Reserved instances for predictable workloads
BYOK
Your Costs:- EKS control plane: ~$73/month
- Worker nodes: Based on your configuration
- Networking: Your VPC and load balancers
- Storage: Your EBS volumes
- Included in Qovery subscription
- No additional cluster management fees
Setup Time
| Step | Qovery-Managed | BYOK |
|---|---|---|
| AWS Account Setup | 5 minutes | N/A |
| Cluster Creation | 20-30 minutes | Existing cluster |
| Qovery Agent Installation | Automatic | 10 minutes |
| First Deployment | 5 minutes | 5 minutes |
| Total | ~40 minutes | ~15 minutes |
Security Features
Network Security
Network Security
Private Clusters:
- EKS endpoint in private subnets only
- No public access to Kubernetes API
- Access via VPN or AWS PrivateLink
- Calico network policies
- Pod-to-pod traffic control
- Namespace isolation
- Minimal required access
- Separate SGs for control plane and workers
- Locked down by default
IAM & Access Control
IAM & Access Control
IAM Roles for Service Accounts (IRSA):
- Fine-grained AWS permissions
- No shared credentials
- Automatic credential rotation
- Kubernetes RBAC enabled
- Namespace-level access control
- Integration with AWS IAM
- EKS control plane logging
- CloudWatch Logs integration
- API audit logs
Data Encryption
Data Encryption
At Rest:
- EBS volume encryption with KMS
- Secrets encryption with KMS
- Custom KMS keys supported
- TLS for all communication
- Pod-to-pod encryption option
- HTTPS load balancers
- Kubernetes secrets encryption
- AWS Secrets Manager integration
- External Secrets Operator support
Compliance
Compliance
Certifications:
- SOC 2
- ISO 27001
- HIPAA eligible
- PCI DSS
- Audit logs
- Encryption at rest and in transit
- Private clusters
- VPC isolation
Integrations
AWS Services
RDS Databases
- Automatic RDS provisioning
- PostgreSQL, MySQL, MariaDB
- Multi-AZ for high availability
- Automated backups
S3 Storage
- Bucket creation and management
- IAM role for pod access
- Lifecycle policies
- Versioning and replication
Route 53 DNS
- Automatic DNS record creation
- SSL certificate automation
- Health checks
- Failover routing
ECR Registry
- Private container registry
- Image scanning
- Lifecycle policies
- Cross-region replication
Third-Party Tools
- Datadog: Monitoring and APM
- External Secrets: Secrets management
- Cert-Manager: SSL certificates
- ArgoCD: GitOps deployments
Best Practices
High Availability
- Use multiple node pools
- Spread across 3+ AZs
- Mix of On-Demand and Spot
- Pod disruption budgets
Cost Optimization
- Use Spot instances (60-90% off)
- Graviton instances (20% off)
- Auto-scaling with Karpenter
- Right-size node instances
Security
- Private EKS endpoint
- Enable audit logging
- Use IRSA for pod permissions
- Network policies
Monitoring
- Enable CloudWatch Container Insights
- Set up CloudWatch alarms
- Use Qovery Observe
- Consider Datadog for production
Troubleshooting
Cluster Creation Failed
Cluster Creation Failed
Common Issues:
- AWS API rate limits
- Insufficient IAM permissions
- VPC CIDR conflicts
- Service quota limits
- Check AWS Service Quotas
- Verify IAM permissions
- Ensure no CIDR conflicts
- Contact AWS support for quota increases
Pods Not Starting
Pods Not Starting
Common Issues:
- Insufficient node capacity
- Image pull errors
- Resource limits too high
- Node not ready
- Check node autoscaling
- Verify ECR/registry access
- Review resource requests/limits
- Check node status with kubectl
High AWS Costs
High AWS Costs
Common Causes:
- Multiple NAT Gateways
- Over-provisioned instances
- Only On-Demand instances
- High data transfer
- Use single NAT Gateway for dev/staging
- Enable Spot instances
- Right-size with Karpenter
- Use VPC endpoints for AWS services
Next Steps
Qovery-Managed EKS Setup
Set up automated EKS cluster
BYOK EKS Setup
Connect existing EKS cluster
EKS Anywhere
Deploy EKS on-premise