アプリケーションから接続する ============================ アプリケーションは、同じKubernetesクラスター内のCloudNativePGによって作成されたサービスと動作することになっています。 - ``[cluster name]-rw`` - ``[cluster name]-ro`` - ``[cluster name]-r`` これらのサービスはKubernetesクラスターによって完全に管理され、 `Service `_ で説明されている形式の仮想IPを実装します。 .. Hint:: アプリケーションでこれらのサービスを使用し、特定のPostgreSQLインスタンスに直接接続することを強くお勧めします。後者はクラスターの有効期間中に変更される可能性があります。 これらのサービスは、次の方法でアプリケーションで使用できます。 - DNS解決 - 環境変数 PostgreSQLに接続するための資格情報には、オペレーターによって生成されたシークレットを使用できます。 .. Seealso:: 接続プーラーとしてPgBouncerを利用し、アプリケーションとPostgreSQLクラスターの間にアクセスレイヤーを作成する方法については、 :ref:`接続プーリング <接続プーリング>` を参照してください。 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]-superuser`` - ``[cluster name]-app`` 各シークレットには次のものが含まれます。 - ユーザー名 - パスワード - RWサービスへのホスト名 - ポート番号 - データベース名 - 作業用 `.pgpass file `_ - `uri `_ - `jdbc-uri `_ ``-app`` 資格情報は、PostgreSQLクラスターに接続するアプリケーションが使用するもので、データベースを *所有* しているユーザーに対応します。 ``-superuser`` のものは、管理目的でのみ使用されることになっており、 ``postgres`` ユーザーに対応します。