openstack/deb-sahara
Code Issues Proposed changes

[DOC] update doc about CDH image builder

Browse Source 
Change-Id: Ic81f98243828eafebe5f1d0c3e425c029fb19c95
This commit is contained in:
Michael Ionkin 2016-09-09 16:54:17 +03:00
parent 7e470e4224
commit d0e47dbdb2
1 changed files with 21 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
doc/source/userdoc/cdh_imagebuilder.rst
View File

@ -4,8 +4,8 @@ Building Images for Cloudera Plugin
=================================== ===================================
In this document you will find instructions on how to build Ubuntu and CentOS In this document you will find instructions on how to build Ubuntu and CentOS
images with Cloudera Express (now only 5.0.0, 5.3.0 5.4.0 and 5.5.0 versions images with Cloudera Express (now only versions {5.0.0, 5.3.0 5.4.0, 5.5.0,
are supported). 5.7.x} are supported).
To simplify the task of building such images we use To simplify the task of building such images we use
`Disk Image Builder <https://github.com/openstack/diskimage-builder>`_. `Disk Image Builder <https://github.com/openstack/diskimage-builder>`_.
@ -21,8 +21,9 @@ Elements for building Cloudera images are stored in
Sahara requires images with cloud-init package installed: Sahara requires images with cloud-init package installed:
* `For CentOS <http://mirror.centos.org/centos/6/extras/x86_64/Packages/cloud-init-0.7.5-10.el6.centos.2.x86_64.rpm>`_ * `For CentOS 6 <http://mirror.centos.org/centos/6/extras/x86_64/Packages/cloud-init-0.7.5-10.el6.centos.2.x86_64.rpm>`_
* `For Ubuntu <http://packages.ubuntu.com/precise/cloud-init>`_ * `For CentOS 7 <http://mirror.centos.org/centos/7/extras/x86_64/Packages/cloud-init-0.7.5-10.el7.centos.1.x86_64.rpm>`_
* `For Ubuntu 14 <http://packages.ubuntu.com/trusty/cloud-init>`_
To create cloudera images follow these steps: To create cloudera images follow these steps:
@ -36,11 +37,12 @@ To create cloudera images follow these steps:
operating systems (subset of Ubuntu, Fedora, and CentOS depending on operating systems (subset of Ubuntu, Fedora, and CentOS depending on
plugin). To only create Cloudera images, you should use the "-p cloudera" plugin). To only create Cloudera images, you should use the "-p cloudera"
parameter in the command line. If you want to create the image only for a parameter in the command line. If you want to create the image only for a
specific operating system, you should use the "-i ubuntu|centos" parameter specific operating system, you should use the "-i ubuntu|centos|centos7"
to assign the operating system (the cloudera plugin only supports Ubuntu and parameter to assign the operating system (the cloudera plugin only supports
Centos). If you want to create the image only for a specific Cloudera Ubuntu and Centos). If you want to create the image only for a specific
version, you should use the "-v 5.0|5.3|5.4|5.5" parameter to assign the Cloudera version, you should use the "-v 5.0|5.3|5.4|5.5|5.7" parameter to
version. Below is an example to create Cloudera images for both Ubuntu and assign the version. Note that Centos 7 can only be used with CDH 5.5 and
CDH 5.7. Below is an example to create Cloudera images for both Ubuntu and
CentOS with Cloudera Express 5.5.0 version. CentOS with Cloudera Express 5.5.0 version.
.. sourcecode:: console .. sourcecode:: console
@ -48,12 +50,19 @@ To create cloudera images follow these steps:
tox -e venv -- sahara-image-create -p cloudera -v 5.5 tox -e venv -- sahara-image-create -p cloudera -v 5.5
If you want to create only an Ubuntu image, you may use following example If you want to create only an Ubuntu image, you may use following example
for that. for that:
.. sourcecode:: console .. sourcecode:: console
tox -e venv -- sahara-image-create -p cloudera -i ubuntu -v 5.5 tox -e venv -- sahara-image-create -p cloudera -i ubuntu -v 5.5
For CDH 5.7 we support minor versions. If you want to build a minor version
just export DIB_CDH_MINOR_VERSION before sahara-image-create launch, e.g.:
.. sourcecode:: console
export DIB_CDH_MINOR_VERSION=5.7.1
NOTE: If you don't want to use default values, you should explicitly set the NOTE: If you don't want to use default values, you should explicitly set the
values of your required parameters. values of your required parameters.
@ -68,8 +77,8 @@ To create cloudera images follow these steps:
hypervisor, the generated image should be converted to an appropriate hypervisor, the generated image should be converted to an appropriate
format. format.
The VMware Nova backend requires the VMDK image format. You may use qemu-img The VMware Nova backend requires the VMDK image format. You may use
utility to convert a QCOW2 image to VMDK. qemu-img utility to convert a QCOW2 image to VMDK.
.. sourcecode:: console .. sourcecode:: console