Improved caching functionality and tracability 57/2557/5
authorStefan K. Berg <stefan.k.berg@ericsson.com>
Thu, 15 Oct 2015 10:51:26 +0000 (12:51 +0200)
committerStefan K. Berg <stefan.k.berg@ericsson.com>
Thu, 15 Oct 2015 15:01:59 +0000 (17:01 +0200)
commite532d93d6fef7f23f3f227eaf855fff2be846ae7
tree0c278a94ac8d7b15147255d3b213a6eba26160e5
parent66fae447879604849beb2108242e33cc0c6fc867
Improved caching functionality and tracability

In order to enable the caching of more build artifacts than the Fuel
iso during CI builds, the caching functionality and the CI build
frontend "build.sh" has been rewritten.

The build.sh script will now rely on the "make cache" functionality of
the top Makefile to make sure that the build is using cache handling.

The underlying cache logic is implemented in "cache.mk" for the top
makefile and those recursive levels that do not produce cachable
artifacts themselves in that they are only calling the SUBDIRS of
their lower level (like f_isoroot).

All "leaf" Makefiles will however need to implement three cache
targets in their top Makefile (for visibility):

clean-cache:
        Clean all files relating to the handling of caches.
get-cache:
        Attempt to fetch a cached artifact using a SHA1 key.
put-cache:
        Store a built artifact into the cache.

They can just implement a simple "no-op" functionality for thes
targets if they do not have any use of the caching functionality.

If they are to use the caching functionality, they must make sure to
implement a logic that produces a SHA1 hash based on the source of the
data they are to cache - for upstream repos one suggestion is to use
the commit ID of the used upstream HEAD. For examples, see the top
Makefile that implements this logic for the Fuel ISO build, taking
into consideration the commit IDs of all the upstream repositories
used.

To improve tracability, the root directory of the ISO will contain the
file gitinfo.txt, which is meant to detail the upstream repo and
commit ID used for all upstream dependencies of a build. If you are
adding additional upstream dependencies, make sure to use the
repo_info.sh tool to add this data.

The cache tool cache.sh has no notion of the cache data it is storing
- from the tools perspective, cache data is just a binary blob piped
in or out of the tool.

This blob is stored by the cache tool at the cache location as
<SHA1>.blob, together with an associated meta file <SHA1>.meta.

The cache meta file currently holds just one line:

    Expires: <epoch time>

This file is expected to be used to iterate through the cache objects
and retire those who's expiry date has passed. Currently objects will
always have an expiry date of two weeks into the future, but down the
road the "cache put" functionality may be amended with an optional
"age" argument that can set a different expiration time.

New tools in this commit:

  cache.sh - the cache logic
  repo_info.sh - the (optionally recursive) repo information logger

Change-Id: I8a40546c21febeecc9de6d82c0ceb6bc60b04205
Signed-off-by: Stefan K. Berg <stefan.k.berg@ericsson.com>
15 files changed:
fuel/build/Makefile
fuel/build/cache.mk
fuel/build/cache.sh [new file with mode: 0755]
fuel/build/config.mk
fuel/build/docker/runcontext
fuel/build/f_isoroot/Makefile
fuel/build/f_isoroot/cache.mk [new file with mode: 0644]
fuel/build/f_isoroot/f_bootstrap/Makefile
fuel/build/f_isoroot/f_kscfg/Makefile
fuel/build/f_isoroot/f_odlpluginbuild/Makefile
fuel/build/f_isoroot/f_repobuild/Makefile
fuel/build/install/install.sh
fuel/build/repo_info.sh [new file with mode: 0755]
fuel/ci/build.sh
fuel/include/build.sh.debug [deleted file]