octavia/elements/octavia-lib/README.rst
Carlos Goncalves dcda721320 Add DIB element octavia-lib
This new diskimage-builder element installs octavia-lib from Git for
source install type image builds rather than from released versions.

To mention some advantages:

1. allow custom octavia-lib versions (useful for development)
2. test unreleased octavia-lib changes in CI
3. install latest changes from master and stable branches
   (aligns with approach taken with amphora-agent)

Branch checkout to stable/* from master for octavia-lib DIB element will
be automated on branch create. See https://review.opendev.org/#/c/745877

Change-Id: I6d87b6bd25c536b2bed1994427cd933bdcc091d6
2020-08-24 11:24:19 +02:00

936 B

Element to install octavia-lib from a Git source.

This element allows octavia-lib installs from an arbitraty Git repository. This is especially useful for development environments.

By default, octavia-lib is installed from upstream master branch or from an upstream stable branch for OpenStack release series.

To install from an alternative Git location, define the following:

DIB_REPOLOCATION_octavia_lib=<path/to/octavia-lib>
DIB_REPOREF_octavia_lib=<branch or ref>

If you wish to build an image using code from a Gerrit review, you can set DIB_REPOLOCATION_octavia_lib and DIB_REPOREF_octavia_lib to the values given by Gerrit in the fetch/pull section of a review. For example, installing octavia-lib with change 744519 at patchset 2:

DIB_REPOLOCATION_octavia_lib=https://review.opendev.org/openstack/octavia-lib
DIB_REPOREF_octavia_lib=refs/changes/19/744519/2