Forge Home

httpproxy

Provides a simple way to manage various proxies

2,475 downloads

1,455 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 2.3.0 (latest)
  • 2.2.1
  • 2.2.0
  • 2.1.4
  • 2.1.3
  • 2.1.2
  • 2.1.1
  • 2.1.0 (deleted)
released Dec 12th 2019
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 7.0.0
  • , , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'frechetta93-httpproxy', '2.3.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add frechetta93-httpproxy
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install frechetta93-httpproxy --version 2.3.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download
Tags: proxy, linux

Documentation

frechetta93/httpproxy — version 2.3.0 Dec 12th 2019

httpproxy

Build Status Puppet Forge Puppet Forge Downloads Puppet Forge Score

Table of Contents

  1. Overview
  2. Usage - Configuration options and additional functionality
  3. Reference - An under-the-hood peek at what the module is doing and how
  4. Limitations - OS compatibility, etc.
  5. Contributors

Overview

This module was created to streamline proxy management of popular software. This software includes:

  • apt
  • yum
  • rpm
  • profile.d
  • git
  • wget
  • ruby

Currently only http (no https) proxies are supported.

Usage

First, declare the module with the proxy settings:

class { 'httpproxy':
    url      => 'proxy.my.org',
    port     => '80',
    user     => 'proxy_user',
    pass     => 'proxy_pass',
    no_proxy => '.my.org',
}

The no_proxy parameter takes a comma separated string of addresses to be ignored by the profile.d proxy.

To enable proxy management:

apt/yum/rpm

Defaults:

httpproxy::packagemanager { 'proxy-pkg': }

Purge /etc/apt.conf:

httpproxy::packagemanager { 'proxy-pkg':
    purge_apt_conf => true,
}

If purge_apt_conf is set to true, the existing /etc/apt.conf file will be removed (if on Debian/Ubuntu) to ensure the apt proxy is managed by this module.

profile.d

httpproxy::profiled { 'proxy-profiled': }

git

httpproxy::git { 'proxy-git': }

wget

httpproxy::wget { 'proxy-wget': }

ruby

Defaults:

httpproxy::gem { 'proxy-gem': }

Custom path:

httpproxy::gem { 'httpproxy-gem':
    path => '/root/.gemrc',
}

You may pass ensure => 'absent' to any of the modules above to ensure there is no proxy set for that module.

Reference

httpproxy uses the Unibets profile.d management module to manage proxies in profile.d. The puppetlabs/inifile resource is used to manage the yum and wget proxies. The apt proxy is managed via the puppetlabs/apt module.

Please contribute, pull requests are welcome. The more proxies that can be managed the better.

Limitations

This module has been tested against Puppet 4, 5, 6, CentOS 5, 6, 7, and Ubuntu 14.04, 16.04, 18.04.

Contributors

Chris Edester, Michael Callahan, and Eric Frechette