openstack/openstack-ansible
Code Issues Proposed changes

docs: indicate how to override upper constraints

Browse Source 
OpenStack requirements can be overridden by defining your own
git repo and constraints file. This documentation indicates how
to make use of this in a similar way to other repo overrides.

Change-Id: I11ee0789c615714186edbf281b8654da379d998e
This commit is contained in:
Andrew Bonney 2022-01-04 13:15:23 +00:00
parent d2521a7c40
commit a749517ffb
1 changed files with 26 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
doc/source/reference/configuration/using-overrides.rst
View File

@ -393,3 +393,29 @@ To do this, you use the following configuration entry in the
``<service>_<filename>_<file extension>_overrides``. For example, the variable ``<service>_<filename>_<file extension>_overrides``. For example, the variable
name used in this example to define a meter exclusion in the ``pipeline.yml`` file name used in this example to define a meter exclusion in the ``pipeline.yml`` file
for the Telemetry service (ceilometer) is ``ceilometer_pipeline_yaml_overrides``. for the Telemetry service (ceilometer) is ``ceilometer_pipeline_yaml_overrides``.
Overriding OpenStack upper constraints
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Each OpenStack release uses an ``upper-constraints.txt`` file to define the
maximum permitted version of each Python package. In some cases it may be
necessary to override this file, for example when your local deployment needs
to take advantage of a bug fix. Care should be taken when modifying this file
as OpenStack services may not have been tested against more recent package
versions.
To override the upper constraints for a deployment, clone the OpenStack
requirements git repository, either storing it as a fork at a URL of your
choice, or within the local filesystem of the host you are using to deploy
OpenStack Ansible from. Once cloned, switch to the branch which matches the
name of your deployed OpenStack version, and modify the upper constraints as
required.
Next, edit your ``/etc/openstack_deploy/user_variables.yml`` file to indicate
the path to the requirements git repository, and the git hash of the commit
containing your changes using the ``requirements_git_repo`` and
``requirements_git_install_branch`` variables. When using the local
filesystem, the ``requirements_git_repo`` should start with ``file://``.
Finally, run the ``repo-install.yml`` playbook to upload these modified
constraints to your repo host(s).