Automated way to build a bootable linux image for use by the Manila generic driver.
Go to file
Hervé Beraud 8036700154 Add doc/requirements
Removing specific doc requirements from test-requirements.txt and move
them to a dedicated place.

Indeed, we need to specify doc requirements in doc/requirements.txt
to avoid problems with the pip resolver [1] for the release team [2][3].

The problem here is that this repos haven't doc/requirements.txt file
and by default in this case zuul will use the test-requirements.txt file
to pull requirements [4].

This requirements file contains extra requirements like flake8 that
collided with those allowed in our job environment and so the new pip
resolver fails to install these requirements and the job exits in error.

This project meet the conditions leading to the bug.

[1] http://lists.openstack.org/pipermail/release-job-failures/2021-January/001500.html
[2] http://lists.openstack.org/pipermail/openstack-discuss/2021-January/019611.html
[3] http://lists.openstack.org/pipermail/openstack-discuss/2021-January/019612.html
[4] https://opendev.org/zuul/zuul-jobs/src/branch/master/roles/ensure-sphinx/tasks/main.yaml#L36

Change-Id: Ibf838f01d935763ff1e0d19f10340c8ee360784c
2021-01-07 11:54:17 +01:00
bin Switch ubuntu image to Focal Fossa (20.04 LTS) 2020-07-29 10:43:11 -07:00
data/docker Removes LXC/LXD support on manila-image-elements 2017-01-10 14:15:24 +00:00
doc Add doc/requirements 2021-01-07 11:54:17 +01:00
elements Merge "Start ssh only after full boot" 2020-07-22 23:57:21 +00:00
playbooks Native Zuulv3 scenario test job 2020-07-23 22:20:34 -07:00
roles/build-mie-images Native Zuulv3 scenario test job 2020-07-23 22:20:34 -07:00
tools Ignore *.service files when linting bash scripts 2020-07-29 13:24:37 -07:00
zuul.d Native Zuulv3 container scenario test job 2020-07-23 23:42:15 -07:00
.gitignore Native Zuulv3 scenario test job 2020-07-23 22:20:34 -07:00
.gitreview OpenDev Migration Patch 2019-04-19 19:32:17 +00:00
CONTRIBUTING.rst Sync Sphinx requirement 2019-06-25 14:36:09 +08:00
HACKING.rst Replace git.openstack.org URLs with opendev.org URLs 2019-04-24 00:35:17 +08:00
LICENSE Initial commit 2015-06-02 10:42:23 +03:00
README.rst README: add example for variable override 2020-05-20 12:55:52 +03:00
bindep.txt Move other-requirements.txt to bindep.txt 2016-08-12 20:54:31 +02:00
lower-constraints.txt Switch to newer openstackdocstheme version 2020-05-31 17:53:48 +02:00
requirements.txt Updated from global requirements 2017-04-12 04:13:48 +00:00
setup.cfg Cleanup py27 support 2020-04-11 15:39:10 +02:00
setup.py Cleanup py27 support 2020-04-11 15:39:10 +02:00
test-requirements.txt Add doc/requirements 2021-01-07 11:54:17 +01:00
tox.ini Add doc/requirements 2021-01-07 11:54:17 +01:00

README.rst

Team and repository tags

image

Manila Image Elements Project

This repo is a place for Manila-related diskimage-builder elements.

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:

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:

tox -e buildimage -- -s nfs

Where <share-protocol> can be nfs, cifs, zfs or nfs-ganesha.

For example, running:

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:

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