Charmed PostgreSQL Documentation

This is a IAAS/VM operator. To deploy on Kubernetes, see Charmed PostgreSQL K8s.

Charmed PostgreSQL documentation

Charmed PostgreSQL is an open-source software operator designed to deploy and operate object-relational databases on IAAS/VM. It packages the powerful database management system PostgreSQL into a charmed operator for deployment with Juju.

This charm offers automated operations management from day 0 to day 2. It is equipped with several features to securely store and scale complicated data workloads, including TLS encryption, backups, monitoring, password rotation, and easy integration with client applications.

Charmed PostgreSQL meets the need of deploying PostgreSQL in a structured and consistent manner while providing flexibility in configuration. It simplifies deployment, scaling, configuration and management of relational databases in large-scale production environments reliably.

This charmed operator is made for anyone looking for a comprehensive database management interface, whether for operating a complex production environment or simply as a playground to learn more about databases and charms.

In this documentation

Tutorials
Get started - a hands-on introduction to using Charmed PostgreSQL operator for new users
How-to guides
Step-by-step guides covering key operations such as scaling, encryption, and restoring backups
Reference
Technical information such as requirements, release notes, and plugins
Explanation
Concepts - discussion and clarification of key topics such as architecture, users, and legacy charms

Project and community

Charmed PostgreSQL is an official distribution of PostgreSQL. It’s an open-source project that welcomes community contributions, suggestions, fixes and constructive feedback.

Licencing & Trademark

The Charmed PostgreSQL Operator is distributed under the Apache Software Licence version 2.0. It depends on PostgreSQL, which is licensed under the PostgreSQL License - a liberal open-source licence similar to the BSD or MIT licences.

PostgreSQL is a trademark or registered trademark of PostgreSQL Global Development Group. Other trademarks are the property of their respective owners.

Navigation

Navigation
Level Path Navlink
1 tutorial Tutorial
2 t-overview Overview
2 t-set-up 1. Set up environment
2 t-deploy 2. Deploy PostgreSQL
2 t-access 3. Access PostgreSQL
2 t-scale 4. Scale replicas
2 t-manage-passwords 5. Manage passwords
2 t-integrate 6. Integrate with other applications
2 t-enable-tls 7. Enable TLS encryption
2 t-clean-up 8. Clean up environment
1 how-to How to
2 h-deploy Deploy
3 h-deploy-sunbeam Sunbeam
3 h-deploy-lxd LXD
3 h-deploy-maas MAAS
3 h-deploy-ec2 AWS EC2
3 h-deploy-gce GCE
3 h-deploy-azure Azure
3 h-deploy-multi-az Multi-AZ
3 h-deploy-terraform Terraform
3 h-deploy-airgapped Air-gapped
2 h-integrate Integrate with another application
2 h-external-access External access
2 h-scale Scale replicas
2 h-enable-tls Enable TLS
2 h-backup Back up and restore
3 h-configure-s3-aws Configure S3 AWS
3 h-configure-s3-radosgw Configure S3 RadosGW
3 h-create-backup Create a backup
3 h-restore-backup Restore a backup
3 h-manage-backup-retention Manage backup retention
3 h-migrate-cluster Migrate a cluster
2 h-monitor Monitoring (COS)
3 h-enable-monitoring Enable monitoring
3 h-enable-alert-rules Enable alert rules
3 h-enable-tracing Enable tracing
2 h-upgrade Minor upgrades
3 h-upgrade-minor Perform a minor upgrade
3 h-rollback-minor Perform a minor rollback
2 h-async Cross-regional async replication
3 h-async-set-up Set up clusters
3 h-async-integrate Integrate with a client app
3 h-async-remove-recover Remove or recover a cluster
2 h-enable-plugins-extensions Enable plugins/extensions
2 h-development Development
3 h-development-integrate Integrate with your charm
3 h-migrate-pgdump Migrate data via pg_dump
3 h-migrate-backup-restore Migrate data via backup/restore
1 reference Reference
2 r-overview Overview
2 r-releases Release Notes
3 r-revision-517-518 Revision 517/518
3 r-revision-467-468 Revision 467/468
3 r-revision-429-430 Revision 429/430
3 r-revision-363 Revision 363
3 r-revision-351 Revision 351
3 r-revision-336 Revision 336
3 r-revision-288 Revision 288
2 r-system-requirements System requirements
2 r-software-testing Software testing
2 r-performance Performance and resources
2 r-troubleshooting Troubleshooting
2 r-plugins-extensions Plugins/extensions
2 r-alert-rules Alert rules
2 r-statuses Statuses
2 r-contacts Contacts
1 explanation Explanation
2 e-architecture Architecture
2 e-interfaces-endpoints Interfaces and endpoints
2 e-users Users
2 e-logs Logs
2 e-juju-details Juju
2 e-legacy-charm Legacy charm
2 e-connection-pooling Connection pooling
1 search Search