From 71867b8e57273ffcc26f4fedd84919b2608da3f2 Mon Sep 17 00:00:00 2001 From: Michal Nasiadka Date: Tue, 16 Jun 2026 22:15:29 +0200 Subject: Move PIP_* env variables to ARG and config Leaving empty CI template_overrides file in case we need to use it in future. Change-Id: Ic46f1a594bcc330536bc78d93ece10e60622f6d4 Signed-off-by: Michal Nasiadka --- doc/source/admin/image-building.rst | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/source/admin/image-building.rst b/doc/source/admin/image-building.rst index 4a2c6773b..3a40f5f6e 100644 --- a/doc/source/admin/image-building.rst +++ b/doc/source/admin/image-building.rst @@ -372,9 +372,22 @@ verification purposes. Python packages build options ----------------------------- -The block ``base_pip_conf`` in the ``base`` Dockerfile can be used to provide -the PyPI build customisation options via the standard environment variables -like ``PIP_INDEX_URL``, ``PIP_TRUSTED_HOST``, etc. +The PyPI mirror used during image builds can be configured directly in +``kolla-build.conf``: + +.. path /etc/kolla/kolla-build.conf +.. code-block:: ini + + [DEFAULT] + pip_index_url = https://pypi.example.com/simple + pip_trusted_host = pypi.example.com + pip_extra_index_url = https://wheels.example.com/simple + +These options set the ``PIP_INDEX_URL``, ``PIP_TRUSTED_HOST``, and +``PIP_EXTRA_INDEX_URL`` ARG variables in the base image via the +``base_pip_conf`` Dockerfile block. The ``pip_extra_index_url`` option is +optional. For further customisation, the block ``base_pip_conf`` can be +overridden via the template_override mechanism. To override PYPI upper-constraints of all OpenStack images, you can define the source location of openstack-base. in ``kolla-build.conf``. -- cgit v1.2.3