From 3505cab5067ead805536b36b820a1ca5d5e963dc Mon Sep 17 00:00:00 2001 From: Jonathan Rosser Date: Thu, 5 Mar 2020 14:22:02 +0000 Subject: [PATCH] Update limited connectivity guide for easy_install configuration setup.py can sometimes use easy_install which requires different configuration from pip to use a local index. This is necessary when using a local pip mirror. Change-Id: I60c01438aed4a3a6d3b867ee74bf13756fa831c7 --- doc/source/user/limited-connectivity/index.rst | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/doc/source/user/limited-connectivity/index.rst b/doc/source/user/limited-connectivity/index.rst index 4809b30a31..4940cca8cb 100644 --- a/doc/source/user/limited-connectivity/index.rst +++ b/doc/source/user/limited-connectivity/index.rst @@ -57,14 +57,27 @@ all hosts in the environment. [global] index-url = http://pip.example.org/simple +In addition it is necessary to configure easy_install to use an alternative +index. easy_install is used instead of pip to install anything listed under +setup_requires in setup.py during wheel builds. See https://pip.pypa.io/en/latest/reference/pip_install/#controlling-setup-requires + +To configure easy_install to use an alternative index, create the file +`/root/.pydistutils.cfg` with the following content. + +.. code-block:: shell-session + + [easy_install] + index_url = https://pip.example.org/simple + Then, in `/etc/openstack_deploy/user_variables.yml`, inform the deployment -that it needs to copy that file from the host into the container cache image. +that it needs to copy these files from the host into the container cache image. .. code-block:: yaml # Copy these files from the host into the containers lxc_container_cache_files_from_host: - /etc/pip.conf + - /root/.pydistutils.cfg Distribution specific packages ------------------------------