diskimage-builder/doc/source/developer/caches.rst
Andreas Florath b107606a75 Remove ccache
This patch removes the ccache handling from the base element.  For
mostly all systems this was never used at all.

This is working towards the removal of the base element from DIB

Change-Id: Ieb16ef612ebd98470993dcd6f55b3a22d37084ba
Signed-off-by: Andreas Florath <andreas@florath.net>
2017-05-31 08:28:09 +10:00

39 lines
1.5 KiB
ReStructuredText

Caches and offline mode
=======================
Since retrieving and transforming operating system image files, git
repositories, Python or Ruby packages, and so on can be a significant overhead,
we cache many of the inputs to the build process.
The cache location is read from ``DIB_IMAGE_CACHE``. :ref:`developing-elements`
describes the interface within disk-image-builder for caching.
When invoking disk-image-builder, the ``--offline`` option will instruct
disk-image-builder to not refresh cached resources. Alternatively you can set
``DIB_OFFLINE=1``.
Note that we don't maintain operating system package caches, instead depending
on your local infrastructure (e.g. Squid cache, or an APT or Yum proxy) to
facilitate caching of that layer, so you need to arrange independently for
offline mode. For more information about setting up a squid proxy, consult the
`TripleO documentation
<http://docs.openstack.org/developer/tripleo-incubator/devtest_setup.html#f3>`_.
Base images
-----------
These are cached by the standard elements - :doc:`../elements/fedora/README`,
:doc:`../elements/redhat-common/README`, :doc:`../elements/ubuntu/README`,
:doc:`../elements/debian/README` and :doc:`../elements/opensuse/README`.
source-repositories
-------------------
Git repositories and tarballs obtained via the
:doc:`../elements/source-repositories/README` element will be cached.
PyPI
----
The :doc:`../elements/pypi/README` element will bind mount a PyPI mirror from
the cache dir and configure pip and easy-install to use it.