Definición de recurso personalizado de PgBouncer

Esquema de especificación

La especificación de PgBouncer define el estado seleccionado de PgBouncer.

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

Campo

Tipo
Obligatorio u opcional

 

Descripción
name
string
Obligatorio
Es el nombre del recurso de PgBouncer.
accessMode
string
Opcional
Define los modos de acceso rw (lectura y escritura) o ro (solo lectura) para las conexiones de PgBouncer. El valor predeterminado es rw.
allowSuperUserAccess
boolean
Opcional
AllowSuperUserAccess se puede configurar como verdadero o falso.
dbclusterRef
string
Obligatorio
DBClusterRef es el nombre de DBCluster para el que PgBouncer agrupa las conexiones. Debes crear el objeto PgBouncer en el mismo espacio de nombres que el DBCluster al que hace referencia. Este campo es obligatorio para la agrupación de conexiones de PgBouncer.
parameters
object
Opcional
Especifica pares clave-valor para las configuraciones de PgBouncer. Encierra todos los valores entre comillas, por ejemplo, default_pool_size: "20". Para obtener más información sobre las opciones disponibles, consulta la documentación de configuración de PgBouncer. Los parámetros de uso frecuente incluyen los siguientes:
  • pool_mode: Especifica cuándo otros clientes pueden reutilizar una conexión de base de datos.
  • default_pool_size: Es la cantidad máxima de conexiones de base de datos que se permiten por par de usuario y base de datos.
  • max_client_conn: Es la cantidad máxima de conexiones de cliente.
  • max_db_connections: Es la cantidad máxima de conexiones de base de datos.
port
integer
Opcional
Especifica el puerto en el que PgBouncer escucha las conexiones entrantes. El valor predeterminado es 6432.
serverTLS
object
Opcional
ServerTLSSpec define el secreto del certificado para la comunicación encriptada que usa PgBouncer para conectarse al clúster de base de datos y recuperar las credenciales de autenticación.
serverTLS.certSecret
object
Opcional
CertSecret hace referencia al secreto del certificado dentro del mismo espacio de nombres. El secreto debe contener las entradas ca.crt (certificado de la AC), tls.key (clave privada) y tls.crt (certificado de hoja). Los valores dentro de este secreto se usan para propagar las configuraciones server_tls_ca_file, server_tls_cert_file y server_tls_key_file en el archivo pgbouncer.ini. El certificado de la AC debe coincidir con la AC que firmó el certificado de hoja del clúster de base de datos. El certificado de hoja debe contener el CommonName "alloydbpgbouncer".
serverTLS.certSecret.name
string
Opcional
Es el nombre del referente.

Esquema de estado

El estado de PgBouncer define el estado observado de PgBouncer.

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

Campo

Tipo
Obligatorio u opcional

 

Descripción
endpoints
array of objects
Opcional
endpoints contiene todos los extremos a través de los cuales puedes acceder a esta instancia.
endpoints.name
string
Obligatorio
Name es el nombre del extremo, por ejemplo, Read-Write.
endpoints.value
string
Obligatorio
Value contiene la información del extremo para conectarse y acceder a la instancia.
phase
string
Obligatorio
phase describe el estado de la implementación de PgBouncer. Aquí aparecen valores como WaitingForDeploymentReady, Acquiring IP y Ready.
port
integer
Opcional
Es el número de puerto que expone PgBouncer para las conexiones.