Definição de recurso personalizado do PgBouncer

Esquema de especificação

A especificação do PgBouncer define o estado selecionado do PgBouncer.

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

Campo

Tipo
Obrigatório ou opcional

 

Descrição
name
string
Obrigatório
Nome do recurso do PgBouncer.
accessMode
string
Opcional
Define os modos de acesso rw (leitura/gravação) ou ro (somente leitura) para conexões do PgBouncer. O valor padrão é rw.
allowSuperUserAccess
boolean
Opcional
AllowSuperUserAccess pode ser definido como verdadeiro ou falso.
dbclusterRef
string
Obrigatório
DBClusterRef é o nome do DBCluster para o qual o PgBouncer agrupa as conexões. É necessário criar o objeto do PgBouncer no mesmo namespace do DBCluster a que ele faz referência. Esse campo é obrigatório para o pool de conexões de PgBouncer.
parameters
object
Opcional
Especifica pares de chave-valor para configurações do PgBouncer. Coloque todos os valores entre aspas, por exemplo, default_pool_size: "20". Para mais informações sobre as opções disponíveis, consulte a documentação de configuração do PgBouncer. Os parâmetros usados com frequência incluem:
  • pool_mode: especifica quando uma conexão de banco de dados pode ser reutilizada por outros clientes.
  • default_pool_size: o número máximo de conexões de banco de dados permitidas por par de usuário-banco de dados
  • max_client_conn: o número máximo de conexões de cliente
  • max_db_connections: o número máximo de conexões de banco de dados
port
integer
Opcional
Especifica a porta em que o PgBouncer fica à espera de conexões recebidas. O valor padrão é 6432.
serverTLS
object
Opcional
ServerTLSSpec define o secret do certificado para comunicação criptografada usada pelo PgBouncer para se conectar ao cluster de banco de dados e buscar credenciais de autenticação.
serverTLS.certSecret
object
Opcional
CertSecret referencia o secret do certificado no mesmo namespace. O secret precisa conter entradas ca.crt (certificado de CA), tls.key (chave privada) e tls.crt (certificado de folha). Os valores nesse secret são usados para preencher as configurações server_tls_ca_file, server_tls_cert_file e server_tls_key_file no arquivo pgbouncer.ini. O certificado de CA precisa corresponder à CA que assinou o certificado de folha do cluster de banco de dados. O certificado de folha precisa conter o CommonName "alloydbpgbouncer".
serverTLS.certSecret.name
string
Opcional
Nome do referenciador.

Esquema de status

O status do PgBouncer define o estado observado do PgBouncer.

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

Campo

Tipo
Obrigatório ou opcional

 

Descrição
endpoints
array of objects
Opcional
endpoints contém todos os endpoints em que é possível acessar essa instância.
endpoints.name
string
Obrigatório
O nome é o nome do endpoint, por exemplo, Read-Write.
endpoints.value
string
Obrigatório
O valor contém as informações do endpoint para conectar e acessar a instância.
phase
string
Obrigatório
phase descreve o estado da implantação do PgBouncer. Valores como WaitingForDeploymentReady, Acquiring IP e Ready aparecem aqui.
port
integer
Opcional
O número da porta exposta pelo PgBouncer para conexões.