README
¶
Amazon Elastic Block Store (EBS) CSI driver
Overview
The Amazon Elastic Block Store Container Storage Interface (CSI) Driver provides a CSI interface used by Container Orchestrators to manage the lifecycle of Amazon EBS volumes.
Features
- Static Provisioning - Associate an externally-created EBS volume with a PersistentVolume (PV) for consumption within Kubernetes.
- Dynamic Provisioning - Automatically create EBS volumes and associated PersistentVolumes (PV) from PersistentVolumeClaims (PVC). Parameters can be passed via a StorageClass for fine-grained control over volume creation.
- Mount Options - Mount options could be specified in the PersistentVolume (PV) resource to define how the volume should be mounted.
- NVMe Volumes - Consume NVMe volumes from EC2 Nitro instances.
- Block Volumes - Consume an EBS volume as a raw block device.
- Volume Snapshots - Create and restore snapshots taken from a volume in Kubernetes.
- Volume Resizing - Expand the volume size by specifying a new size in the PersistentVolumeClaim (PVC).
Container Images
| Driver Version | GCR Image | ECR Image |
|---|---|---|
| v1.15.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.15.0 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.15.0 |
Previous Images
| Driver Version | GCR Image | ECR Image |
|---|---|---|
| v1.14.1 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.14.1 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.14.1 |
| v1.14.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.14.0 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.14.0 |
| v1.13.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.13.0 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.13.0 |
| v1.12.1 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.12.1 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.12.1 |
| v1.12.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.12.0 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.12.0 |
| v1.11.5 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.11.5 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.11.5 |
| v1.11.4 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.11.4 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.11.4 |
| v1.11.3 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.11.3 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.11.3 |
| v1.11.2 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.11.2 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.11.2 |
| v1.10.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.10.0 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.10.0 |
| v1.9.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.9.0 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.9.0 |
| v1.8.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.8.0 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.8.0 |
| v1.7.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.7.0 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.7.0 |
| v1.6.2 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.6.2 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.6.2 |
| v1.6.1 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.6.1 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.6.1 |
| v1.6.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.6.0 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.6.0 |
| v1.5.3 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.5.3 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.5.3 |
| v1.5.2 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.5.2 | |
| v1.5.1 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.5.1 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.5.1 |
| v1.5.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.5.0 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.5.0 |
| v1.4.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.4.0 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.4.0 |
| v1.3.1 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.3.1 | public.ecr.aws/ebs-csi-driver/aws-ebs-csi-driver:v1.3.1 |
| v1.3.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.3.0 | 602401143452.dkr.ecr.us-west-2.amazonaws.com/eks/aws-ebs-csi-driver:v1.3.0 |
| v1.2.1 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.2.1 | 602401143452.dkr.ecr.us-west-2.amazonaws.com/eks/aws-ebs-csi-driver:v1.2.1 |
| v1.2.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.2.0 | 602401143452.dkr.ecr.us-west-2.amazonaws.com/eks/aws-ebs-csi-driver:v1.2.0 |
| v1.1.4 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.1.4 | 602401143452.dkr.ecr.us-west-2.amazonaws.com/eks/aws-ebs-csi-driver:v1.1.4 |
| v1.1.3 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.1.3 | 602401143452.dkr.ecr.us-west-2.amazonaws.com/eks/aws-ebs-csi-driver:v1.1.3 |
| v1.1.2 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.1.2 | 602401143452.dkr.ecr.us-west-2.amazonaws.com/eks/aws-ebs-csi-driver:v1.1.2 |
| v1.1.1 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.1.1 | 602401143452.dkr.ecr.us-west-2.amazonaws.com/eks/aws-ebs-csi-driver:v1.1.1 |
| v1.1.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.1.0 | 602401143452.dkr.ecr.us-west-2.amazonaws.com/eks/aws-ebs-csi-driver:v1.1.0 |
| v1.0.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v1.0.0 | |
| v0.10.1 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v0.10.1 | 602401143452.dkr.ecr.us-west-2.amazonaws.com/eks/aws-ebs-csi-driver:v0.10.1 |
| v0.10.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v0.10.0 | |
| v0.9.1 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v0.9.1 | |
| v0.9.0 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v0.9.0 | 602401143452.dkr.ecr.us-west-2.amazonaws.com/eks/aws-ebs-csi-driver:v0.9.0 |
| v0.8.1 | k8s.gcr.io/provider-aws/aws-ebs-csi-driver:v0.8.1 | |
| v0.7.1 | amazon/aws-ebs-csi-driver:v0.7.1 | |
| v0.6.0 | amazon/aws-ebs-csi-driver:v0.6.0 | |
| v0.5.0 | amazon/aws-ebs-csi-driver:v0.5.0 | |
| v0.4.0 | amazon/aws-ebs-csi-driver:v0.4.0 | |
| v0.3.0 | amazon/aws-ebs-csi-driver:v0.3.0 | |
| v0.2.0 | amazon/aws-ebs-csi-driver:0.2.0 | |
| v0.1.0 | amazon/aws-ebs-csi-driver:0.1.0-alpha |
Note: If your cluster isn't in the us-west-2 Region, please change 602401143452.dkr.ecr.us-west-2.amazonaws.com to the address that corresponds to your Region.
Releases
The EBS CSI Driver publishes monthly releases. Unscheduled releases may be published for patches to security vulnerabilities and other fixes deemed urgent.
The EBS CSI Driver follows semantic versioning. The version will be bumped following the rules below:
- Significant breaking changes will be released as a
MAJORupdate. - New features will be released as a
MINORupdate. - Bug or vulnerability fixes will be released as a
PATCHupdate.
Monthly releases will contain at minimum a MINOR version bump, even if the content would normally be treated as a PATCH version.
Support
EBS CSI Driver container images are officially hosted in ECR and GCR.
Support will be provided for the latest version and one prior version. Bugs or vulnerabilities found in the latest version will be backported to the previous release in a new minor version.
This policy is non-binding and subject to change.
Compatibility
The EBS CSI Driver is compatible with Kubernetes versions v1.17+ and implements the CSI Specification v1.1.0.
Documentation
Directories
Click to show internal directories.
Click to hide internal directories.