diskimage-builder/diskimage_builder/elements/rhel7
Nir Magnezi 433a374748 Deprecate rhel7 in favor of rhel
The rhel7 element is deprecated and is left only for backward
compatibility.
The rhel element should be used instead. Users should set DIB_RELEASE to
'7' to indicate which release you are using.

The new element is a version-less RHEL element to handle both '7'
and '8' DIB_RELEASE, which aligns with other elements which operate in
the same way such as the Fedora element.

Change-Id: Ic39ed85cacae9942448eb18ad685763f9369c2ed
2019-05-29 12:07:44 +00:00
..
environment.d Deprecate rhel7 in favor of rhel 2019-05-29 12:07:44 +00:00
element-deps Deprecate rhel7 in favor of rhel 2019-05-29 12:07:44 +00:00
README.rst Deprecate rhel7 in favor of rhel 2019-05-29 12:07:44 +00:00

=====
rhel7
=====

.. warning::

   This element is deprecated and is left only for backward compatibility.
   Use the `rhel` element instead. Note that you should set DIB_RELEASE to 7
   to indicate which release you are using. Please read the notes.

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``