Skip to content

openshift/aws-ebs-csi-driver

Repository files navigation

Amazon Elastic Block Store (EBS) CSI driver

GitHub release (latest SemVer) Coverage Status Go Report Card

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.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
Previous Images
Driver Version GCR Image ECR Image
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 and bi-weekly Helm chart releases. Security vulnerabilities will be addressed as soon as possible.

The EBS CSI Driver follows semantic versioning. The version will be bumped following the rules below:

  • Significant breaking changes will be released as a MAJOR update.
  • New features will be released as a MINOR update.
  • Bug or vulnerability fixes will be released as a PATCH update.

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.

Kubernetes Compatibility Matrix

AWS EBS CSI Driver / Kubernetes Version v1.12 v1.13 v1.14 v1.15 v1.16 v1.17 v1.18+
master branch no no no no no yes yes
v0.9.x-v1.12.x no no no no no yes yes
v0.5.0-v0.8.x no no yes yes yes yes yes
v0.4.0 no no yes yes no no no
v0.3.0 no no yes no no no no
v0.2.0 no yes yes no no no no
v0.1.0 yes yes yes no no no no

CSI Specification Compatibility Matrix

AWS EBS CSI Driver / CSI Version v0.3.0 v1.0.0 v1.1.0
master branch no no yes
v0.4.0-v1.12.x no no yes
v0.2.0-v0.3.0 no yes no
v0.1.0 yes no no

Documentation

Packages

No packages published

Languages

  • Go 88.8%
  • Shell 7.9%
  • Smarty 1.9%
  • Other 1.4%