manila-image-elements/README.rst

59 lines
1.5 KiB
ReStructuredText

========================
Team and repository tags
========================
.. image:: https://governance.openstack.org/tc/badges/manila-image-elements.svg
:target: https://governance.openstack.org/tc/reference/tags/index.html
=============================
Manila Image Elements Project
=============================
This repo is a place for Manila-related diskimage-builder elements.
* Free software: Apache license
* Source: https://opendev.org/openstack/manila-image-elements
* Bugs: https://bugs.launchpad.net/manila-image-elements
* Built Images: https://tarballs.openstack.org/manila-image-elements/images
Build instructions
~~~~~~~~~~~~~~~~~~
Before building the image, make sure all system dependencies
listed in bindep.txt file, are installed.
Default generic using tox
-------------------------
Script for creating Ubuntu based image with our elements and default parameters.
You should only need to run this command:
.. sourcecode:: bash
tox -e buildimage
On completion, an Ubuntu minimal image with NFS+CIFS will be available for use.
Non-default image using tox
---------------------------
A finer-grained image creation control can be obtained by specifying extra parameters.
Precisely, the syntax is as follows:
.. sourcecode:: bash
tox -e buildimage -- -s nfs
Where <share-protocol> can be nfs, cifs, zfs or nfs-ganesha.
For example, running:
.. sourcecode:: bash
tox -e buildimage -- -s cifs
Will generate an Ubuntu based image with CIFS.