Yolanda Robla ad97fb91a2 Update documentation for using diskimage-builder

Recent change in nodepool to build images using
diskimage-builder involved adding new diskimages section
in the nodepool.yaml file, and added new commands like
dib-image-list, dib-image-delete, image-build and image-upload.

Change-Id: If36f3f6e39e382cb4c6398d3a063c979888a8642

2014-08-27 11:51:08 +02:00

2.3 KiB

Raw Blame History

Operation

Nodepool generally runs as a daemon under the command nodepoold. Once started, it will frequently re-read the configuration file and make any changes necessary (such as adding or removing a provider, or altering image or quota configuration). If any needed images are missing, it will immediately begin trying to build those images. Periodically (once a day by default but configurable in the cron: section of the config file) it will attempt to create new versions of each image.

If a new image creation is successful, it will immediately start using it when launching nodes (Nodepool always uses the most recent image in the ready state). Nodepool will delete images that are older than 8 hours if they are not the most recent or second most recent ready images. In other words, Nodepool will always make sure that in addition to the current image, it keeps the previous image around. This way if you find that a newly created image is problematic, you may simply delete it and Nodepool will revert to using the previous image.

Command Line Tools

Usage

The general options that apply to all subcommands are:

nodepool --help

The following subcommands deal with nodepool images:

dib-image-list

nodepool dib-image-list --help

image-list

nodepool image-list --help

image-build

nodepool image-build --help

image-update

nodepool image-update --help

image-upload

nodepool image-upload --help

dib-image-delete

nodepool dib-image-delete --help

image-delete

nodepool image-delete --help

The following subcommands deal with nodepool nodes:

list

nodepool list --help

hold

nodepool hold --help

delete

nodepool delete --help

If Nodepool's database gets out of sync with reality, the following commands can help identify compute instances or images that are unknown to Nodepool:

alien-list

nodepool alien-list --help

alien-image-list

nodepool alien-image-list --help

2.3 KiB Raw Blame History