From 8a10870ca54cabdb94db33aa7366695863b30a7d Mon Sep 17 00:00:00 2001 From: Monty Taylor Date: Mon, 30 Mar 2015 16:30:09 -0400 Subject: [PATCH] Document the vhd-util ppa For a period of time, we're just going to hold a manually built PPA on Launchpad for the patched version of vhd-util that dib needs for VHD images. Document it. Change-Id: I6f15c5c068901120e1efff5988aabda370bf5df9 --- doc/source/nodepool.rst | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/doc/source/nodepool.rst b/doc/source/nodepool.rst index 8b7223958d..69f42c02b6 100644 --- a/doc/source/nodepool.rst +++ b/doc/source/nodepool.rst @@ -73,3 +73,35 @@ Then the previous image, 168655, will become the current image and nodepool will use it when creating new nodes. When nodepool next creates an image, it will still retain 168655 since it will still be considered the next-most-recent image. + +vhd-util +======== + +Creating images for Rackspace requires a patched version of vhd-util to convert +the images into the appropriate VHD format. A package is manaually managed +at `ppa:openstack-ci-core/vhd-util` and is based on a git repo at +https://github.com/emonty/vhd-util + +Updating vhd-util +----------------- + +Should it become required to update vhd-util before Infra has a proper +packaging repo or solution in place, one should clone from the git repo:: + + $ git clone git://github.com/emonty/vhd-util + $ cd vhd-util + +Then perform whatever updates and packaging work are needed. The repo is +formatted as a git-buildpackage repo with `--pristine-tar`. When you're ready +to upload a new verion, commit, create a source package and a tag:: + + $ git-buildpackage --git-tag --git-sign-tags -S + +This will make a source package in the parent directory. Upload it to +launchpad:: + + $ cd .. + $ dput ppa:openstack-ci-core/vhd-util vhd-util_$version_source.changes + +Then probably pushing the repo to github and submitting a pull request so that +we can keep up with the change is not a terrible idea.