PgBouncer カスタム リソース定義

仕様スキーマ

PgBouncer Spec は、PgBouncer の選択された状態を定義します。

PgBouncer:
  metadata:
    name: string
  spec:
    accessMode: string
    allowSuperUserAccess: boolean
    dbclusterRef: string
    parameters: object
    port: integer
    serverTLS:
      certSecret:
        name: string

フィールド

タイプ
必須または省略可

 

説明
name
string
必須
PgBouncer リソースの名前。
accessMode
string
省略可
PgBouncer 接続の rw(読み取り / 書き込み)または ro(読み取り専用)アクセスモードを定義します。デフォルト値は rw です。
allowSuperUserAccess
boolean
省略可
allowSuperUserAccess は true または false に設定できます。
dbclusterRef
string
必須
dbclusterRef は、PgBouncer がその接続をプールする DBCluster の名前です。参照先の DBCluster と同じ Namespace に PgBouncer オブジェクトを作成する必要があります。このフィールドは、PgBouncer 接続プーリングに必須です。
parameters
object
省略可
PgBouncer 構成の Key-Value ペアを指定します。すべての値を引用符で囲みます(例: default_pool_size: "20")。使用可能なオプションの詳細については、PgBouncer 構成のドキュメントをご覧ください。よく使用されるパラメータは次のとおりです。
  • pool_mode: データベース接続を他のクライアントで再利用できるタイミングを指定します。
  • default_pool_size: ユーザーとデータベースのペアごとに許可するデータベース接続の最大数
  • max_client_conn: クライアント接続の最大数
  • max_db_connections: データベース接続の最大数
port
integer
省略可
PgBouncer が受信接続をリッスンするポートを指定します。デフォルト値は 6432 です。
serverTLS
object
省略可
serverTLS は、PgBouncer が認証情報の取得のためにデータベース クラスタに接続する際に使用する暗号化された通信の証明書 Secret を定義します。
serverTLS.certSecret
object
省略可
CertSecret は、同じ Namespace 内の証明書 Secret を参照します。この Secret には、ca.crt(CA 証明書)、tls.key(秘密鍵)、tls.crt(リーフ証明書)のエントリが含まれている必要があります。この Secret 内の値は、pgbouncer.ini ファイルの server_tls_ca_file、server_tls_cert_file、server_tls_key_file 構成の入力に使用されます。CA 証明書は、データベース クラスタのリーフ証明書に署名した CA と一致している必要があります。リーフ証明書には、CommonName "alloydbpgbouncer"。 が含まれている必要があります。
serverTLS.certSecret.name
string
省略可
参照先の名前。

ステータス スキーマ

PgBouncer Status は、PgBouncer の観測された状態を定義します。

endpoints:
  - name: string
    value: string
phase: string
port: integer

フィールド

タイプ
必須または省略可

 

説明
endpoints
array of objects
省略可
endpoints には、このインスタンスにアクセスできるすべてのエンドポイントが含まれます。
endpoints.name
string
必須
Name はエンドポイントの名前です(例: Read-Write)。
endpoints.value
string
必須
Value には、インスタンスに接続してアクセスするためのエンドポイント情報が含まれます。
phase
string
必須
phase は、PgBouncer デプロイのステータスを表します。WaitingForDeploymentReady、Acquiring IP、Ready などの値が表示されます。
port
integer
省略可
接続用に PgBouncer によって公開されるポート番号。