OpenStack Compute (nova)

Attach Manila shares via virtiofs

Registered by Lee Yarwood

Manila is the OpenStack Shared Filesystems service. This blueprint will implement API, database, compute and libvirt driver changes required in Nova to allow the shares provided by Manila to be associated with and attached to instances.

Blueprint information

Status:
Complete
Approver:
Sylvain Bauza
Priority:
Undefined
Drafter:
Lee Yarwood
Direction:
Approved
Assignee:
Uggla
Definition:
Approved
Series goal:
Accepted for 2025.1
Implementation:
Implemented
Milestone target:
None
Started by
Sylvain Bauza
Completed by
Sylvain Bauza

Related branches

Sprints

Whiteboard

[20220113 bauzas] Spec was approved https://review.opendev.org/c/openstack/nova-specs/+/813180

[20220225 bauzas] Implementation hit by FeatureFreeze, please repropose the blueprint/spec for the Zed release.

[20220712 bauzas] Spec got reapproved for the Zed cycle https://review.opendev.org/c/openstack/nova-specs/+/833669/

[20221115 bauzas] Spec approved for Antelope https://review.opendev.org/c/openstack/nova-specs/+/864206

Gerrit topic: https://review.opendev.org/#/q/topic:bp/manila_shares_attachments_v2

Addressed by: https://review.opendev.org/c/openstack/nova/+/831193
    Attach Manila shares via virtiofs (db)

Addressed by: https://review.opendev.org/c/openstack/nova/+/839401
    Attach Manila shares via virtiofs (objects)

Addressed by: https://review.opendev.org/c/openstack/nova/+/831194
    Attach Manila shares via virtiofs (manila abstraction)

Addressed by: https://review.opendev.org/c/openstack/nova/+/833090
    Attach Manila shares via virtiofs (drivers and compute manager part)

Addressed by: https://review.opendev.org/c/openstack/nova/+/836830
    Attach Manila shares via virtiofs (api)

Addressed by: https://review.opendev.org/c/openstack/nova/+/850499
    Check shares support

Addressed by: https://review.opendev.org/c/openstack/nova/+/850500
    Add metadata for shares

Addressed by: https://review.opendev.org/c/openstack/nova/+/850501
    Add instance.share_attach notification

Addressed by: https://review.opendev.org/c/openstack/nova/+/851028
    Add instance.share_detach notification

Addressed by: https://review.opendev.org/c/openstack/nova/+/851029
    Add shares to InstancePayload

Addressed by: https://review.opendev.org/c/openstack/nova/+/852085
    Add helper methods to attach/detach shares

Addressed by: https://review.opendev.org/c/openstack/nova/+/852086
    Add libvirt test to ensure metadata are working.

Addressed by: https://review.opendev.org/c/openstack/nova/+/852087
    Add virt/libvirt error test cases

Addressed by: https://review.opendev.org/c/openstack/nova/+/854823
    Add share_info parameter to reboot method for each driver (driver part)

Addressed by: https://review.opendev.org/c/openstack/nova/+/854824
    Support rebooting an instance with shares (compute and API part)

Addressed by: https://review.opendev.org/c/openstack/nova/+/860282
    Add instance.share_attach_error notification

Addressed by: https://review.opendev.org/c/openstack/nova/+/860283
    Add instance.share_detach_error notification

Addressed by: https://review.opendev.org/c/openstack/nova/+/860284
    Add share_info parameter to resume method for each driver (driver part)

Addressed by: https://review.opendev.org/c/openstack/nova/+/860285
    Support resuming an instance with shares (compute and API part)

Addressed by: https://review.opendev.org/c/openstack/nova/+/860286
    Add helper methods to rescue/unrescue shares

Addressed by: https://review.opendev.org/c/openstack/nova/+/860287
    Support rescuing an instance with shares (driver part)

Addressed by: https://review.opendev.org/c/openstack/nova/+/860288
    Support rescuing an instance with shares (compute and API part)

Addressed by: https://review.opendev.org/c/openstack/nova/+/871642
    Documentation

Gerrit topic: https://review.opendev.org/#/q/topic:origin/bp/manila_shares_attachments_v3

[20230307 b
Addressed by: https://review.opendev.org/c/openstack/nova-specs/+/876706
    Re-propose "Allow Manila shares to be directly attached to an instance when using libvirt" for Bobcat

[20230307 bauzas] Deferred as implementation not merged in 2023.1

Addressed by: https://review.opendev.org/c/openstack/nova/+/880075
    Mounting the shares as part of the initialization process

Addressed by: https://review.opendev.org/c/openstack/nova/+/881472
    Deletion of associated share mappings on instance deletion

Gerrit topic: https://review.opendev.org/#/q/topic:bp/manila_shares_attachments_v3

Addressed by: https://review.opendev.org/c/openstack/nova/+/883862
    Allow to mount manila share using Cephfs protocol

Gerrit topic: https://review.opendev.org/#/q/topic:bp/virtiofs_scaphandre

Addressed by: https://review.opendev.org/c/openstack/nova/+/885751
    Check shares support (compute manager)

Addressed by: https://review.opendev.org/c/openstack/nova/+/885752
    Check shares support (only API exception)

Addressed by: https://review.opendev.org/c/openstack/nova/+/885753
    Add helper methods to attach/detach shares

Addressed by: https://review.opendev.org/c/openstack/nova/+/886522
    Allow config to support virtiofs (driver)

[20230308 bauzas] Spec got approved for Bobcat https://review.opendev.org/c/openstack/nova-specs/+/876706

[20230905 bauzas] Deferred as implementation not merged in 2023.2

Gerrit topic: https://review.opendev.org/#/q/topic:bp/manila_shares_attachments_v5

Addressed by: https://review.opendev.org/c/openstack/nova/+/890340
    Add share lock/unlock and restrict visibility

Addressed by: https://review.opendev.org/c/openstack/nova-specs/+/898319
    Re-propose "Allow Manila shares to be directly attached to an instance when using libvirt" for Caracal

[20231114 bauzas] Spec got approved again for Caracal

Addressed by: https://review.opendev.org/c/openstack/nova/+/908863
    Follow up patch to correct a minor documentation issue

Addressed by: https://review.opendev.org/c/openstack/nova/+/908864
    Amend ShareMappingStatus due to asynchronous call

Gerrit topic: https://review.opendev.org/#/q/topic:bp/manila_shares_attachments_v7

Addressed by: https://review.opendev.org/c/openstack/nova/+/912518
    Amend DB model add a unique constraint.

Addressed by: https://review.opendev.org/c/openstack/nova-specs/+/913997
    Update and Re-propose "Allow Manila shares to be directly attached to an instance when using libvirt" for Dalmatian

[20240527 bauzas] Spec got reapproved for Dalmatian

Addressed by: https://review.opendev.org/c/openstack/nova/+/925277
    Use client token when talking to manila

Addressed by: https://review.opendev.org/c/openstack/nova/+/927088
    Reports instance events to the DB regarding attaching and detaching a share

Addressed by: https://review.opendev.org/c/openstack/nova-specs/+/930471
    Update and Re-propose "Allow Manila shares to be directly attached to an instance when using libvirt" for Epoxy

[20241119 bauzas] Spec got reapproved for the Epoxy timeframe

Addressed by: https://review.opendev.org/c/openstack/nova/+/935861
    Refactor test_server_shares: Mock in Base Class and trait verification

Addressed by: https://review.opendev.org/c/openstack/nova/+/936656
    Refactor response schemas for share API

(?)

Work Items

Nearby

This blueprint contains Public information 
Everyone can see this information.