(PE-41176) make migrate plan public

Author: davidmalloncares

REFERENCE.md

@@ -111,6 +111,7 @@ Supported use cases:
 * [`peadm::backup_ca`](#peadm--backup_ca)
 * [`peadm::convert`](#peadm--convert): Convert an existing PE cluster to a PEAdm-managed cluster
 * [`peadm::install`](#peadm--install): Install a new PE cluster
+* [`peadm::migrate`](#peadm--migrate): Migrate a PE installation to new host(s)
 * [`peadm::modify_certificate`](#peadm--modify_certificate): Modify the certificate of one or more targets
 * [`peadm::replace_failed_postgresql`](#peadm--replace_failed_postgresql): Replaces a failed PostgreSQL host
 * [`peadm::restore`](#peadm--restore): Restore puppet primary configuration
@@ -122,7 +123,6 @@ Supported use cases:
 #### Private Plans
 
 * `peadm::convert_compiler_to_legacy`
-* `peadm::migrate`: Migrate a PE primary server to a new host - Note: this plan is a work in progress and it
 * `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
@@ -2361,6 +2361,65 @@ Data type: `String`
 
 Default value: `'1y'`
 
+### <a name="peadm--migrate"></a>`peadm::migrate`
+
+Migrate a PE installation to new host(s)
+
+#### Parameters
+
+The following parameters are available in the `peadm::migrate` plan:
+
+* [`old_primary_host`](#-peadm--migrate--old_primary_host)
+* [`new_primary_host`](#-peadm--migrate--new_primary_host)
+* [`upgrade_version`](#-peadm--migrate--upgrade_version)
+* [`replica_host`](#-peadm--migrate--replica_host)
+* [`primary_postgresql_host`](#-peadm--migrate--primary_postgresql_host)
+* [`replica_postgresql_host`](#-peadm--migrate--replica_postgresql_host)
+
+##### <a name="-peadm--migrate--old_primary_host"></a>`old_primary_host`
+
+Data type: `Peadm::SingleTargetSpec`
+
+The existing PE primary server that will be migrated from
+
+##### <a name="-peadm--migrate--new_primary_host"></a>`new_primary_host`
+
+Data type: `Peadm::SingleTargetSpec`
+
+The new server that will become the PE primary server
+
+##### <a name="-peadm--migrate--upgrade_version"></a>`upgrade_version`
+
+Data type: `Optional[String]`
+
+Optional version to upgrade to after migration is complete
+
+Default value: `undef`
+
+##### <a name="-peadm--migrate--replica_host"></a>`replica_host`
+
+Data type: `Optional[Peadm::SingleTargetSpec]`
+
+Optional new replica server to be added to the cluster
+
+Default value: `undef`
+
+##### <a name="-peadm--migrate--primary_postgresql_host"></a>`primary_postgresql_host`
+
+Data type: `Optional[Peadm::SingleTargetSpec]`
+
+Optional new primary PostgreSQL server to be added to the cluster
+
+Default value: `undef`
+
+##### <a name="-peadm--migrate--replica_postgresql_host"></a>`replica_postgresql_host`
+
+Data type: `Optional[Peadm::SingleTargetSpec]`
+
+Optional new replica PostgreSQL server to be added to the cluster
+
+Default value: `undef`
+
 ### <a name="peadm--modify_certificate"></a>`peadm::modify_certificate`
 
 Certificates can be modified by adding extensions, removing extensions, or

plans/add_compilers.pp

@@ -25,7 +25,9 @@
   # Get current peadm config to determine where to setup additional rules for
   # compiler's secondary PuppetDB instances
   $peadm_config = run_task('peadm::get_peadm_config', $primary_target).first.value
-
+  #output peadm_config
+  out::message("peadm_config is ${peadm_config}")
+  out::message("param is ${peadm_config['params']}")
   if $primary_postgresql_host == undef {
     # get the external PostgreSQL host for the specified availability group
     $external_postgresql_host = $avail_group_letter ? {

plans/migrate.pp

@@ -1,6 +1,4 @@
-# @api private
-# @summary Migrate a PE primary server to a new host - Note: this plan is a work in progress and it 
-# is not recommended to be used until it is fully implemented and supported
+# @summary Migrate a PE installation to new host(s)
 #
 # @param old_primary_host
 #   The existing PE primary server that will be migrated from
@@ -23,7 +21,6 @@
   Optional[Peadm::SingleTargetSpec] $replica_postgresql_host = undef,
 ) {
   # pre-migration checks
-  out::message('This plan is a work in progress and it is not recommended to be used until it is fully implemented and supported')
   peadm::assert_supported_bolt_version()
   if $upgrade_version and $upgrade_version != '' and !empty($upgrade_version) {
     $permit_unsafe_versions = false

plans/replace_failed_postgresql.pp

@@ -25,6 +25,7 @@
 
   # Get current peadm config before making modifications
   $peadm_config = run_task('peadm::get_peadm_config', $primary_host).first.value
+  out::message("peadm_config is ${peadm_config}")
   $compilers = $peadm_config['params']['compilers']
 
   # Bail if we are not running this against an XL deployment with DR enabled - the parameters also enforce this to some extent