Jump to: navigation, search

Difference between revisions of "Manila"

 
(43 intermediate revisions by 13 users not shown)
Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
This page documents the concept and vision for establishing a shared file system service for OpenStack.  The development name for this project is Manila.  We propose and are in the process of implementing a new OpenStack service (originally based on Cinder).  Cinder presently functions as the canonical storage provisioning control plane in [[OpenStack]] for block storage as well as delivering a persistence model for instance storage.  The File Share Service prototype, in a similar manner, provides coordinated access to shared or distributed file systems.  While the primary consumption of file shares would be across OpenStack Compute instances, the service is also intended to be accessible as an independent capability in line with the modular design established by other OpenStack services. The design and prototype implementation provide extensibility for multiple backends (to support vendor or file system specific nuances / capabilities) but is intended to be sufficiently abstract to accommodate any of a variety of shared or distributed file system types.  The team's intention is to introduce the capability as an OpenStack incubated project in the Juno timeframe, graduate it and submit for consideration as a core service as early as the as the Kilo release.
+
This page introduces the shared file system service for OpenStack -- ManilaManila derived from the Cinder project and provides a canonical storage provisioning control plane in [[OpenStack]] for shared or distributed file systems similarly to the way Cinder provides such a canonical control plane for block storage.
 +
 
 +
The design and implementation of Manila provide extensibility for multiple backends (to support vendor or file system specific nuances / capabilities) but is sufficiently abstract to accommodate any of a variety of shared or distributed file system types.
  
 
[[File:Shares_Service.png]]
 
[[File:Shares_Service.png]]
  
According to IDC in its “[http://www.idc.com/getdoc.jsp?containerId=235910 Worldwide File-Based Storage 2012-2016 Forecast]", file-based storage continues to be a thriving market, with spending on File-based storage solutions to reach north of $34.6 billion in 2016. Of the 27 Exabyte’s (EB) of total disk capacity estimated to have shipped in 2012, IDC projected that nearly 18 EB were file-based capacity, accounting for over 65% of all disk shipped by capacity. A diversity of applications, from server virtualization to relational or distributed databases to collaborative content creation, often depend on the performance, scalability and simplicity of management associated with file-based systems, and the large ecosystem of supporting software products.  OpenStack, as the leading open IaaS capability, is increasingly contemplated as an option for deploying classic infrastructure in an "as a Service" model, but without specific accommodation for shared file systems represents an incomplete solution.
+
File-based storage continues to be a thriving market.   Diverse applications, from server virtualization to relational or distributed databases to collaborative content creation, can leverage the performance, scalability and simplicity of management associated with file-based systems, and the large ecosystem of supporting software products.   
 +
 
 +
While manila was designed to provide self-service provisioning and access control of file-shares to compute instances in multi-tenant OpenStack clouds, since it serves up storage over the network it can provide file-share infrastructure for clients running in other clouds or for bare-metal, VM hosts or containerized workloads.
  
 
== Projects==
 
== Projects==
Line 12: Line 16:
 
{| border="1" cellpadding="2"
 
{| border="1" cellpadding="2"
 
| Source code
 
| Source code
| https://github.com/stackforge/manila
+
| https://opendev.org/openstack/manila
 
|-
 
|-
 
| Bug tracker
 
| Bug tracker
Line 19: Line 23:
 
| Feature tracker
 
| Feature tracker
 
| https://blueprints.launchpad.net/manila
 
| https://blueprints.launchpad.net/manila
 +
|-
 +
| Documentation
 +
| https://docs.openstack.org/manila/latest/
 
|}
 
|}
  
Line 24: Line 31:
 
{| border="1" cellpadding="2"
 
{| border="1" cellpadding="2"
 
| Source code
 
| Source code
| https://github.com/stackforge/python-manilaclient
+
| https://opendev.org/openstack/python-manilaclient
 
|-
 
|-
 
| Bug tracker
 
| Bug tracker
Line 31: Line 38:
 
| Feature tracker
 
| Feature tracker
 
| https://blueprints.launchpad.net/python-manilaclient
 
| https://blueprints.launchpad.net/python-manilaclient
 +
|-
 +
| Documentation
 +
| https://docs.openstack.org/python-manilaclient/latest/
 +
|}
 +
 +
=== Manila UI Plugin ===
 +
{| border="1" cellpadding="2"
 +
| Source code
 +
| https://opendev.org/openstack/manila-ui
 +
|-
 +
| Bug tracker
 +
| https://bugs.launchpad.net/manila-ui
 +
|-
 +
| Feature tracker
 +
| https://blueprints.launchpad.net/manila-ui
 +
|-
 +
| Documentation
 +
| https://docs.openstack.org/manila-ui/latest/
 +
|}
 +
 +
=== People ===
 +
 +
[https://review.opendev.org/admin/groups/213,members Current Manila Core Team members]<br />
 +
[https://review.opendev.org/admin/groups/3e52870181d207571dd9c17861ea36032d39cf50,members Current Python Manilaclient Core Team members]<br />
 +
[https://review.opendev.org/admin/groups/e7a275c38da7a00717374ec99594754081940a92,members Current Manila Tempest Plugin Core Team members]<br />
 +
[https://review.opendev.org/admin/groups/1d07f67c1a283259992386e0da61c5976fd7d0e8,members Current Manila UI Core Team members]<br />
 +
 +
[https://launchpad.net/~manila-bug-supervisors Launchpad Bug Supervisors]
 +
 +
[[CrossProjectLiaisons|Cross Project Liaisons (CPLs)]]
 +
 +
{| cellpadding=5 style="border:1px solid #BBB" class="wikitable"
 +
|-
 +
! Role !! Person !! IRC Nick
 +
|-
 +
| Project Team Lead || Carlos Eduardo da Silva || carloss
 +
|-
 +
| valign="center" rowspan=8 | Core Reviewers || Goutham Pacha Ravi || gouthamr
 +
|-
 +
|  Douglas Viroel || dviroel
 +
|-
 +
| Thomas Bechtold || toabctl
 +
|-
 +
|  Tom Barron || tbarron
 +
|-
 +
|  Victoria Martinez de la Cruz || vkmc
 +
|-
 +
|-
 +
|  Maari Tamm || maaritamm
 +
|-
 +
|-
 +
|  Vida Haririan || vhari
 +
|-
 +
|-
 +
|  Liron Kuchlani || lkuchlan
 +
|-
 +
| Bug Czar || Vida Haririan || vhari
 
|}
 
|}
 +
 +
† - Core Reviewer(s) in openstack/python-manilaclient
 +
 +
‡ - Core Reviewer(s) in openstack/manila-tempest-plugin
  
 
=== Meetings ===
 
=== Meetings ===
Line 37: Line 105:
 
[[Manila/Meetings|Project Agenda & Meetings]]
 
[[Manila/Meetings|Project Agenda & Meetings]]
  
[[Manila/JunoSummitPresentation|Overview Presentation from Juno (Atlanta) Summit]]
+
=== Documentation ===
  
=== Getting Started with Manila ===
+
* [https://docs.openstack.org/manila/latest/contributor/index.html Contributor Guide]
 +
* [https://docs.openstack.org/manila/latest/install/index.html Installation Guide]
 +
* [https://docs.openstack.org/manila/latest/user/index.html User Guide]
 +
* [https://docs.openstack.org/manila/latest/admin/index.html Administrator Guide]
 +
* [https://developer.openstack.org/api-ref/shared-file-system/ API Reference]
 +
* [https://docs.openstack.org/manila/latest/configuration/index.html Configuration Reference]
 +
* [http://docs.openstack.org/security-guide/shared-file-systems.html Security Guide]
  
Instructions for getting started with Manila using Devstack are available at: [[Manila/IcehouseDevstack|Manila on Devstack]]
+
=== Project Etherpads ===
  
Developer documentation is still in progress, but is available in a draft state: [[Manila/docs|Manila Documentation]]
+
[[Manila/Etherpads|Etherpads]]
  
=== Project Plan & Progress ===
+
== Design & Use Cases ==
 
 
[[Manila/ProjectPlan|Manila Project Plan]]<br />
 
Track progress towards [[Manila/Graduation|Manila Incubation & Graduation]].
 
  
== Design & Use Cases ==
+
The following wiki documents are design specifications. They should not be treated as documentation. Since the Newton release, design specifications are hosted [http://specs.openstack.org/openstack/manila-specs/ here]
  
[[Manila/design|Manila Component Design]]<br />
+
* [[Manila/JunoSummitPresentation|Overview Presentation from Juno (Atlanta) Summit]]
[[Manila/usecases|Manila Use Cases]]
+
* [[Manila/design|Manila Component Design]]
 +
* [[Manila/usecases|Manila Use Cases]]
  
 +
{{Special:PrefixIndex/:Manila/design|hideredirects=1 }}
  
 
== Known issues ==
 
== Known issues ==
Line 62: Line 135:
 
== Subpages ==
 
== Subpages ==
  
{{Special:PrefixIndex/:Manila/}}
+
{{Special:PrefixIndex/:Manila/|hideredirects=1 }}
 +
 
 +
 
 
[[Manila/ManilaWithGREtunnels]]
 
[[Manila/ManilaWithGREtunnels]]
  
[[Category:Manila]]
+
[[Manila/ManilaWithVXLANtunnels]]
 +
 
 +
[[Manila_devstack_script|Manila/Manila Devstack Script]]
 +
 
 +
[[Setting up Manila Network Plugins|Manila/Setting up Manila Network Plugins]]
 +
 
 +
[[Outreachy Applicants Guide|Outreachy Applicants Guide]]
 +
 
 +
[[Category:Manila]]

Latest revision as of 16:23, 21 March 2023

Introduction

This page introduces the shared file system service for OpenStack -- Manila. Manila derived from the Cinder project and provides a canonical storage provisioning control plane in OpenStack for shared or distributed file systems similarly to the way Cinder provides such a canonical control plane for block storage.

The design and implementation of Manila provide extensibility for multiple backends (to support vendor or file system specific nuances / capabilities) but is sufficiently abstract to accommodate any of a variety of shared or distributed file system types.

Shares Service.png

File-based storage continues to be a thriving market. Diverse applications, from server virtualization to relational or distributed databases to collaborative content creation, can leverage the performance, scalability and simplicity of management associated with file-based systems, and the large ecosystem of supporting software products.

While manila was designed to provide self-service provisioning and access control of file-shares to compute instances in multi-tenant OpenStack clouds, since it serves up storage over the network it can provide file-share infrastructure for clients running in other clouds or for bare-metal, VM hosts or containerized workloads.

Projects

Manila

Source code https://opendev.org/openstack/manila
Bug tracker https://bugs.launchpad.net/manila
Feature tracker https://blueprints.launchpad.net/manila
Documentation https://docs.openstack.org/manila/latest/

Python Manila Client

Source code https://opendev.org/openstack/python-manilaclient
Bug tracker https://bugs.launchpad.net/python-manilaclient
Feature tracker https://blueprints.launchpad.net/python-manilaclient
Documentation https://docs.openstack.org/python-manilaclient/latest/

Manila UI Plugin

Source code https://opendev.org/openstack/manila-ui
Bug tracker https://bugs.launchpad.net/manila-ui
Feature tracker https://blueprints.launchpad.net/manila-ui
Documentation https://docs.openstack.org/manila-ui/latest/

People

Current Manila Core Team members
Current Python Manilaclient Core Team members
Current Manila Tempest Plugin Core Team members
Current Manila UI Core Team members

Launchpad Bug Supervisors

Cross Project Liaisons (CPLs)

Role Person IRC Nick
Project Team Lead Carlos Eduardo da Silva carloss
Core Reviewers Goutham Pacha Ravi gouthamr
Douglas Viroel dviroel
Thomas Bechtold toabctl
Tom Barron tbarron
Victoria Martinez de la Cruz vkmc
Maari Tamm maaritamm
Vida Haririan vhari
Liron Kuchlani lkuchlan
Bug Czar Vida Haririan vhari

† - Core Reviewer(s) in openstack/python-manilaclient

‡ - Core Reviewer(s) in openstack/manila-tempest-plugin

Meetings

Project Agenda & Meetings

Documentation

Project Etherpads

Etherpads

Design & Use Cases

The following wiki documents are design specifications. They should not be treated as documentation. Since the Newton release, design specifications are hosted here

Known issues

Connection to neutron failed.

Subpages


Manila/ManilaWithGREtunnels

Manila/ManilaWithVXLANtunnels

Manila/Manila Devstack Script

Manila/Setting up Manila Network Plugins

Outreachy Applicants Guide