Luigi Toscano 5662d84690 doc: point to the main git repository and update links

- no need to refer to github; point to the main repositories
  on git.openstack.org and remove the requirement for a github
  account in order to contribute;
- update few links which have been moved around and fix at least
  the associated message of a link;
- link to the website for HTTPie.

Change-Id: Ib310815d346e2364de1a2282f3f1e2d94590c3d2

2017-08-21 15:15:47 +02:00

3.7 KiB

Raw Blame History

Building Images for Cloudera Plugin

In this document you will find instructions on how to build Ubuntu and CentOS images with Cloudera Express (now only versions {5.0.0, 5.3.0 5.4.0, 5.5.0, 5.7.x, 5.9.x} are supported).

To simplify the task of building such images we use Disk Image Builder.

Disk Image Builder builds disk images using elements. An element is a particular set of code that alters how the image is built, or runs within the chroot to prepare the image.

Elements for building Cloudera images are stored in Sahara extra repository

Note

Sahara requires images with cloud-init package installed:

To create cloudera images follow these steps:

Clone repository "https://git.openstack.org/cgit/openstack/sahara-image-elements" locally.
Use tox to build images.

You can run "tox -e venv -- sahara-image-create" command in sahara-image-elements directory to build images. By default this script will attempt to create cloud images for all versions of supported plugins and all operating systems (subset of Ubuntu, Fedora, and CentOS depending on 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 specific operating system, you should use the "-i ubuntucentos7" parameter to assign the operating system (the cloudera plugin only supports Ubuntu and Centos). If you want to create the image only for a specific Cloudera version, you should use the "-v 5.05.45.7|5.9" parameter to assign the version. Note that Centos 7 can only be used with CDH 5.5 and higher. Below is an example to create Cloudera images for both Ubuntu and CentOS with Cloudera Express 5.5.0 version.
```
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 for that:
```
tox -e venv -- sahara-image-create -p cloudera -i ubuntu -v 5.5
```
For CDH 5.7 and higher 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.:
```
export DIB_CDH_MINOR_VERSION=5.7.1
```
NOTE: If you don't want to use default values, you should explicitly set the values of your required parameters.

The script will create required cloud images using image elements that install all the necessary packages and configure them. You will find the created images in the parent directory.

Note

Disk Image Builder will generate QCOW2 images, used with the default OpenStack Qemu/KVM hypervisors. If your OpenStack uses a different hypervisor, the generated image should be converted to an appropriate format.

The VMware Nova backend requires the VMDK image format. You may use qemu-img utility to convert a QCOW2 image to VMDK.

qemu-img convert -O vmdk <original_image>.qcow2 <converted_image>.vmdk

For finer control of diskimage-create.sh see the official documentation

3.7 KiB Raw Blame History

Building Images for Cloudera Plugin

3.7 KiB

Raw Blame History