Easily manage Amazon EKS clusters and workloads with CloudPilot AI's automation and cost optimization. This provider enables seamless integration of CloudPilot AI's agent, workload rebalancing, and node pool management into your Terraform workflow.
- Provision and manage EKS clusters with CloudPilot AI integration
- Automated agent and rebalance component installation
- Node pool and node class management (including custom Karpenter JSON)
- Workload cost optimization (rebalance, spot-friendly, min non-spot replicas)
- Seamless AWS CLI and kubeconfig integration
- Terraform - Version 1.0 or later
- AWS CLI — Install and configure the AWS CLI with credentials that have EKS cluster management permissions. Required for EKS-related operations such as updating kubeconfig. If you haven't created an EKS cluster yet, see the example setup: eks-ondemand
- Important: Even if you provide a
kubeconfigpath, AWS CLI permissions are still required. The kubeconfig parameter only prevents the provider from generating a new kubeconfig file; all kubectl operations still require proper AWS credentials. - Multi-account setup: If your AWS CLI is configured with multiple accounts/profiles, ensure you switch to the correct account that matches your EKS cluster before running Terraform commands.
- Important: Even if you provide a
- Kubectl - For cluster operations and component management
- CloudPilot AI API key - See CloudPilot AI API Key Documentation for setup instructions
See the examples/eks/ directory for EKS configurations, ordered from minimal to full-featured.
| Example | Description | Use Case |
|---|---|---|
0_minimal |
Minimal setup with Node Autoscaler and Workload Autoscaler | Quick start: installs both autoscalers, enables optimization for cloudpilot namespace, no rebalance |
1_details |
Full-featured reference with all options | Production setup with workload templates, nodeclasses, nodepools, Workload Autoscaler, and data sources |
2_read-only_access |
Agent-only installation | Testing or monitoring without any optimization changes |
3_basic_rebalance |
Basic rebalance configuration | Simple cost optimization with rebalancing |
4_nodeclass_nodepool_rebalance |
Custom nodeclass and nodepool | Advanced node management with instance filtering and disruption controls |
5_import |
Import existing resources | Bring existing CloudPilot AI-managed clusters into Terraform state without recreating them |
Each example folder contains:
main.tf— resource definitionsvariables.tf— variable declarationsterraform.tfvars.example— sample variable values (copy toterraform.tfvarsto use)README.md— usage instructions
Note: Never call CloudPilot API endpoints directly; always use the Client struct in pkg/cloudpilot-ai/client/.