Merge pull request #249 from puppetlabs/release-prep

Release prep v3.5.0

Author: reidmv

CHANGELOG.md

@@ -2,6 +2,21 @@
 
 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).
 
+## [v3.5.0](https://github.com/puppetlabs/puppetlabs-peadm/tree/v3.5.0) (2022-04-13)
+
+[Full Changelog](https://github.com/puppetlabs/puppetlabs-peadm/compare/v3.4.0...v3.5.0)
+
+### Added
+
+- Add support for SLES 12 [\#245](https://github.com/puppetlabs/puppetlabs-peadm/pull/245) ([MartyEwings](https://github.com/MartyEwings))
+- Add `peadm::add_database` plan [\#241](https://github.com/puppetlabs/puppetlabs-peadm/pull/241) ([ody](https://github.com/ody))
+- Add experimental `peadm::util::code_sync_status` plan [\#221](https://github.com/puppetlabs/puppetlabs-peadm/pull/221) ([reidmv](https://github.com/reidmv))
+
+### Fixed
+
+- Fix json escaping in `bash_task_helper` [\#246](https://github.com/puppetlabs/puppetlabs-peadm/pull/246) ([reidmv](https://github.com/reidmv))
+- Fix load balancer bug in `peadm::get_peadm_config` task [\#244](https://github.com/puppetlabs/puppetlabs-peadm/pull/244) ([reidmv](https://github.com/reidmv))
+
 ## [v3.4.0](https://github.com/puppetlabs/puppetlabs-peadm/tree/v3.4.0) (2022-03-08)
 
 [Full Changelog](https://github.com/puppetlabs/puppetlabs-peadm/compare/v3.3.0...v3.4.0)

REFERENCE.md

@@ -76,6 +76,7 @@
 
 #### Public Plans
 
+* [`peadm::add_database`](#peadmadd_database)
 * [`peadm::backup`](#peadmbackup): Backup the core user settings for puppet infrastructure
 * [`peadm::convert`](#peadmconvert): Convert an existing PE cluster to a PEAdm-managed cluster
 * [`peadm::install`](#peadminstall): Install a new PE cluster
@@ -92,13 +93,21 @@ Supported use cases:
    The new replica should have the same certname as the broken one.
 * `peadm::misc::divert_code_manager`: This plan exists to account for a scenario where a PE XL
 * `peadm::modify_cert_extensions`
+* `peadm::subplans::component_install`: Install a new PEADM component
 * `peadm::subplans::configure`: Configure first-time classification and DR setup
+* `peadm::subplans::db_populate`: Destructively (re)populates a new or existing database with the contents or a known good source
 * `peadm::subplans::install`: Perform initial installation of Puppet Enterprise Extra Large
 * `peadm::subplans::modify_certificate`
+* `peadm::subplans::prepare_agent`
 * `peadm::uninstall`: Single-entry-point plan for uninstalling Puppet Enterprise
+* `peadm::util::code_sync_status`
+* `peadm::util::db_disable_pglogical`
+* `peadm::util::db_purge`
 * `peadm::util::insert_csr_extension_requests`
 * `peadm::util::retrieve_and_upload`
 * `peadm::util::sanitize_pg_pe_conf`
+* `peadm::util::update_classification`: Configure classification
+* `peadm::util::update_db_setting`: Make updates to PuppetDB database settings
 
 ## Classes
 
@@ -1226,6 +1235,53 @@ Which port to query the status API on
 
 ## Plans
 
+### <a name="peadmadd_database"></a>`peadm::add_database`
+
+The peadm::add_database class.
+
+#### Parameters
+
+The following parameters are available in the `peadm::add_database` plan:
+
+* [`targets`](#targets)
+* [`primary_host`](#primary_host)
+* [`mode`](#mode)
+* [`begin_at_step`](#begin_at_step)
+
+##### <a name="targets"></a>`targets`
+
+Data type: `Peadm::SingleTargetSpec`
+
+
+
+##### <a name="primary_host"></a>`primary_host`
+
+Data type: `Peadm::SingleTargetSpec`
+
+
+
+##### <a name="mode"></a>`mode`
+
+Data type: `Optional[Enum['init', 'pair']]`
+
+
+
+Default value: ``undef``
+
+##### <a name="begin_at_step"></a>`begin_at_step`
+
+Data type: `Optional[Enum[
+    'init-db-node',
+    'replicate-db',
+    'update-classification',
+    'update-db-settings',
+    'cleanup-db',
+    'finalize']]`
+
+
+
+Default value: ``undef``
+
 ### <a name="peadmbackup"></a>`peadm::backup`
 
 This plan can backup data as outlined at insert doc

metadata.json

@@ -1,6 +1,6 @@
 {
   "name": "puppetlabs-peadm",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "author": "puppetlabs",
   "summary": "Bolt plans used to deploy an at-scale Puppet Enterprise architecture",
   "license": "Apache-2.0",

plans/subplans/prepare_agent.pp

@@ -1,3 +1,4 @@
+# @api private
 plan peadm::subplans::prepare_agent (
   Peadm::SingleTargetSpec $targets,
   Peadm::SingleTargetSpec $primary_host,

plans/util/db_disable_pglogical.pp

@@ -1,3 +1,4 @@
+# @api private
 plan peadm::util::db_disable_pglogical(
   Peadm::SingleTargetSpec $targets,
   Array[String[1]]        $databases,

plans/util/db_purge.pp

@@ -1,3 +1,4 @@
+# @api private
 plan peadm::util::db_purge(
   TargetSpec       $targets,
   Array[String[1]] $databases,