Fuel plugin for nfs as storage backend for ephemeral volumes (nova)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
OpenDev Sysadmins ddc584bd6a OpenDev Migration Patch 1 month ago
deployment_scripts/puppet Add option to create system user `nova` on all compute nodes 3 years ago
figures Initial implementation of Nova NFS plugin for Fuel 4 years ago
repositories Initial implementation of Nova NFS plugin for Fuel 4 years ago
.gitreview OpenDev Migration Patch 1 month ago
LICENSE Initial implementation of Nova NFS plugin for Fuel 4 years ago
README.md Add option to create system user `nova` on all compute nodes 3 years ago
deployment_tasks.yaml Add option to create system user `nova` on all compute nodes 3 years ago
environment_config.yaml Add option to create system user `nova` on all compute nodes 3 years ago
metadata.yaml Add option to create system user `nova` on all compute nodes 3 years ago
pre_build_hook Initial implementation of Nova NFS plugin for Fuel 4 years ago

README.md

Fuel Nova-nfs plugin for Fuel

Nova-nfs plugin

Overview

nova-nfs uses nfs backend to store ephemeral volumes (intances.) This plugin allow to mount a nfs volume and use it as storage backend for Nova. It introduce deployment task which will be rinning on compute role

This repo contains all necessary files to build nova-nfs Fuel plugin.

Requirements

Requirement Version/Comment
Mirantis Openstack compatibility 7.0, 8.0
---------------------------------- ---------------------------------------------------------
NFS Server an NFS server with volume accessible from compute nodes

Recommendations

None.

Limitations

Only one nfs volume can be defined. So in HA deployment compute node will share the same storage backend for instances.

Installation Guide

Nova-nfs plugin installation

  1. Clone the fuel-plugin repo from: https://github.com/stackforge/fuel-plugin-nova-nfs.git

    git clone

  2. Install the Fuel Plugin Builder:

    pip install fuel-plugin-builder

  3. Build nova-nfs Fuel plugin:

fpb --build fuel-plugin-nova-nfs/

  1. The nova_nfs-.rpm file will be created in the plugin folder (fuel-plugin-nova-nfs)

  2. Move this file to the Fuel Master node with secure copy (scp):

scp nova_nfs-<x.x.x>.rpm root@:<the_Fuel_Master_node_IP address>:/tmp cd /tmp

  1. Install the nova-nfs plugin:

fuel plugins --install nova_nfs-<x.x.x>.rpm

  1. Verify that the plugin is installed correctly: fuel plugins --list

  2. Plugin is ready to use and can be enabled on the Settings tab of the Fuel web UI.

User Guide

Nova-nfs plugin configuration

  1. Create a new environment with the Fuel UI wizard

  2. Add a node with the “Compute” role.

  3. Click on the settings tab of the Fuel web UI

  4. Scroll down the page, select the “Nova-nfs plugin” checkbox and fill-in the requiered fields

    • the nfs volume to store instances
    • the mount point for the nfs volume

Here is a screenshot of the fields

nova-nfs fields

Deployment details

Create mountpoint directory Edit /etc/fstab to add auto mount of NFS volume on the mountpoint Configure Nova to use it as backend for instances Restart nova services

Known issues

The deployment failed if the NFS volume is not available during the deployment

Release Notes

1.0.0

  • Initial release of the plugin

2.0.0

  • Update plugin to Fuel 6.1 release

3.0.0

  • Update plugin to Fuel 7.0 release

3.2.0

  • Update plugin to inject task into deployment graph instead of being run as post-deployment task

3.2.1

  • Plugin is able to create system user nova on compute nodes with same uid/gid