Add ipa_build_upper_constraints_file variable

This variable allows to customise the upper constraints file used to
install packages inside the ipa-build-dib virtual environment. This can
be used when we need a newer version of diskimage-builder than the one
available in upper constraints for the current release.

Change-Id: Idbe57e7edc3fae25153f5e24ad6b7847b1c4660c

ansible/group_vars/all/ipa

@@ -75,6 +75,10 @@ ipa_build_dib_git_elements: >-
 # List of DIB packages to install. Default is none.
 ipa_build_dib_packages: []
 
+# Upper constraints file for installing packages in the virtual environment
+# used for building IPA images. Default is {{ pip_upper_constraints_file }}.
+ipa_build_upper_constraints_file: "{{ pip_upper_constraints_file }}"
+
 ###############################################################################
 # Ironic Python Agent (IPA) images configuration.
 

ansible/overcloud-ipa-build.yml

@@ -29,7 +29,7 @@
           vars:
             os_images_venv: "{{ virtualenv_path }}/ipa-build-dib"
             os_images_package_state: latest
-            os_images_upper_constraints_file: "{{ pip_upper_constraints_file }}"
+            os_images_upper_constraints_file: "{{ ipa_build_upper_constraints_file }}"
             os_images_cache: "{{ image_cache_path }}"
             os_images_common: ""
             os_images_list:

ansible/seed-ipa-build.yml

@@ -20,7 +20,7 @@
           vars:
             os_images_venv: "{{ virtualenv_path }}/ipa-build-dib"
             os_images_package_state: latest
-            os_images_upper_constraints_file: "{{ pip_upper_constraints_file }}"
+            os_images_upper_constraints_file: "{{ ipa_build_upper_constraints_file }}"
             os_images_cache: "{{ image_cache_path }}"
             os_images_common: ""
             os_images_list:

doc/source/configuration/reference/ironic-python-agent.rst

@@ -84,6 +84,10 @@ image build``.
     and ``ipa_build_dib_git_elements_extra``.
 ``ipa_build_dib_packages``
     List of DIB packages to install. Default is none.
+``ipa_build_upper_constraints_file``
+    Upper constraints file for installing packages in the virtual environment
+    used for building IPA images. Default is ``{{ pip_upper_constraints_file
+    }}``.
 
 Example: Building IPA images locally
 ------------------------------------

etc/kayobe/ipa.yml

@@ -61,6 +61,10 @@
 # List of DIB packages to install. Default is none.
 #ipa_build_dib_packages:
 
+# Upper constraints file for installing packages in the virtual environment
+# used for building IPA images. Default is {{ pip_upper_constraints_file }}.
+#ipa_build_upper_constraints_file:
+
 ###############################################################################
 # Ironic Python Agent (IPA) images configuration.
 

releasenotes/notes/ipa-build-upper-constraints-5686abaa161b0d94.yaml

@@ -0,0 +1,7 @@
+---
+features:
+  - |
+    Adds the ``ipa_build_upper_constraints_file`` variable to select the upper
+    constraints file used to install diskimage-builder in the virtual
+    environment used for building IPA images. This allows you to install a
+    newer release than the one allowed by the default constraints.