Mountpoint for Amazon S3 CSI Driver
Overview
The Mountpoint for Amazon S3 Container Storage Interface (CSI) Driver allows your Kubernetes applications to access Amazon S3 objects through a file system interface. Built on Mountpoint for Amazon S3, the Mountpoint CSI driver presents an Amazon S3 bucket as a storage volume accessible by containers in your Kubernetes cluster. The Mountpoint CSI driver implements the CSI specification for container orchestrators (CO) to manage storage volumes.
For Amazon EKS clusters, the Mountpoint for Amazon S3 CSI driver is also available as an EKS add-on to provide automatic installation and management.
Features
- Static Provisioning - Associate an existing S3 bucket with a PersistentVolume (PV) for consumption within Kubernetes.
- Mount Options - Mount options can be specified in the PersistentVolume (PV) resource to define how the volume should be mounted. For Mountpoint-specific options, take a look at the Mountpoint docs for configuration.
Mountpoint for Amazon S3 does not implement all the features of a POSIX file system, and there are some differences that may affect compatibility with your application. See Mountpoint file system behavior for a detailed description of Mountpoint's behavior and POSIX support and how they could affect your application.
Container Images
| Driver Version | ECR Public Image |
v1.6.0 |
public.ecr.aws/mountpoint-s3-csi-driver/aws-mountpoint-s3-csi-driver:v1.6.0 |
Previous Images
Driver Version |
ECR Public Image |
v1.5.1 |
public.ecr.aws/mountpoint-s3-csi-driver/aws-mountpoint-s3-csi-driver:v1.5.1 |
v1.4.0 |
public.ecr.aws/mountpoint-s3-csi-driver/aws-mountpoint-s3-csi-driver:v1.4.0 |
v1.3.1 |
public.ecr.aws/mountpoint-s3-csi-driver/aws-mountpoint-s3-csi-driver:v1.3.1 |
v1.3.0 |
public.ecr.aws/mountpoint-s3-csi-driver/aws-mountpoint-s3-csi-driver:v1.3.0 |
v1.2.0 |
public.ecr.aws/mountpoint-s3-csi-driver/aws-mountpoint-s3-csi-driver:v1.2.0 |
v1.1.0 |
public.ecr.aws/mountpoint-s3-csi-driver/aws-mountpoint-s3-csi-driver:v1.1.0 |
v1.0.0 |
public.ecr.aws/mountpoint-s3-csi-driver/aws-mountpoint-s3-csi-driver:v1.0.0 |
Releases
The Mountpoint for S3 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.
Monthly releases will contain at minimum a MINOR
version bump, even if the content would normally be treated as a PATCH
version.
Support
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 Mountpoint for S3 CSI Driver is compatible with Kubernetes versions v1.23+ and implements the CSI Specification v1.8.0. The driver supports x86-64 and arm64 architectures.
Distros Support Matrix
The following table provides the support status for various distros with regards to CSI Driver version:
Distro |
Experimental |
Stable |
Deprecated |
Removed |
Amazon Linux 2 |
- |
1.0.0 |
- |
- |
Amazon Linux 2023 |
- |
1.0.0 |
- |
- |
Ubuntu 20.04 |
- |
1.0.0 |
- |
- |
Ubuntu 22.04 |
- |
1.0.0 |
- |
- |
Bottlerocket >1.19.2 |
- |
1.4.0 |
- |
- |
Documentation
Contributing
We welcome contributions to the Mountpoint for Amazon S3 CSI driver! Please see CONTRIBUTING.md for more information on how to report bugs or submit pull requests.
Security
If you discover a potential security issue in this project we ask that you notify AWS Security via our vulnerability reporting page. Please do not create a public GitHub issue.
Code of conduct
This project has adopted the Amazon Open Source Code of Conduct. See CODE_OF_CONDUCT.md for more details.