2019-04-25 19:12:36 +00:00
|
|
|
# Ceph CSI
|
2018-01-20 20:04:38 +00:00
|
|
|
|
2019-04-04 06:49:06 +00:00
|
|
|
[![Go Report
|
|
|
|
Card](https://goreportcard.com/badge/github.com/ceph/ceph-csi)](https://goreportcard.com/report/github.com/ceph/ceph-csi)
|
|
|
|
[![Build
|
|
|
|
Status](https://travis-ci.org/ceph/ceph-csi.svg?branch=master)](https://travis-ci.org/ceph/ceph-csi)
|
|
|
|
|
2019-07-30 14:20:22 +00:00
|
|
|
- [Ceph CSI](#ceph-csi)
|
|
|
|
- [Overview](#overview)
|
|
|
|
- [Project status](#project-status)
|
|
|
|
- [Supported CO platforms](#supported-co-platforms)
|
|
|
|
- [Support Matrix](#support-matrix)
|
|
|
|
- [Ceph-CSI features and available versions](#ceph-csi-features-and-available-versions)
|
|
|
|
- [CSI spec and Kubernetes version compatibility](#csi-spec-and-kubernetes-version-compatibility)
|
|
|
|
- [Contributing to this repo](#contributing-to-this-repo)
|
|
|
|
- [Troubleshooting](#troubleshooting)
|
|
|
|
- [Weekly Bug Triage call](#weekly-bug-triage-call)
|
|
|
|
- [Contact](#contact)
|
2019-07-12 07:32:44 +00:00
|
|
|
|
2019-07-22 14:38:43 +00:00
|
|
|
This repo contains Ceph
|
2019-07-22 21:50:36 +00:00
|
|
|
[Container Storage Interface (CSI)](https://github.com/container-storage-interface/)
|
|
|
|
driver for RBD, CephFS and kubernetes sidecar deployment yamls of provisioner,
|
|
|
|
attacher, node-driver-registrar and snapshotter for supporting CSI functionalities.
|
2018-02-06 18:30:05 +00:00
|
|
|
|
2018-07-31 09:31:12 +00:00
|
|
|
## Overview
|
2018-03-26 13:02:34 +00:00
|
|
|
|
2019-04-25 19:12:36 +00:00
|
|
|
Ceph CSI plugins implement an interface between CSI enabled Container Orchestrator
|
|
|
|
(CO) and Ceph cluster. It allows dynamically provisioning Ceph volumes and
|
|
|
|
attaching them to workloads.
|
2018-03-26 13:02:34 +00:00
|
|
|
|
2019-04-25 19:12:36 +00:00
|
|
|
Independent CSI plugins are provided to support RBD and CephFS backed volumes,
|
2018-03-26 13:02:34 +00:00
|
|
|
|
2019-06-10 08:37:24 +00:00
|
|
|
- For details about configuration and deployment of RBD plugin, please refer
|
|
|
|
[rbd doc](https://github.com/ceph/ceph-csi/blob/master/docs/deploy-rbd.md) and
|
|
|
|
for CephFS plugin configuration and deployment please
|
|
|
|
refer [cephfs doc](https://github.com/ceph/ceph-csi/blob/master/docs/deploy-cephfs.md).
|
2019-04-25 19:12:36 +00:00
|
|
|
- For example usage of RBD and CephFS CSI plugins, see examples in `examples/`.
|
|
|
|
|
|
|
|
## Project status
|
|
|
|
|
2019-07-12 07:32:44 +00:00
|
|
|
Status: **GA**
|
2019-04-25 19:12:36 +00:00
|
|
|
|
|
|
|
## Supported CO platforms
|
|
|
|
|
|
|
|
Ceph CSI drivers are currently developed and tested **exclusively** on Kubernetes
|
|
|
|
environments. There is work in progress to make this CO independent and thus
|
|
|
|
support other orchestration environments in the future.
|
|
|
|
|
2019-07-12 07:32:44 +00:00
|
|
|
NOTE:
|
2019-04-25 19:12:36 +00:00
|
|
|
|
2019-07-12 07:32:44 +00:00
|
|
|
- **`csiv0.3`** is deprecated with release of **`csi v1.1.0`**
|
2018-01-20 20:04:38 +00:00
|
|
|
|
2019-05-08 08:18:53 +00:00
|
|
|
## Support Matrix
|
|
|
|
|
|
|
|
### Ceph-CSI features and available versions
|
|
|
|
|
2019-07-12 07:32:44 +00:00
|
|
|
| Plugin | Features | Feature Status | CSI Driver Version | CSI Spec Version | Ceph Cluster Version | Kubernetes Version |
|
2019-07-30 14:20:22 +00:00
|
|
|
| ------ | --------------------------------------------------------- | -------------- | ------------------ | ---------------- | -------------------- | ------------------ |
|
|
|
|
| RBD | Dynamically provision, de-provision Block mode RWO volume | GA | >=v1.0.0 | >=v1.0.0 | >= Mimic | >= v1.13.0 |
|
|
|
|
| | Dynamically provision, de-provision Block mode RWX volume | GA | >=v1.0.0 | >=v1.0.0 | >= Mimic | >= v1.13.0 |
|
|
|
|
| | Dynamically provision, de-provision File mode RWO volume | GA | >=v1.0.0 | >=v1.0.0 | >= Mimic | >= v1.13.0 |
|
|
|
|
| | Creating and deleting snapshot | Alpha | >=v1.0.0 | >=v1.0.0 | >= Mimic | >= v1.13.0 |
|
|
|
|
| | Provision volume from snapshot | Alpha | >=v1.0.0 | >=v1.0.0 | >= Mimic | >= v1.13.0 |
|
2019-07-12 07:32:44 +00:00
|
|
|
| | Provision volume from another volume | - | - | - | - | - |
|
|
|
|
| | Resize volume | - | - | - | - | - |
|
|
|
|
| | Metrics Support | - | - | - | - | - |
|
2019-08-06 13:56:17 +00:00
|
|
|
| CephFS | Dynamically provision, de-provision File mode RWO volume | Alpha | >=v1.1.0 | >=v1.0.0 | Nautilus (>=14.2.2) | >=v1.13.0 |
|
|
|
|
| | Dynamically provision, de-provision File mode RWX volume | Alpha | >=v1.1.0 | >=v1.0.0 | Nautilus (>=v14.2.2) | >=v1.13.0 |
|
2019-07-12 07:32:44 +00:00
|
|
|
| | Creating and deleting snapshot | - | - | - | - | - |
|
|
|
|
| | Provision volume from snapshot | - | - | - | - | - |
|
|
|
|
| | Provision volume from another volume | - | - | - | - | - |
|
|
|
|
| | Resize volume | - | - | - | - | - |
|
|
|
|
| | Metrics | - | - | - | - | - |
|
|
|
|
|
|
|
|
`NOTE`: The `Alpha` status reflects possible non-backward
|
|
|
|
compatible changes in the future, and is thus not recommended
|
|
|
|
for production use.
|
2019-05-08 08:18:53 +00:00
|
|
|
|
|
|
|
### CSI spec and Kubernetes version compatibility
|
|
|
|
|
|
|
|
Please refer to the [matrix](https://kubernetes-csi.github.io/docs/#kubernetes-releases)
|
|
|
|
in the Kubernetes documentation.
|
|
|
|
|
2019-04-04 06:43:48 +00:00
|
|
|
## Contributing to this repo
|
|
|
|
|
2019-07-24 13:05:03 +00:00
|
|
|
Please follow [development-guide](<https://github.com/ceph/ceph-csi/tree/master/docs/development-guide.md>)
|
|
|
|
and [coding style guidelines](<https://github.com/ceph/ceph-csi/tree/master/docs/coding.md>)
|
2019-04-04 06:43:48 +00:00
|
|
|
if you are interested to contribute to this repo.
|
|
|
|
|
2018-01-20 20:04:38 +00:00
|
|
|
## Troubleshooting
|
|
|
|
|
2018-07-31 09:31:12 +00:00
|
|
|
Please submit an issue at: [Issues](https://github.com/ceph/ceph-csi/issues)
|
2019-02-11 14:07:22 +00:00
|
|
|
|
2019-07-25 12:45:07 +00:00
|
|
|
## Weekly Bug Triage call
|
|
|
|
|
|
|
|
We conduct weekly bug triage calls at our slack channel on Tuesdays.
|
|
|
|
More details are available [here](https://github.com/ceph/ceph-csi/issues/463)
|
|
|
|
|
2019-05-28 07:13:10 +00:00
|
|
|
## Contact
|
2019-02-11 14:07:22 +00:00
|
|
|
|
2019-05-28 07:13:10 +00:00
|
|
|
Please use the following to reach members of the community:
|
|
|
|
|
2019-07-16 13:32:46 +00:00
|
|
|
- Slack: Join our [slack channel](https://cephcsi.slack.com) to discuss
|
|
|
|
about anything related to this project. You can join the slack by
|
2019-07-25 11:38:00 +00:00
|
|
|
this [invite link](https://bit.ly/2MeS4KY )
|
2019-05-28 07:13:10 +00:00
|
|
|
- Forums: [ceph-csi](https://groups.google.com/forum/#!forum/ceph-csi)
|
|
|
|
- Twitter: [@CephCsi](https://twitter.com/CephCsi)
|