{"id":15022780,"url":"https://github.com/voxpupuli/puppet-ipset","last_synced_at":"2025-06-12T14:38:16.182Z","repository":{"id":35152575,"uuid":"211879077","full_name":"voxpupuli/puppet-ipset","owner":"voxpupuli","description":"Puppet module to manage ipset tooling and actual sets","archived":false,"fork":false,"pushed_at":"2025-05-28T15:49:44.000Z","size":247,"stargazers_count":0,"open_issues_count":7,"forks_count":21,"subscribers_count":43,"default_branch":"master","last_synced_at":"2025-06-08T13:24:44.951Z","etag":null,"topics":["archlinux-puppet-module","centos-puppet-module","debian-puppet-module","hacktoberfest","linux-puppet-module","oraclelinux-puppet-module","puppet","redhat-puppet-module","scientific-puppet-module","ubuntu-puppet-module"],"latest_commit_sha":null,"homepage":"https://forge.puppet.com/puppet/ipset","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/voxpupuli.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"open_collective":"vox-pupuli","github":"voxpupuli"}},"created_at":"2019-09-30T14:27:01.000Z","updated_at":"2025-05-28T15:49:47.000Z","dependencies_parsed_at":"2023-02-16T08:01:53.350Z","dependency_job_id":"cf513e66-9af0-4edc-8ce5-14fe6aa6fa3c","html_url":"https://github.com/voxpupuli/puppet-ipset","commit_stats":{"total_commits":123,"total_committers":21,"mean_commits":5.857142857142857,"dds":0.2764227642276422,"last_synced_commit":"4062bf1ec717e6193e2a101a4baf51610e6ae820"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-ipset","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-ipset/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-ipset/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-ipset/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/voxpupuli","download_url":"https://codeload.github.com/voxpupuli/puppet-ipset/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-ipset/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259080921,"owners_count":22802393,"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":["archlinux-puppet-module","centos-puppet-module","debian-puppet-module","hacktoberfest","linux-puppet-module","oraclelinux-puppet-module","puppet","redhat-puppet-module","scientific-puppet-module","ubuntu-puppet-module"],"created_at":"2024-09-24T19:58:22.632Z","updated_at":"2025-06-12T14:38:16.139Z","avatar_url":"https://github.com/voxpupuli.png","language":"Ruby","funding_links":["https://opencollective.com/vox-pupuli","https://github.com/sponsors/voxpupuli"],"categories":[],"sub_categories":[],"readme":"# puppet-ipset\n\n[![Build Status](https://github.com/voxpupuli/puppet-ipset/workflows/CI/badge.svg)](https://github.com/voxpupuli/puppet-ipset/actions?query=workflow%3ACI)\n[![Release](https://github.com/voxpupuli/puppet-ipset/actions/workflows/release.yml/badge.svg)](https://github.com/voxpupuli/puppet-ipset/actions/workflows/release.yml)\n[![Puppet Forge](https://img.shields.io/puppetforge/v/puppet/ipset.svg)](https://forge.puppetlabs.com/puppet/ipset)\n[![Puppet Forge - downloads](https://img.shields.io/puppetforge/dt/puppet/ipset.svg)](https://forge.puppetlabs.com/puppet/ipset)\n[![Puppet Forge - endorsement](https://img.shields.io/puppetforge/e/puppet/ipset.svg)](https://forge.puppetlabs.com/puppet/ipset)\n[![Puppet Forge - scores](https://img.shields.io/puppetforge/f/puppet/ipset.svg)](https://forge.puppetlabs.com/puppet/ipset)\n[![puppetmodule.info docs](http://www.puppetmodule.info/images/badge.png)](http://www.puppetmodule.info/m/puppet-ipset)\n[![AGPL v3 License](https://img.shields.io/github/license/voxpupuli/puppet-ipset.svg)](LICENSE)\n\n## Table of Contents\n\n* [Overview](#overview)\n* [Usage](#usage)\n  * [Array](#array)\n  * [String](#string)\n  * [Module file](#module-file)\n  * [Local file](#local-file)\n* [Reference](#reference)\n* [Limitations](#limitations)\n* [Changelog](#changelog)\n* [Development and Contribution](#development-and-contribution)\n* [Thanks](#thanks)\n\n## Overview\n\nThis module manages Linux IP sets.\n\n* Checks for current ipset state, before doing any changes to it.\n* Applies ipset every time it drifts from target state,\n  not only on config file change.\n* Handles type changes.\n* Autostart support for RHEL 6 and RHEL 7 family (upstart, systemd).\n\n## Usage\n\n### Array\n\nIP sets can be filled from an array data structure.\nTypically passed from Hiera.\n\n```puppet\nipset::set { 'foo':\n  ensure =\u003e present,\n  set    =\u003e ['1.2.3.4', '5.6.7.8'],\n  type   =\u003e 'hash:ip',\n}\n```\n\n### String\n\nYou can also pass a pre-formatted string directly, using one entry per line\n(with ``\\n`` as a separator).\nThis pattern is practical when generating the IP set entries using a template.\n\n```puppet\nipset::set { 'foo':\n  ensure =\u003e present,\n  set    =\u003e \"1.2.3.4\\n5.6.7.8\",\n  type   =\u003e 'hash:ip',\n}\n```\n\n### Module file\n\nIP sets content can also be stored in a module file:\n\n```puppet\nipset::set { 'foo':\n  ensure =\u003e present,\n  set    =\u003e \"puppet:///modules/${module_name}/foo.ipset\",\n}\n```\n\n### Local file\n\nOr using a plain text file stored on the filesystem:\n\n```puppet\nfile { '/tmp/bar_set_content':\n  ensure  =\u003e present,\n  content =\u003e \"1.2.3.0/24\\n5.6.7.8/32\",\n}\n\nipset::set { 'bar':\n  ensure    =\u003e present,\n  set       =\u003e 'file:///tmp/bar_set_content',\n  type      =\u003e 'hash:net',\n  subscribe =\u003e File['/tmp/bar_set_content'],\n}\n```\n\n### Unmanaged ipsets\n\nDeclare an IP set, without managing its content:\n\n```puppet\nipset::unmanaged { 'baz':\n  ensure =\u003e present,\n  type   =\u003e 'hash:net',\n}\n```\n\nUseful when you have a dynamic process that generates an IP set content,\nbut still want to define and use it from Puppet.\n\nWarning: When changing IP set attributes (type, options) contents won't be kept, set will be recreated as empty.\n\n## Reference\n\nThe module uses puppet-strings for documentation. The result is the\n[REFERENCE.md](REFERENCE.md) file.\n\n## Limitations\n\n* Tested on Debian and RedHat-like Linux distributions\n* Only **hash** ipsets are supported (this excludes *bitmap* and *list:set*)\n\n## Changelog\n\nSee [CHANGELOG](https://github.com/voxpupuli/puppet-ipset/blob/master/CHANGELOG.md)\n\n## Development and Contribution\n\nSee [development](https://github.com/voxpupuli/puppet-ipset/blob/master/.github/CONTRIBUTING.md)\n\n## Thanks\n\nThis module is a complete rewrite of [sl0m0ZA/ipset](https://github.com/sl0m0ZA/puppet-ipset),\nwhich is a fork of [pmuller/ipset](https://forge.puppet.com/pmuller/ipset),\nwhich was forked from [mighq/ipset](https://github.com/mighq/puppet-ipset),\nwhich was based on [thias/ipset](https://github.com/thias/puppet-ipset).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxpupuli%2Fpuppet-ipset","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoxpupuli%2Fpuppet-ipset","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxpupuli%2Fpuppet-ipset/lists"}