Définition de ressource personnalisée PgBouncer

Schéma de spécification

La spécification PgBouncer définit l'état sélectionné de PgBouncer.

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

Champ

Type
Obligatoire ou facultatif

 

Description
name
string
Obligatoire
Nom de la ressource PgBouncer.
accessMode
string
Facultatif
Définit les modes d'accès rw (lecture/écriture) ou ro (lecture seule) pour les connexions PgBouncer. La valeur par défaut est rw.
allowSuperUserAccess
boolean
Facultatif
"AllowSuperUserAccess" peut être défini sur "true" ou "false".
dbclusterRef
string
Obligatoire
"DBClusterRef" est le nom du DBCluster pour lequel PgBouncer regroupe les connexions. Vous devez créer l'objet PgBouncer dans le même espace de noms que le DBCluster auquel il fait référence. Ce champ est obligatoire pour le pooling de connexions PgBouncer.
parameters
object
Facultatif
Spécifie des paires clé-valeur pour les configurations PgBouncer. Placez toutes les valeurs entre guillemets, par exemple default_pool_size: "20". Pour en savoir plus sur les options disponibles, consultez la documentation de configuration de PgBouncer. Les paramètres couramment utilisés incluent les suivants :
  • pool_mode : spécifie quand une connexion de base de données peut être réutilisée par d'autres clients.
  • default_pool_size : nombre maximal de connexions de base de données autorisées par paire utilisateur-base de données
  • max_client_conn : nombre maximal de connexions client
  • max_db_connections : nombre maximal de connexions de base de données
port
integer
Facultatif
Spécifie le port sur lequel PgBouncer écoute les connexions entrantes. La valeur par défaut est 6432.
serverTLS
object
Facultatif
"ServerTLSSpec" définit le secret du certificat pour la communication chiffrée utilisée par PgBouncer pour se connecter au cluster de bases de données afin d'extraire les identifiants d'authentification.
serverTLS.certSecret
object
Facultatif
"CertSecret" fait référence au secret du certificat dans le même espace de noms. Le secret doit contenir les entrées ca.crt (certificat CA), tls.key (clé privée) et tls.crt (certificat d'entité finale). Les valeurs de ce secret sont utilisées pour remplir les configurations server_tls_ca_file, server_tls_cert_file et server_tls_key_file dans le fichier pgbouncer.ini. Le certificat CA doit correspondre à l'autorité de certification qui a signé le certificat d'entité finale du cluster de bases de données. Le certificat d'entité finale doit contenir le CommonName "alloydbpgbouncer".
serverTLS.certSecret.name
string
Facultatif
Nom du référent.

Schéma d'état

L'état PgBouncer définit l'état observé de PgBouncer.

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

Champ

Type
Obligatoire ou facultatif

 

Description
endpoints
array of objects
Facultatif
endpoints contient tous les points de terminaison par lesquels vous pouvez accéder à cette instance.
endpoints.name
string
Obligatoire
Le nom est le nom du point de terminaison, par exemple Read-Write.
endpoints.value
string
Obligatoire
La valeur contient les informations du point de terminaison pour se connecter à l'instance et y accéder.
phase
string
Obligatoire
phase décrit l'état du déploiement PgBouncer. Les valeurs telles que WaitingForDeploymentReady, Acquiring IP et Ready s'affichent ici.
port
integer
Facultatif
Numéro de port exposé par PgBouncer pour les connexions.