How kubernetes-sigs/aws-efs-csi-driver works
The Amazon EFS CSI Driver exposes Kubernetes CSI identity, controller, and node services for EFS and S3 Files persistent volumes. The main workflow is a Kubernetes volume request handled by the controller, which provisions or resolves filesystem access, followed by node publication that mounts the volume into a pod. The driver also supplies cloud metadata, mount-helper/watchdog behavior, and optional Prometheus metrics. Some subsystem links are documented by the README; unsampled implementation details are not assumed.
Main entry points: driver.go CSI server · controller.go Controller service · metadata.go Metadata selection · cloud.go AWS cloud client
Components 18
CSI runtime
- Process startup
cmd/main.go - CSI server
pkg/driver/driver.go - Identity service
pkg/driver/identity.go
Volume provisioning
- Controller service
pkg/driver/controller.go - Filesystem ID lookup
pkg/driver/filesystem_id_finder.go - GID allocation
pkg/driver/gid_allocator.go
Node mounting
- Node service
pkg/driver/node.go - Node mounter
pkg/driver/mounter.go - Mount watchdog
pkg/driver/efs_watch_dog.go
Cloud and observability
- AWS cloud client
pkg/cloud/cloud.go - Metadata selection
pkg/cloud/metadata.go - EC2 metadata
pkg/cloud/ec2_metadata.go - Kubernetes metadata
pkg/cloud/k8s_metadata.go - ECS task metadata
pkg/cloud/task_metadata.go - Metrics endpoint
pkg/metrics/metrics.go - AWS API instrumentation
pkg/cloud/handlers.go
Other components
- Kubernetes / kubelet
- EFS / S3 Files APIs
Connections 22
- Kubernetes / kubelet → Process startup: starts driver
- Process startup → CSI server: starts server
cmd/main.go - CSI server → Identity service: registers service
pkg/driver/driver.go - CSI server → Controller service: registers service
pkg/driver/driver.go - CSI server → Node service: registers service
pkg/driver/driver.go - Kubernetes / kubelet → Controller service: requests volumes
- Controller service → AWS cloud client: provisions access points
pkg/driver/controller.go - Controller service → Node mounter: mounts filesystem
pkg/driver/controller.go - AWS cloud client → EFS / S3 Files APIs: calls APIs
pkg/cloud/cloud.go - Kubernetes / kubelet → Node service: publishes volume
- Node service → Node mounter: mounts volume
- CSI server → AWS cloud client: creates client
pkg/driver/driver.go - CSI server → Mount watchdog: starts watchdog
pkg/driver/driver.go - AWS cloud client → Metadata selection: selects metadata
pkg/cloud/cloud.go - Metadata selection → EC2 metadata: checks IMDS
pkg/cloud/metadata.go - Metadata selection → Kubernetes metadata: selects fallback
pkg/cloud/metadata.go - Metadata selection → ECS task metadata: selects ECS
pkg/cloud/metadata.go - ECS task metadata → Kubernetes / kubelet: requests task data
pkg/cloud/task_metadata.go - Process startup → Metrics endpoint: initializes endpoint
cmd/main.go - AWS API instrumentation → Metrics endpoint: records API calls
pkg/cloud/handlers.go - Controller service → Filesystem ID lookup: resolves filesystem
- Controller service → GID allocation: allocates GID