diskimage-builder/elements/rhel7
Ian Wienand f3121f0fb7 Fix up doc errors
It seems that pbr's "warnerrors" isn't actually doing anything at the
moment (I680b448471e687919d202e8f2abe57f8ba3b22ee) meaning we're able
to commit docs with RST parser errors.  Fix all these up in some
minimal way (I have not audited content, just made it pass build).

Link the specs in so they're referenced from the top level.

Change-Id: Id67b9ea7ba8f49b43969c58ca3fb7fa1243538a4
2017-02-08 16:07:01 +11:00
..
environment.d Revert "Correct rhel-common for rhel6" 2016-02-17 22:17:11 +00:00
root.d simplify ARCH param for rhel/centos param can be x86_64 and amd64 2016-11-15 10:18:14 +11:00
element-deps Adds RHEL common element 2014-07-25 14:17:03 -04:00
element-provides Use provides to note an element provides an OS 2014-04-10 14:42:04 +01:00
README.rst Fix up doc errors 2017-02-08 16:07:01 +11:00

=====
rhel7
=====
Use RHEL 7 cloud images as the baseline for built disk images.

Because RHEL 7 base images are not publicly available, it is necessary to first
download the RHEL 7 cloud image from the Red Hat Customer Portal and pass the
path to the resulting file to disk-image-create as the ``DIB_LOCAL_IMAGE``
environment variable.

The cloud image can be found at (login required):
https://access.redhat.com/downloads/content/69/ver=/rhel---7/7.1/x86_64/product-downloads

Then before running the image build, define DIB_LOCAL_IMAGE (replace the file
name with the one downloaded, if it differs from the example)::

.. code-block:: bash

   export DIB_LOCAL_IMAGE=rhel-guest-image-7.1-20150224.0.x86_64.qcow2

The downloaded file will then be used as the basis for any subsequent image
builds.

For further details about building RHEL 7 images, see the rhel-common and
redhat-common element README files.

Environment Variables
---------------------

DIB_LOCAL_IMAGE
  :Required: Yes
  :Default: None
  :Description: The RHEL 7 base image you have downloaded. See the element
                description above for more details.
  :Example: ``DIB_LOCAL_IMAGE=/tmp/rhel7-cloud.qcow2``