---
title: Charmhub | Deploy PgBouncer K8s using Charmhub - The Open Operator Collection
description: Deploy the latest version of PgBouncer K8s as a Kubernetes Operator on
  any cloud.
url: https://charmhub.io/pgbouncer-k8s/docs/e-events-hooks
---

# PgBouncer K8s

[Canonical](https://charmhub.io/publisher/data-platform "View all packages from Canonical")

* [Canonical](https://charmhub.io/publisher/data-platform "View all packages from Canonical")
* [Databases](https://charmhub.io/?filter=databases)

Platform:

1/stable 593

```
juju deploy pgbouncer-k8s --channel 1/stable --trust
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

---

#### Relevant links

* [Homepage](https://ubuntu.com/data/postgresql)

---

#### Contacts

##### Maintainers

+ [Canonical Data Platform](mailto:data-platform@lists.launchpad.net)

* [Submit a bug](https://github.com/canonical/pgbouncer-k8s-operator/issues)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

# Events and hooks

Detailed information about the charm’s internal behaviour can be found in the charm’s [GitHub wiki](https://github.com/canonical/pgbouncer-k8s-operator/wiki).

It includes flowcharts of events in the charm’s lifecycle, examples of the expected interface resulting from relations (databag contents), and hook flowcharts:

* **Main file:** [**`charm.py`**](https://github.com/canonical/pgbouncer-k8s-operator/wiki/charm.py)
  + [Event flowcharts](https://github.com/canonical/pgbouncer-k8s-operator/wiki/charm.py#event-flow)
    - [Charm startup](https://github.com/canonical/pgbouncer-k8s-operator/wiki/charm.py#charm-startup)
    - [Config updates](https://github.com/canonical/pgbouncer-k8s-operator/wiki/charm.py#config-updates)
    - [Leader updates](https://github.com/canonical/pgbouncer-k8s-operator/wiki/charm.py#leader-updates)
  + [Hook handler flowcharts](https://github.com/canonical/pgbouncer-k8s-operator/wiki/charm.py#hook-handler-flowcharts)
    - [`start`](https://github.com/canonical/pgbouncer-k8s-operator/wiki/charm.py#start-hook)
    - [`pgbouncer-pebble-ready`](https://github.com/canonical/pgbouncer-k8s-operator/wiki/charm.py#pgbouncer-pebble-ready-hook)
    - [`config-changed`](https://github.com/canonical/pgbouncer-k8s-operator/wiki/charm.py#config-changed-hook)
    - [`update-status`](https://github.com/canonical/pgbouncer-k8s-operator/wiki/charm.py#update-status-hook)
* **Relations**
  + [**`backend_database`**](https://github.com/canonical/pgbouncer-k8s-operator/wiki/backend_database-relation)
    - [Example databag contents](https://github.com/canonical/pgbouncer-k8s-operator/wiki/backend_database-relation#expected-interface)
    - [Hook handler flowcharts](https://github.com/canonical/pgbouncer-k8s-operator/wiki/backend_database-relation#hook-handler-flowcharts)
  + [**`database`**](https://github.com/canonical/pgbouncer-k8s-operator/wiki/database-relation)
    - [Example databag contents](https://github.com/canonical/pgbouncer-k8s-operator/wiki/database-relation#expected-interface)
    - [Hook handler flowcharts](https://github.com/canonical/pgbouncer-k8s-operator/wiki/database-relation#hook-handler-flowcharts)
  + [**`db` and `db-admin`**](https://github.com/canonical/pgbouncer-k8s-operator/wiki/db-and-db%E2%80%90admin-relations)
    - [Example databag contents](https://github.com/canonical/pgbouncer-k8s-operator/wiki/db-and-db%E2%80%90admin-relations#expected-interface)
    - [Hook handler flowcharts](https://github.com/canonical/pgbouncer-k8s-operator/wiki/db-and-db%E2%80%90admin-relations#hook-handler-flowcharts)
  + [**`pgb-peers`**](https://github.com/canonical/pgbouncer-k8s-operator/wiki/pgb%E2%80%90peers-relation)
    - [Example databag contents](https://github.com/canonical/pgbouncer-k8s-operator/wiki/pgb%E2%80%90peers-relation#expected-interface)
    - [Hook handler flowcharts](https://github.com/canonical/pgbouncer-k8s-operator/wiki/pgb%E2%80%90peers-relation#hook-handler-flowcharts)

---