# manila-image-elements

**Repository Path**: mirrors_openstack/manila-image-elements

## Basic Information

- **Project Name**: manila-image-elements
- **Description**: Automated way to build a bootable linux image for use by the Manila generic driver. Mirror of code maintained at opendev.org.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-22
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

========================
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.

Configurable variables
----------------------

You can override some build variables from ``manila-image-create``, for example:

.. sourcecode:: bash

    export DHCP_TIMEOUT=600
    export MANILA_PASSWORD=PASSWORD
    tox -e buildimage