How eksctl-io/eksctl works
eksctl is a Go CLI for provisioning and managing Amazon EKS clusters and related resources. Its main workflow starts with a user command, proceeds through CLI command handling and cluster configuration, then uses EKS and CloudFormation-facing components to create or change AWS resources; cluster credentials are written to kubeconfig. The repository also has distinct capabilities for nodegroups, addons, Auto Mode, identity, and Kubernetes controllers. Edges are limited to relationships shown in the README or sampled source index/excerpts; several feature internals were not sampled.
Main entry points: ctl Command handlers · manager Stack lifecycle · cluster Cluster actions · tasks.go EKS task orchestration
Components 21
CLI and configuration
- Command router
cmd/eksctl/main.go - Command handlers
pkg/ctl - Cluster API config
pkg/apis/eksctl.io/v1alpha5
Cluster provisioning
- Cluster actions
pkg/actions/cluster - EKS task orchestration
pkg/eks/tasks.go - Version resolution
pkg/eks/versions_manager.go - Stack templates
pkg/cfn/builder - Stack lifecycle
pkg/cfn/manager - Nodegroup management
pkg/actions/nodegroup
Cluster features
- Addon management
pkg/actions/addon - Addon task orchestration
pkg/actions/addon/tasks.go - Auto Mode roles
pkg/automode/cluster_role_manager.go - Identity features
pkg/actions - Access entries
pkg/actions/accessentry - Pod identity
pkg/actions/podidentityassociation/tasks.go - VPC controller
pkg/addons/vpc_controller.go
Cloud and Kubernetes
- AWS services
- CloudFormation
- Kubernetes API
- Cluster credentials
Other components
- CLI user
Connections 27
- CLI user → Command router: runs command
cmd/eksctl/main.go - Command router → Command handlers: routes commands
cmd/eksctl/main.go - CLI user → Cluster actions: requests cluster
README.md - Command handlers → Cluster API config: loads config
pkg/ctl/utils/install_vpc_controllers.go - Command handlers → Cluster actions: invokes actions
- Cluster actions → EKS task orchestration: orchestrates tasks
- EKS task orchestration → Version resolution: resolves versions
pkg/eks/tasks.go - EKS task orchestration → Stack lifecycle: manages stacks
pkg/eks/tasks.go - Stack lifecycle → Stack templates: uses templates
pkg/cfn/manager/create_tasks.go - Stack templates → CloudFormation: defines resources
README.md - Stack lifecycle → CloudFormation: creates stacks
README.md - EKS task orchestration → AWS services: calls EKS APIs
- Cluster actions → Nodegroup management: manages nodegroups
- Command handlers → Addon management: routes addon commands
- Addon management → Addon task orchestration: orchestrates tasks
pkg/actions/addon/tasks.go - Addon task orchestration → Stack lifecycle: manages stacks
pkg/actions/addon/tasks.go - Command handlers → Identity features: routes identity commands
pkg/ctl/create/iamserviceaccount.go - Identity features → Access entries: manages access entries
- Identity features → Pod identity: manages pod identity
- Pod identity → Stack lifecycle: manages stacks
pkg/actions/podidentityassociation/tasks.go - Command handlers → Auto Mode roles: routes Auto Mode
- Auto Mode roles → Stack lifecycle: reads stack template
pkg/automode/cluster_role_manager.go - Auto Mode roles → AWS services: updates IAM roles
pkg/automode/cluster_role_manager.go - Command handlers → VPC controller: installs controller
pkg/ctl/utils/install_vpc_controllers.go - VPC controller → Kubernetes API: updates resources
pkg/addons/vpc_controller.go - Cluster actions → Cluster credentials: writes credentials
README.md - Stack lifecycle → AWS services: provisions resources
README.md