https://github.com/simp/pupmod-simp-resolv
A SIMP Puppet module for managing client-side dns settings
https://github.com/simp/pupmod-simp-resolv
simp
Last synced: about 1 year ago
JSON representation
A SIMP Puppet module for managing client-side dns settings
- Host: GitHub
- URL: https://github.com/simp/pupmod-simp-resolv
- Owner: simp
- License: other
- Created: 2016-12-08T21:04:45.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-08-20T19:53:35.000Z (almost 2 years ago)
- Last Synced: 2025-04-13T05:52:43.226Z (about 1 year ago)
- Topics: simp
- Language: Ruby
- Size: 149 KB
- Stars: 0
- Watchers: 16
- Forks: 15
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
README
](http://www.apache.org/licenses/LICENSE-2.0.html)
[](https://bestpractices.coreinfrastructure.org/projects/73)
[](https://forge.puppetlabs.com/simp/resolv)
[](https://forge.puppetlabs.com/simp/resolv)
[](https://travis-ci.org/simp/pupmod-simp-resolv)
#### Table of Contents
1. [Description](#description)
2. [Setup - The basics of getting started with resolv](#setup)
* [What resolv affects](#what-resolv-affects)
* [Setup requirements](#setup-requirements)
* [Beginning with resolv](#beginning-with-resolv)
3. [Usage - Configuration options and additional functionality](#usage)
4. [Reference - An under-the-hood peek at what the module is doing and how](#reference)
5. [Limitations - OS compatibility, etc.](#limitations)
6. [Development - Guide for contributing to the module](#development)
* [Acceptance Tests - Beaker env variables](#acceptance-tests)
## Description
This module sets up DNS client config, including `/etc/resolv.conf` and `/etc/host.conf`.
### This is a SIMP module
This module is a component of the [System Integrity Management Platform](https://simp-project.com),
a compliance-management framework built on Puppet.
If you find any issues, they may be submitted to our [bug tracker](https://simp-project.atlassian.net/).
This module is optimally designed for use within a larger SIMP ecosystem, but it can be used independently:
* When included within the SIMP ecosystem, security compliance settings will be managed from the Puppet server.
## Setup
### What resolv affects
* `/etc/resolv.conf`
* `/etc/host.conf`
* `Network Manager`
### Beginning with resolv
Include the class on any systems you want to manage.
## Usage
Include the class from hiera:
```yaml
---
classes:
- ::resolv
```
File contents can be tweaked by adding more hieradata:
```yaml
---
resolv::rotate: false
resolv::host_conf::multi: true
```
## nmcli
Managing device DNS entries can be done via nmcli accordingly:
```yaml
---
resolv::use_nmcli: true
resolv::nmcli_connection_name: 'System eth0'
resolv::nmcli_ignore_auto_dns: true
resolv::nmcli_auto_reapply_device: true
```
## Reference
Please refer to the [REFERENCE.md](./REFERENCE.md).
## Limitations
SIMP Puppet modules are generally intended for use on Red Hat Enterprise Linux and compatible distributions, such as CentOS. Please see the [`metadata.json` file](./metadata.json) for the most up-to-date list of supported operating systems, Puppet versions, and module dependencies.
## Development
Please read our [Contribution Guide] (https://simp.readthedocs.io/en/stable/contributors_guide/index.html).