Skip to main content

Your submission was sent successfully! Close

Thank you for signing up for our newsletter!
In these regular emails you will find the latest updates from Canonical and upcoming events where you can meet our team.Close

Thank you for contacting us. A member of our team will be in touch shortly. Close

Deploy on Juju spaces

The Charmed PostgreSQL operator supports Juju spaces to separate network traffic for:

  • Client - PostgreSQL instance to client data
  • Instance-replication - cluster instances replication data
  • Cluster-replication - cluster to cluster replication data
  • Backup - backup and restore data

Prerequisites

Deploy

On application deployment, constraints are required to ensure the unit(s) have address(es) on the specified network space(s), and endpoint binding(s) for the space(s).

For example, with spaces configured for instance replication and client traffic:

❯ juju spaces
Name      Space ID  Subnets
alpha     0         10.163.154.0/24
client    1         10.0.0.0/24
peers     2         10.10.10.0/24

The space alpha is default and cannot be removed. To deploy Charmed PostgreSQL Operator using the spaces:

juju deploy postgresql --channel 16/edge \
  --constraints spaces=client,peers \
  --bind "database-peers=peers database=client"

Currently there’s no support for the juju bind command. Network space binding must be defined at deploy time only.

Consequently, a client application must use the client space on the model, or a space for the same subnet in another model, for example:

juju deploy client-app \
  --constraints spaces=client \
  --bind database=client

The two application can be then related using:

juju integrate postgresql:database client-app:database

The client application will receive network endpoints on the 10.0.0.0/24 subnet.

The Charmed PostgreSQL operator endpoints are:

Endpoint Traffic
database Client
database-peers Instance-replication
replication-offer, replication Cluster-replication
s3-parameters Backup

If using a network space for the backup traffic, the user is responsible for ensuring that the target object storage URL traffic is routed via the specified network space.

Last updated 23 hours ago. Help improve this document in the forum.