Forge Home

resolved

Manage the /etc/systemd/resolved.conf file content, and the /etc/resolv.conf simbol link to instruct systemd-resolved.service using the indicated private, and/or public dns server(s).

993 downloads

460 latest version

4.8 quality score

Version information

  • 1.1.5 (latest)
  • 1.1.4 (deleted)
  • 1.1.3
  • 1.1.2
  • 1.1.1 (deleted)
  • 1.1.0 (deleted)
  • 1.0.0 (deleted)
released Nov 2nd 2021
This version is compatible with:
  • Puppet Enterprise 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x
  • Puppet >= 6.21.0 < 8.0.0
  • , , , , ,

Start using this module

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

Add this module to your Puppetfile:

mod 'devalone-resolved', '1.1.5'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add devalone-resolved
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install devalone-resolved --version 1.1.5

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

Documentation

devalone/resolved — version 1.1.5 Nov 2nd 2021

resolved

Manage the /etc/systemd/resolved.conf file content, and the /etc/resolv.conf simbol link to instruct systemd-resolved.service using the indicated private, and/or public dns server(s).

Table of Contents

Description

The resolved module configures the /etc/systemd/resolved.conf file content, and the /etc/resolv.conf simbol link, manages the systemd-resolved service to use the indicated private, and/or publice dns server(s).

Setup

What resolved affects

  • This module alters the /etc/systemd/resolved.conf file contents, and alters the /etc/resolv.conf symbol link target to /run/systemd/resolve/resolv.conf.

  • The dns parameter is a space-separated list of IPv4 and IPv6 addresses to use as system DNS servers. The ip addresses in this list up to three, the extra ip addresses are ignored.

Beginning with resolved

include resolved is enough to get you up and running, this uses the default parameters to run resolved module. To pass in parameters specifying which dns server(s) to use:

class { 'resolved':
  dns => '192.168.0.2 211.137.160.5',
}

NOTE: In this example, 192.168.0.2 is the local network dns server ip, and 211.137.160.5 is the public dns server ip address.

Usage

All parameters for the resolved module are contained within the main resolved class, so for any function of the module, set the options you want. See the common usages below for examples.

Using default parameters

include resolved

I want use my own local network dns server

class { 'resolved':
  dns => '192.168.0.2',
}

I want use my own local network dns server, and public dns

set two or three dns servers: one or two for local network dns server, other(s) for public dns.

class { 'resolved':
  dns => '192.168.0.2 211.137.160.5',
}

Install resolved module on the same machine which the dns server running

If you install resolved module on the samle machine which the dns server installed, set dns_stub_listener parameter to 'no', because they may listen on the same dns default netword port: 53.

class { 'resolved':
  dns               => '192.168.0.2',
  dns_stub_listener => 'no',
}

Reference

See REFERENCE.md

Limitations

This module has been tested on Open Source Puppet 7. It is tested on ubuntu 20.04.

For an extensive list of supported operating systems, see metadata.json

Development

github https://github.com/dearall/devalone-resolved

Release Notes

2021-10-18, version 1.0.0 released. 2021-10-19, version 1.1.0 released. 2021-11-02, version 1.1.4 released. 2021-11-02, version 1.1.5 released.