openstack/diskimage-builder
Code Issues Proposed changes

Merge "Adding docs for the source-repositories element"

Browse Source
This commit is contained in:
Jenkins 2013-07-10 20:45:09 +00:00 committed by Gerrit Code Review
commit 8c5888e853
2 changed files with 20 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
README.md
View File

@ -202,6 +202,7 @@ possible approach to this would be to label elements as either a "driver",
- An element that installs and configures Nova might be a bit more complex: - An element that installs and configures Nova might be a bit more complex:
elements/ elements/
service-nova/ service-nova/
source-repository-nova - register a source repository
pre-install.d/ pre-install.d/
50-my-ppa - add a PPA 50-my-ppa - add a PPA
install.d/ install.d/
@ -236,6 +237,13 @@ It should be noted that this is merely a naming convention to assist in
managing elements. Diskimage-builder is not, and should not be, functionally managing elements. Diskimage-builder is not, and should not be, functionally
dependent upon specific element names. dependent upon specific element names.
- diskimage-builder has the ability to retrieve source code for an element and
place it into a directory on the target image during the extra-data phase. The
default location/branch can then be overridden by the process running
diskimage-builder, making it possible to use the same element to track more
then one branch of a git repository or to get source for a local cache. See
elements/source-repositories/README.md for more information.
Debugging elements Debugging elements
------------------ ------------------

7
elements/source-repositories/README.md
View File

@ -26,8 +26,15 @@ diskimage-builder which can change the details registered by the element, these
for example if you would like diskimage-builder to get ironic from a local for example if you would like diskimage-builder to get ironic from a local
mirror you could set DIB_REPOLOCATION_ironic=git://localgitserver/ironic.git mirror you could set DIB_REPOLOCATION_ironic=git://localgitserver/ironic.git
Alternatively if you would like to use the keystone element and build an image with
keystone from a stable branch then you would set DIB_REPOREF_keystone=stable/grizzly
Git sources will be cloned to \<destination\> Git sources will be cloned to \<destination\>
Tarballs will be extracted to \<destination\>. Tarballs should contain a Tarballs will be extracted to \<destination\>. Tarballs should contain a
single topleval directory, regardless of the name of this top level directory single topleval directory, regardless of the name of this top level directory
it will be renamed to \<destination\> it will be renamed to \<destination\>
If mulitple elements register a source location with the same <destination>
then source-repositories will exit with an error. Care should therefore be taken
to only use elements together that download source to different locations.