Skip to content

awslabs/mountpoint-s3-csi-driver

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.