アプリケーションから接続する

アプリケーションは、同じKubernetesクラスター内のCloudNativePGによって作成されたサービスと動作することになっています。

  • [cluster name]-rw - [cluster name]-ro - [cluster name]-r

これらのサービスはKubernetesクラスターによって完全に管理され、

Service で説明されている形式の仮想IPを実装します。

ヒント

アプリケーションでこれらのサービスを使用し、特定のPostgreSQLインスタンスに直接接続することを強くお勧めします。後者はクラスターの有効期間中に変更される可能性があります。

これらのサービスは、次の方法でアプリケーションで使用できます。

  • DNS解決 - 環境変数

PostgreSQLに接続するための資格情報には、オペレーターによって生成されたシークレットを使用できます。

参考

接続プーラーとしてPgBouncerを利用し、アプリケーションとPostgreSQLクラスターの間にアクセスレイヤーを作成する方法については、 接続プーリング を参照してください。

DNS解決

Kubernetes DNSサービスを使用して、特定のサーバーをポイントできます。オペレーターにはKubernetes DNSサービスが必要です。アプリケーションがPostgreSQLクラスターと同じ名前空間に展開されている場合、サービスの名前を使用してこれを行うことができます。 PostgreSQLクラスターが別の名前空間にある場合、完全な修飾子service-name.namespace-name を使用できます。

DNSが優先および推奨される検出方法です。

環境変数

PostgreSQLクラスターが含まれる同じ名前空間にアプリケーションを展開する場合、環境変数を使用してデータベースに接続することもできます。

たとえば、PostgreSQLクラスターの名前がpg-database であるとすると、アプリケーションで次の環境変数を使用できます。

  • PG_DATABASE_R_SERVICE_HOST 読み取り専用ワークロードのすべてのPostgreSQLインスタンスを指すサービスのIPアドレス

  • PG_DATABASE_RO_SERVICE_HOST クラスターのすべてのホットスタンバイレプリカをポイントするサービスのIPアドレス

  • PG_DATABASE_RW_SERVICE_HOST クラスターの プライマリ インスタンスを指すサービスのIPアドレス

シークレット

PostgreSQLオペレーターは、展開するPostgreSQLクラスターごとに最大2つのbasic-auth タイプシークレットを生成します。

  • [cluster name]-app .spec.bootstrap.initdb.secret.name を介して既存のシークレットを提供していない場合

各シークレットには次のものが含まれます。

  • ユーザー名 - パスワード - RWサービスへのホスト名 - ポート番号 - データベース名 - 作業用 .pgpass file

  • uri

  • jdbc-uri

-app 資格情報は、PostgreSQLクラスターに接続するアプリケーションが使用するもので、データベースを 所有 しているユーザーに対応します。

-superuser のものは、管理目的でのみ使用されることになっており、 postgres ユーザーに対応します。バージョン1.21以降、ネットワーク上のスーパーユーザーのアクセスはデフォルトで無効になっています。