httpproxy

pdk
Provides a simple way to manage various proxies
Frechetta

Frechetta

frechetta93

1,363 downloads

946 latest version

5.0 quality score

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
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
  • RedHat
    ,
    CentOS
    ,
    OracleLinux
    ,
    Debian
    ,
    Ubuntu

Start using this module

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