aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMichal Nasiadka <mnasiadka@gmail.com>2026-06-16 22:15:29 +0200
committerMichal Nasiadka <mnasiadka@gmail.com>2026-07-30 15:55:31 +0200
commit71867b8e57273ffcc26f4fedd84919b2608da3f2 (patch)
treea5b6b1a3d9f1d9c033db7312b033a055d54aedfc /doc
parent5d77668da8167435e4ac860392994f19ec733a46 (diff)
downloadkolla-71867b8e57273ffcc26f4fedd84919b2608da3f2.tar.gz
kolla-71867b8e57273ffcc26f4fedd84919b2608da3f2.zip
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 <mnasiadka@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/source/admin/image-building.rst19
1 files changed, 16 insertions, 3 deletions
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``.