c4bbb6f3bc
We currently do not have the ability to create a docs site which outlines all the elements. Change-Id: I77ccf61e0c4b1509b3e7ce9b8f15ea5ccfd50d9b
22 lines
760 B
ReStructuredText
22 lines
760 B
ReStructuredText
=========
|
|
pip-cache
|
|
=========
|
|
# Use a cache for pip
|
|
|
|
Using a download cache speeds up image builds.
|
|
|
|
Including this element in an image build causes
|
|
$HOME/.cache/image-create/pip to be bind mounted as /tmp/pip inside
|
|
the image build chroot. The $PIP_DOWNLOAD_CACHE environment variable
|
|
is then defined as /tmp/pip, which causes pip to cache all downloads
|
|
to the defined location.
|
|
|
|
Note that pip and its use of $PIP_DOWNLOAD_CACHE is not concurrency
|
|
safe. Running multiple instances of diskimage-builder concurrently
|
|
can cause issues. Therefore, it is advised to only have one instance
|
|
of diskimage-builder that includes the pip-cache element running at a
|
|
time.
|
|
|
|
The pip concurrency issue is being tracked upstream at
|
|
https://github.com/pypa/pip/issues/1141
|