Apt-Cacher NG is a caching proxy built primarily for Debian (and Debian based) distributions. It stores all requests, updates and file fetches in a local cache for a configurable amount of time, speeding up Apt requests and allowing an offline mode where a server can use the cache to fetch packages from multiple repositories that would generally be inaccessable.
This recipe was written to replace the standard apt::cacher-ng recipe
in Opscode's apt cookbook, which doesn't make installing and using
Apt-Cacher NG as simple as I would have liked. Also, as a seperate full
peice of software, it belongs in its own cookbook, don't you think?
Add the following to your Berksfile or Cheffile.
cookbook 'apt-cacher-ng', git: 'https://github.com/markolson/chef-apt-cacher-ng.git'
It will not be available through the Opscode Community.
This cookbook contains two recipes: One to setup the Apt-Cacher NG server, and another to configure a seperate client/node to use that server as it's Apt proxy.
recipe[apt-cacher-ng]
Installs and starts the Apt-Cacher NG server, also configuring the node by
running the client recipe. Set the IP of this server as
node['apt-cacher-ng']['ipaddress'] in your attributes to make it
available to other nodes.
recipe[apt-cacher-ng::client]
Apt honors several types of proxy configurations, and this writes
one into /etc/apt/apt.conf.d/01proxy, the same place as apt::cacher-client
so we can maintain some compatability.
This uses the node['apt-cacher-ng']['ipaddress']
and node['apt-cacher-ng']['config']['port'] options.
You can find all available options at http://git.fsinf.at/apt/apt-cacher-ng/blobs/raw/master/conf/acng.conf
Selected options are..
node['apt-cacher-ng']['compiletime']
Default: true
If true, will install, configure and start Apt-Cacher NG immediately. Useful
if you want to cache all requests that occur during a Chef run. If set
to false, it will start after the Chef run with the rest of the services
defined during that run.
default['apt-cacher-ng']['ipaddress']
The IP Address that other hosts can use to reach the node that Apt-Cacher NG
runs on. Use by apt-cacher-ng::client, which is also run by apt-cacher-ng.
Default: 127.0.0.1
default['apt-cacher-ng']['config']['cachedir']
The directory where Apt-Cacher NG will download and store the files it proxies for clients.
Default: /var/cache/apt-cacher-ng
default['apt-cacher-ng']['config']['port']
The port that Apt-Cacher NG should run on.
Important Note: Apt-Cacher NG runs a webserver on this port to display diagnostic and administrative information.
Default: 3142
default['apt-cacher-ng']['config']['offlinemode']
Boolean toggle determining if Apt-Cacher NG should attempt outside network access. Only set to false if you have
either populated a full cache in the cachedir from a prior Chef run you wish you reuse. Useful for running Chef
installations where you have no network access.
Default: false
Add Remap options/configuration files Add user authentication for the webserver Tests. Gotta figure out how to test this thing.
Author:: Mark Olson (theothermarkolson@gmail.com)