Manage instance groups
It is recommended to regularly monitor and manage log storage usage to keep it below 80%.
In KakaoCloud’s Alert Center, you can set alerts based on disk usage and utilization rate.
When log storage usage exceeds 80%, the PostgreSQL detail view provides a guide to expand volumes.
If storage usage exceeds acceptable levels, archive logs will be deleted in chronological order to maintain service stability.
Create PostgreSQL instance group
A PostgreSQL instance group manages the lifecycle of instances and backups. It has various status values including running and terminated states, which can be viewed and managed by users.
To create an instance group in the PostgreSQL service:
- If instance group creation fails due to unexpected causes such as network errors or lack of resources, check the logs in Cloud Trail.
- Even if you expand volumes after creating an instance group, the maximum IOPS is fixed at the initially specified value. To ensure stable performance, set an appropriate volume size at creation.
-
Go to the KakaoCloud Console > Data Store > PostgreSQL.
-
Click the [Create instance group] button.
-
Fill in the required information and click [Create].
Item Category Description Basic settings Instance group name Name of the PostgreSQL instance group
- Must be unique within the same project
- Example: PostgreSQL-instance-01Description (optional) Optional description up to 100 characters Instance availability High availability (Primary + Standby) Creates a primary instance and multiple standby instances
- Supports single or multi-AZSingle (Primary only) Creates only one primary instance
- Single AZ onlyPostgreSQL settings Engine version Automatically selected version of PostgreSQL
- Currently provides version14.14
Primary port Port for communication with primary instance (1024–65535)
- Default:5432
Standby port Port for communication with standby instance (required for HA)
- Default:5433
ID PostgreSQL database user account ID
- Example: admin
* Reserved IDs such as root, postgres, rewind, replication, orafce_set_umask, plprofiler are not allowedPassword Initial password for the PostgreSQL database user
- Format: 8–16 characters
- Cannot include space,/
,'
,"
,@
⚠️ Password can be changed after database startup
⚠️ Passwords changed after startup cannot be retrievedInstance type Select the instance type for computing resources
- See Instance types for detailsBase storage SSD Configure volume type and size
- Type: Only SSD currently supported
- Size: 100 GB–16,384 GB
* Minimum size may vary depending on instance typeLog storage SSD Storage for database logs. Cannot be changed after creation.
- Type: Only SSD supported
- Size: 100 GB–16,384 GB
* Minimum size may vary depending on instance typeNetwork settings Multi-AZ option Option available when HA is selected. Set subnets and number of instances per AZ VPC Select the network (VPC) for PostgreSQL instances Subnet and instance count Specify subnets for primary and standby instances and the number of instances
- Up to 6 instances per group
- At least 2 standby instances are recommended for redundancySecurity group Create or select security groups to apply
- Multiple selections allowed
For more on instance groups, see Instance group.
User accounts in instance groups
When creating a PostgreSQL instance group, the user can specify a custom ID and password to generate a database user account.
This account has Admin
privileges and can access resources after authentication. The roles and privileges are as follows:
- Accounts with reserved IDs (
root
,postgres
,replication
,rewind
,orafce_set_umask
,plprofiler
) cannot be created. - If the replication account is deleted, HA mode may fail to function properly.
Type | Privileges |
---|---|
User account | Create role, Create DB, Bypass RLS, Password valid until infinity |
Connect to PostgreSQL instance group
To connect an instance to a PostgreSQL instance group, use PostgreSQL Client after the group and instance are created.
In case of automatic or manual failover, or restarts, the primary instance may change, resulting in momentary connection disruption due to changes in internal endpoint mappings.
Prerequisites
To connect to a PostgreSQL instance group, ensure a VM instance exists within the same network and that the endpoint of the PostgreSQL group is accessible.
Allow custom ports (1024–65535) or default PostgreSQL ports (Primary: 5432, Standby: 5433) in the associated security group.
Connect instance
You can now connect to the PostgreSQL instance.
-
Refer to Virtual Machine > Create and connect to instance to set up a VM and install PostgreSQL Client if not already available.
-
Go to the KakaoCloud Console > Data Store > PostgreSQL.
-
From the Instance group menu, select the instance group to connect.
-
In the Details tab, copy the Endpoint and User ID.
-
From the VM, use the following PostgreSQL connection commands:
PostgreSQL connection method 1$ PGPASSWORD={USER_PASSWORD} psql -h {ENDPOINT} -U {USER_ID} -d {DATABASE} -p {PORT}
PostgreSQL connection method 2$ psql postgres://{USER_ID}:{USER_PASSWORD}@{ENDPOINT}:{PORT}/{DATABASE}
Item Description {USER_ID}
DB administrator account ID used to connect {USER_PASSWORD}
Password for the above user ID (set during creation) {ENDPOINT}
Endpoint retrieved from Details tab {DATABASE}
Name of the database to connect to
- Default ispostgres
unless user created another database{PORT}
Port configured during instance group creation
- Default: Primary 5432, Standby 5433
Manage instance groups
Describes how to manage active PostgreSQL instances and groups.
View instance group list
You can view a list of currently running PostgreSQL instance groups.
-
Go to the KakaoCloud Console > Data Store > PostgreSQL.
-
View the list from the Instance group menu.
Item Description Instance group name Name entered at creation
- Click to view detailsStatus Instance group status
- See Instance group for detailsEngine version PostgreSQL version selected during creation Instance type Type selected during creation Availability Availability mode selected Multi-AZ Whether multi-AZ is enabled Created at Date and time of creation Created by User who first created the instance [More options] Expand volume, Delete, Manual failover, Create backup
View instance group details
You can view details for a PostgreSQL instance group.
- Go to the KakaoCloud Console > Data Store > PostgreSQL.
- From the Instance group menu, select the desired group.
- View the detailed information of that group.
Expand instance group volumes
You can expand volumes up to 16TB (16,384 GB) for both base and log storage.
Volume expansion only increases disk space. Maximum IOPS does not increase. IOPS scaling based on size will be supported in the future.
- Go to the KakaoCloud Console > Data Store > PostgreSQL.
- From the Instance group menu, click [More options] > Expand volume.
- Enter the new size for base or log storage and click [Confirm].
Delete instance group
You can delete PostgreSQL instance groups that are no longer needed.
All instances will be shut down and released. Billing stops once the group is deleted.
Once deleted, all instance resources and backups in the PostgreSQL instance group are permanently removed and cannot be recovered.
- Go to the KakaoCloud Console > Data Store > PostgreSQL.
- From the Instance group menu, click [More options] > Delete for the target group.
- Fill in the required information in the Delete popup and click [Delete].