Skip to content

Puppet example modules about using Desired State Config (DSC) resources within Puppet

License

Notifications You must be signed in to change notification settings

sthwaites/dsc_collection

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dsc_collection

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with dsc_collection
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module

Overview

This modules configures the necessary requirements to use The new Puppet Labs Windows Desired State Configuration (DSC) module.

Module Description

The modules shows the easy integration of existing PowerShell DSC Configurations with Puppet.

Setup

What dsc_collection affects

The module configures the following:

  • Makes sure the Windows Update Service is up and running
  • Makes sure the Windows Management Framework and PowerShell v5 - Preview is installed. Implemented workaround for chocolatey via custom fact chocolatey_packages
  • Configures the LCM refresh_mode as Disabled.
  • Reboots after installation and configurations
  • creates a new custom fact chocolatey_packages with informations about the installed packages via chocolatey.

Beginning with dsc_collection

After successfully using the config module you can start to use the following test classes:

  • fourthcoffee.pp - Installs IIS, .NET ASP 4.5, Disables the Default Webside and configures a new Webside with fourthcoffee application.
  • archive.pp - Example how to extract archive zip file
  • environment.pp - Example how to configure system environment variable.
  • package.pp - Example how to install software with package resource.
  • registry.pp - Example how to manage different Registry keys and values.
  • service.pp - Example how to manage a service
  • userandgroup.pp - Example how to manage a local user and a local group.
  • webpage.pp - Example how to install IIS, .NET ASP 4.5, IIS by installing from a ZIP file available via local or UNC path.

Usage

First classify your nodes with the config class to be sure all necessary configurations are applied before using one of the example classes.

Reference

...

Limitations

...

Development

Please create new issues at the official GitHub repo or send me pull requests to add additional examples/features.

Release Notes/Contributors/Etc Optional

Please use this module with caution as it is 0.x.x Release!

About

Puppet example modules about using Desired State Config (DSC) resources within Puppet

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Puppet 80.6%
  • Ruby 12.1%
  • PowerShell 7.3%