Links

postgres_cluster

Type representing a Ionoscloud DBaaS Postgres Cluster.

Parameters:

Name
Required
Description
display_name
true
The name of the Postgres Cluster.

Properties:

Name
Required
Description
ensure
No
The basic property that the resource should be in. Valid values are present, absent.
restore
No
If true, restore the Cluster to the backup specified by backup_id and the time specified by recovery_target_time. Valid values are true, false.
postgres_version
Yes
The Postgres version of the Postgres Cluster.
maintenance_day
No
The maintenance day of the Postgres Cluster.
maintenance_time
No
The maintenance time of the Postgres Cluster.
instances
Yes
The total number of instances in the cluster (one master and n-1 standbys).
cores_count
Yes
The number of CPU cores assigned to the instances.
ram_size
Yes
The amount of RAM in MB assigned to the instances.
storage_size
Yes
The size of the volume in GB.
storage_type
Yes
The volume type.
location
Yes
The Postgres Cluster location.
backup_location
No
The S3 location where the backups will be stored.
synchronization_mode
Yes
Represents different modes of replication.
connections
Yes
An array of connections to the Postgres Cluster.
db_username
Yes
The username for the initial postgres user. Some system usernames are restricted (e.g. "postgres", "admin", "standby")
db_password
No
The password for the initial postgres user.
backup_id
No
ID of a backup for the Cluster
recovery_target_time
No
Recovery target time
id
No
The ID of the Postgres Cluster.
state
No
The state of the Postgres Cluster.
backups
No
A list of backups that exist in the Postgres Cluster.
available_postgres_vesions
No
A list of Postgres Versions available for the Postgres Cluster.
***

Changeable properties:

  • cores_count
  • ram_size
  • storage_size
  • maintenance_time
  • maintenance_day
  • postgres_version
  • instances

Examples

To list resources:

puppet resource postgres_cluster
NOTE: If two resources have the same name only one of them will be shown.

To create, update or delete a resource:

$datacenter_name = 'testdc1'
$lan_name = 1
postgres_cluster { 'test' :
ensure => present,
restore => false,
instances => 1,
postgres_version => '12',
cores_count => 1,
ram_size => 2048,
storage_size => 20490,
storage_type => 'HDD',
synchronization_mode => 'ASYNCHRONOUS',
location => 'de/fra',
backup_location => 'eu-central-2',
connections => [
'datacenter' => $datacenter_name,
'lan' => $lan_name,
'cidr' => '192.168.1.108/24',
],
db_username => 'test',
db_password => '7357cluster',
}
NOTE: If two resources with the same name ar found an error will be thrown, this only applies to cases where the resource cannot be identified. Example: an error is thrown for two servers with the same name in the same datacenter, not for two servers with the same name, but in different datacenters.