PgBouncer 커스텀 리소스 정의

사양 스키마

PgBouncer 사양은 선택된 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과 동일한 네임스페이스에서 PgBouncer 객체를 만들어야 합니다. 이 필드는 PgBouncer 연결 풀링에 필수입니다.
parameters
object
선택사항
PgBouncer 구성의 키-값 쌍을 지정합니다. 모든 값을 따옴표로 묶습니다(예: default_pool_size: "20"). 사용 가능한 옵션에 대한 자세한 내용은 PgBouncer 구성 문서를 참고하세요. 흔히 사용되는 매개변수는 다음과 같습니다.
  • pool_mode: 데이터베이스 연결을 다른 클라이언트에서 재사용할 수 있는 시점을 지정합니다.
  • default_pool_size: 사용자-데이터베이스 쌍당 허용되는 최대 데이터베이스 연결 수
  • max_client_conn: 최대 클라이언트 연결 수
  • max_db_connections: 최대 데이터베이스 연결 수
port
integer
선택사항
PgBouncer가 수신 연결을 수신 대기하는 포트를 지정합니다. 기본값은 6432입니다.
serverTLS
object
선택사항
ServerTLSSpec은 PgBouncer가 인증 사용자 인증 정보를 가져오기 위해 데이터베이스 클러스터에 연결할 때 사용하는 암호화 통신용 인증서 보안 비밀을 정의합니다.
serverTLS.certSecret
object
선택사항
CertSecret은 동일한 네임스페이스 내의 인증서 보안 비밀을 참조합니다. 보안 비밀에는 ca.crt (CA 인증서), tls.key (비공개 키), tls.crt (리프 인증서) 항목이 포함되어야 합니다. 이 보안 비밀 내의 값은 pgbouncer.ini 파일의 server_tls_ca_file, server_tls_cert_file, server_tls_key_file 구성을 채우는 데 사용됩니다. CA 인증서는 데이터베이스 클러스터의 리프 인증서를 서명한 CA와 일치해야 합니다. 리프 인증서에는 CommonName 값으로 "alloydbpgbouncer"가 포함되어 있어야 합니다.
serverTLS.certSecret.name
string
선택사항
지시 대상의 이름입니다.

상태 스키마

PgBouncer 상태는 관찰된 PgBouncer 상태를 정의합니다.

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

필드

유형
필수 또는 선택사항

 

설명
endpoints
array of objects
선택사항
endpoints에는 이 인스턴스에 액세스할 수 있는 모든 엔드포인트가 포함됩니다.
endpoints.name
string
필수
이름은 엔드포인트의 이름입니다(예: Read-Write).
endpoints.value
string
필수
값에는 인스턴스에 연결하고 액세스하기 위한 엔드포인트 정보가 포함됩니다.
phase
string
필수
phase는 PgBouncer 배포의 상태를 설명합니다. WaitingForDeploymentReady, Acquiring IP, Ready와 같은 값이 여기에 표시됩니다.
port
integer
선택사항
연결을 위해 PgBouncer에서 노출하는 포트 번호입니다.