puppet-squid3

Overview

Install, enable and configure a Squid 3 http proxy server with its main configuration file options.

• squid3 : Main class for the Squid 3 http proxy server.

Examples

Basic memory caching proxy server :

include squid3

Non-caching multi-homed proxy server :

class { '::squid3':
  acl => [
    'country_de myip 192.168.1.1',
    'country_fr myip 192.168.1.2',
    'office src 10.0.0.0/24',
  ],
  http_access => [
    'allow office',
  ],
  cache => [ 'deny all' ],
  via => 'off',
  tcp_outgoing_address => [
    '192.168.1.1 country_de',
    '192.168.1.2 country_fr',
  ],
  server_persistent_connections => 'off',
}

Caveats

Upgrading Squid3 from version 3.2 to 3.3 breaks the configuration file to fix :

class { '::squid3':
  use_deprecated_opts => false
}

2025-02-04 - 1.0.5

• Remove legacy facts usage.

2019-01-23 - 1.0.4

• Allow both config_hash and config_array (not much use, but works fine).

2019-01-21 - 1.0.3

• Add config_source and config_content parameters.

2017-02-02 - 1.0.2

• Remove hierarchy_stoplist, obsolete and (almost) never used/relevant.

2016-09-28 - 1.0.1

• Fix cache_dir in short template, must be below maximum_object_size.
• Add a few parameters, make sure log ones from params can be overridden.
• Add config_array for order-sensitive config lines (#25, @GeoffWilliams).
• Fix params for Ubuntu 16.04 rename from squid3 to squid (#47, @ianssoftcom).
• Add option to remove localnet defaults (#40, @rwf14f).
• Fix validate path to work on all operating systems (#39, @sethlyons).

2015-11-16 - 1.0.0

• Add FreeBSD support (#11, @misullivan).
• Add version parameter to set squid package version (#12, @actionjack).
• Add use_deprecated_opts parameter (#13, @actionjack).
• Add https_port parameter (@actionjack).
• Fix Ubuntu upstart error (#14, @actionjack).
• Fix coredump_dir not using variable in short template (#18, @wunzeco).
• Add puppetlabs-stdlib requirement, as empty() is used (#21, @cliffano).
• Fix operatingsystem comparison for RHEL < 6 (#27, @pecastro).
• Add ssl_ports and safe_ports array parameters (#30, @tinnightcap).
• Add validate_cmd for the configuration file (#31, @tinnightcap).
• Sort $config_hash to avoid order change in the configuration file.

2014-07-15 - 0.2.3

• Add refresh_patterns config option (#7, @adamgraves85).

2014-05-12 - 0.2.2

• Include short template and allow using custom templates (#5, @flypenguin).

2014-03-28 - 0.2.1

• Fix coredump_dir on Debian/Ubuntu (#6, @jinnko).

2013-09-09 - 0.2.0

• Add params, start supporting Debian OS family.
• Automatically pick the right package name on RHEL5.
• Added maximum_object_size{,_in_memory} parameters (Tristan Helmich).

2013-05-24 - 0.1.1

• Add ChangeLog and update Modulefile.
• Add LICENSE file.
• Update README and use markdown.