From 661ea17df8b93145eee5eccba07598382a92cd65 Mon Sep 17 00:00:00 2001 From: GitHub Action Date: Thu, 23 Mar 2023 15:19:48 +0000 Subject: [PATCH] Release prep v4.1.2 --- CHANGELOG.md | 8 ++++ REFERENCE.md | 103 ++++++++++++++++++++++++++------------------------ metadata.json | 2 +- 3 files changed, 62 insertions(+), 51 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 06e48e4..8d06348 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,14 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](http://semver.org). +## [v4.1.2](https://github.com/puppetlabs/puppetlabs-registry/tree/v4.1.2) (2023-03-23) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-registry/compare/v4.1.1...v4.1.2) + +### Fixed + +- \(CONT-362\) Syntax update [\#273](https://github.com/puppetlabs/puppetlabs-registry/pull/273) ([LukasAud](https://github.com/LukasAud)) + ## [v4.1.1](https://github.com/puppetlabs/puppetlabs-registry/tree/v4.1.1) (2022-10-03) [Full Changelog](https://github.com/puppetlabs/puppetlabs-registry/compare/v4.1.0...v4.1.1) diff --git a/REFERENCE.md b/REFERENCE.md index 3e33180..4281a86 100644 --- a/REFERENCE.md +++ b/REFERENCE.md @@ -6,8 +6,8 @@ ### Defined types -* [`registry::service`](#registryservice): Defined resource type that manages service entries -* [`registry::value`](#registryvalue): High level abstraction on top of registry_key and registry_value resources +* [`registry::service`](#registry--service): Defined resource type that manages service entries +* [`registry::value`](#registry--value): High level abstraction on top of registry_key and registry_value resources ### Resource types @@ -16,7 +16,7 @@ ## Defined types -### `registry::service` +### `registry::service` Manages the values in the key HKLM\System\CurrentControlSet\Services\$name\ @@ -36,7 +36,7 @@ registry::service { puppet: ensure => present, display_name => 'Puppet Agent', description => 'Periodically fetches and applies - configurations from a Puppet Server.', + configurations from a Puppet Server.', command => 'C:\PuppetLabs\Puppet\service\daemon.bat', } ``` @@ -45,56 +45,55 @@ registry::service { puppet: The following parameters are available in the `registry::service` defined type: -* [`ensure`](#ensure) -* [`display_name`](#display_name) -* [`description`](#description) -* [`command`](#command) -* [`start`](#start) +* [`ensure`](#-registry--service--ensure) +* [`display_name`](#-registry--service--display_name) +* [`description`](#-registry--service--description) +* [`command`](#-registry--service--command) +* [`start`](#-registry--service--start) -##### `ensure` - -Data type: `present, absent` +##### `ensure` +Data type: `Enum['present', 'absent', 'UNSET']` +Ensures the presence or absence of a registry key. Valid values: 'present', 'absent', 'UNSET'. Default value: `'UNSET'` -##### `display_name` +##### `display_name` -Data type: `Any` +Data type: `String[1]` -The Display Name of the service. Defaults to the title of -the resource. +The Display Name of the service. Defaults to the title of the resource. Default value: `'UNSET'` -##### `description` +##### `description` -Data type: `Any` +Data type: `String[1]` -A description of the service +A description of the service. String value set to 'UNSET' by default. Default value: `'UNSET'` -##### `command` +##### `command` -Data type: `Any` +Data type: `String[1]` -The command to execute +The command to execute. Set to 'UNSET' by default. Default value: `'UNSET'` -##### `start` +##### `start` -Data type: `Any` +Data type: `Enum['automatic', 'manual', 'disabled', 'UNSET']` The starting mode of the service. (Note, the native service resource can also be used to manage this setting.) -[ automatic, manual, disabled ] +Valid values: 'automatic', 'manual', 'disabled' Default value: `'UNSET'` -### `registry::value` +### `registry::value` Actions: - Manage the parent key if not already managed. @@ -126,18 +125,18 @@ class myapp { The following parameters are available in the `registry::value` defined type: -* [`key`](#key) -* [`value`](#value) -* [`type`](#type) -* [`data`](#data) +* [`key`](#-registry--value--key) +* [`value`](#-registry--value--value) +* [`type`](#-registry--value--type) +* [`data`](#-registry--value--data) -##### `key` +##### `key` Data type: `Pattern[/^\w+/]` The path of key the value will placed inside. -##### `value` +##### `value` Data type: `Optional[String]` @@ -145,9 +144,9 @@ The name of the registry value to manage. This will be copied from the resource title if not specified. The special value of '(default)' may be used to manage the default value of the key. -Default value: ``undef`` +Default value: `undef` -##### `type` +##### `type` Data type: `Pattern[/^\w+/]` @@ -157,17 +156,21 @@ The type the registry value. Defaults to 'string'. See the output of Default value: `'string'` -##### `data` +##### `data` + +Data type: -Data type: `Optional[Variant[ +```puppet +Optional[Variant[ String, Numeric, Array[String] - ]]` + ]] +``` The data to place inside the registry value. -Default value: ``undef`` +Default value: `undef` ## Resource types @@ -191,26 +194,26 @@ Default value: `present` The following parameters are available in the `registry_key` type. -* [`path`](#path) -* [`provider`](#provider) -* [`purge_values`](#purge_values) +* [`path`](#-registry_key--path) +* [`provider`](#-registry_key--provider) +* [`purge_values`](#-registry_key--purge_values) -##### `path` +##### `path` The path to the registry key to manage -##### `provider` +##### `provider` The specific backend to use for this `registry_key` resource. You will seldom need to specify this --- Puppet will usually discover the appropriate provider for your platform. -##### `purge_values` +##### `purge_values` -Valid values: ``true``, ``false`` +Valid values: `true`, `false` Common boolean for munging and validation. -Default value: ``false`` +Default value: `false` ### `registry_value` @@ -244,14 +247,14 @@ Default value: `string` The following parameters are available in the `registry_value` type. -* [`path`](#path) -* [`provider`](#provider) +* [`path`](#-registry_value--path) +* [`provider`](#-registry_value--provider) -##### `path` +##### `path` The path to the registry value to manage. -##### `provider` +##### `provider` The specific backend to use for this `registry_value` resource. You will seldom need to specify this --- Puppet will usually discover the appropriate provider for your platform. diff --git a/metadata.json b/metadata.json index 2edaedc..0192610 100644 --- a/metadata.json +++ b/metadata.json @@ -1,6 +1,6 @@ { "name": "puppetlabs-registry", - "version": "4.1.1", + "version": "4.1.2", "author": "puppetlabs", "summary": "This module provides a native type and provider to manage keys and values in the Windows Registry", "license": "Apache-2.0",