{"id":20072384,"url":"https://github.com/markolson/chef-apt-cacher-ng","last_synced_at":"2025-07-05T03:34:06.573Z","repository":{"id":140484473,"uuid":"13372098","full_name":"markolson/chef-apt-cacher-ng","owner":"markolson","description":"Apt-Cacher NG cookbook for Chef","archived":false,"fork":false,"pushed_at":"2014-03-10T18:08:55.000Z","size":180,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-13T00:24:01.626Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/markolson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-10-07T00:27:01.000Z","updated_at":"2014-03-10T18:08:55.000Z","dependencies_parsed_at":"2023-03-13T10:42:02.095Z","dependency_job_id":null,"html_url":"https://github.com/markolson/chef-apt-cacher-ng","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markolson%2Fchef-apt-cacher-ng","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markolson%2Fchef-apt-cacher-ng/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markolson%2Fchef-apt-cacher-ng/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markolson%2Fchef-apt-cacher-ng/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/markolson","download_url":"https://codeload.github.com/markolson/chef-apt-cacher-ng/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241503065,"owners_count":19972978,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T14:39:47.685Z","updated_at":"2025-03-02T12:18:29.304Z","avatar_url":"https://github.com/markolson.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Apt-Cacher NG cookbook\n\nApt-Cacher NG is a caching proxy built primarily for Debian (and Debian\nbased) distributions. It stores all requests, updates and file fetches\nin a local cache for a configurable amount of time, speeding up Apt\nrequests and allowing an offline mode where a server can use the cache\nto fetch packages from multiple repositories that would generally be\ninaccessable.\n\nThis recipe was written to replace the standard `apt::cacher-ng` recipe\nin Opscode's `apt` cookbook, which doesn't make installing and using\nApt-Cacher NG as simple as I would have liked. Also, as a seperate full\npeice of software, it belongs in its own cookbook, don't you think?\n\n\n# Installation\n\nAdd the following to your Berksfile or Cheffile.\n\n`cookbook 'apt-cacher-ng', git: 'https://github.com/markolson/chef-apt-cacher-ng.git'`\n\nIt will not be available through the Opscode Community.\n\n# Usage and Recipes\n\nThis cookbook contains two recipes: One to setup the Apt-Cacher NG server,\nand another to configure a seperate client/node to use that server as it's\nApt proxy.\n\n## Apt-Cacher NG\n\n`recipe[apt-cacher-ng]`\n\nInstalls and starts the Apt-Cacher NG server, also configuring the node by\nrunning the `client` recipe. Set the IP of this server as\n`node['apt-cacher-ng']['ipaddress']` in your attributes to make it\navailable to other nodes.\n\n## Apt Proxy Setup\n\n`recipe[apt-cacher-ng::client]`\n\nApt honors several types of proxy configurations, and this writes\none into `/etc/apt/apt.conf.d/01proxy`, the same place as `apt::cacher-client`\nso we can maintain some compatability.\n\nThis uses the `node['apt-cacher-ng']['ipaddress']`\nand `node['apt-cacher-ng']['config']['port']` options.\n\n\n# Attributes\n\nYou can find all available options at\nhttp://git.fsinf.at/apt/apt-cacher-ng/blobs/raw/master/conf/acng.conf\n\nSelected options are..\n\n----\n\n`node['apt-cacher-ng']['compiletime']`\n\nDefault: `true`\n\nIf true, will install, configure and start Apt-Cacher NG immediately. Useful\nif you want to cache all requests that occur during a Chef run. If set\nto `false`, it will start after the Chef run with the rest of the services\ndefined during that run.\n\n----\n\n`default['apt-cacher-ng']['ipaddress']`\n\nThe IP Address that other hosts can use to reach the node that Apt-Cacher NG\nruns on. Use by `apt-cacher-ng::client`, which is also run by `apt-cacher-ng`.\n\nDefault: `127.0.0.1`\n\n----\n\n`default['apt-cacher-ng']['config']['cachedir']`\n\nThe directory where Apt-Cacher NG will download and store the files it\nproxies for clients.\n\nDefault: `/var/cache/apt-cacher-ng`\n\n----\n\n`default['apt-cacher-ng']['config']['port']`\n\nThe port that Apt-Cacher NG should run on.\n\n*Important Note:* Apt-Cacher NG runs a webserver on this port to display diagnostic and administrative information.\n\nDefault: `3142`\n\n----\n\n`default['apt-cacher-ng']['config']['offlinemode']`\n\nBoolean toggle determining if Apt-Cacher NG should attempt outside network access. Only set to `false` if you have\neither populated a full cache in the `cachedir` from a prior Chef run you wish you reuse. Useful for running Chef\ninstallations where you have no network access.\n\nDefault: `false`\n\n# TODOs\n\nAdd Remap options/configuration files\nAdd user authentication for the webserver\nTests. Gotta figure out how to test this thing.\n\n# Author\n\nAuthor:: Mark Olson (\u003ctheothermarkolson@gmail.com\u003e)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkolson%2Fchef-apt-cacher-ng","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarkolson%2Fchef-apt-cacher-ng","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkolson%2Fchef-apt-cacher-ng/lists"}