---
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-juju-details
---

# 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/)

# Juju tech details

[Juju](https://juju.is/) is an open source orchestration engine for software operators that enables the deployment, integration and lifecycle management of applications at any scale, on any infrastructure using charms.

This [charm](https://charmhub.io/pgbouncer-k8s) is an operator - business logic encapsulated in reusable software packages that automate every aspect of an application’s life. Charms are shared via [CharmHub](https://charmhub.io/).

See also:

* [Juju Documentation](https://juju.is/docs/juju) and [Blog](https://ubuntu.com/blog/tag/juju)
* [Charm SDK](https://juju.is/docs/sdk)

## [Breaking changes between Juju 2.9.x and 3.x](https://charmhub.io/pgbouncer-k8s/docs/e-juju-details#p-28321-breaking-changes-between-juju-29x-and-3x)

As this charm documentation is written for Juju 3.x, users of 2.9.x will encounter noteworthy changes when following the instructions. This section explains those changes.

Breaking changes have been introduced in the Juju client between versions 2.9.x and 3.x. These are caused by the renaming and re-purposing of several commands - functionality and command options remain unchanged.

In the context of this guide, the pertinent changes are shown here:

| 2.9.x | 3.x |
| --- | --- |
| **add-relation** | **integrate** |
| **relate** | **integrate** |
| **run** | **exec** |
| **run-action --wait** | **run** |

See the [Juju 3.0 release notes](https://juju.is/docs/juju/roadmap#heading--juju-3-0-0---22-oct-2022) for the comprehensive list of changes.

The response is to therefore substitute the documented command with the equivalent 2.9.x command. For example:

### [Juju 3.x:](https://charmhub.io/pgbouncer-k8s/docs/e-juju-details#p-28321-juju-3x)

```
juju integrate pgbouncer-k8s:database postgresql-test-app

juju run postgresql-k8s/leader get-password
```

### [Juju 2.9.x:](https://charmhub.io/pgbouncer-k8s/docs/e-juju-details#p-28321-juju-29x)

```
juju relate pgbouncer-k8s:database postgresql-test-app

juju run-action --wait postgresql-k8s/leader get-password
```

> [The document based on OpenStack guide.](https://docs.openstack.org/charm-guide/latest/project/support-notes.html#breaking-changes-between-juju-2-9-x-and-3-x)

---