Openproxy 사용 설명서

CLI 플래그 > etcd > 설정 파일

[general]
host = "0.0.0.0"
port = 6432
admin_username = "admin"
admin_password = "adminpassword"

[pools.mydb]
pool_mode = "transaction"
auth_type = "scram-sha-256"

[pools.mydb.users.0]
username = "appuser"
password = "apppassword"
server_username = "appuser"
server_password = "apppassword"
pool_size = 20

[pools.mydb.shards.0]
servers = [
    ["192.168.1.10", 5432, "primary"],
    ["192.168.1.11", 5432, "replica"],
]
database = "mydb"

openproxy /etc/openproxy/openproxy.toml

psql -h 127.0.0.1 -p 6432 -U user mydb

[general]
host = "0.0.0.0"
port = 6432
admin_username = "admin"
admin_password = "adminpassword"

[general.etcd]
enabled = true
endpoints = ["192.168.1.1:2379", "192.168.1.2:2379", "192.168.1.3:2379"]
patroni_namespace = "/service"
patroni_scope = "opensql"

[pools.mydb]
pool_mode = "transaction"
auth_type = "scram-sha-256"
query_parser_enabled = true
query_parser_read_write_splitting = true

[pools.mydb.users.0]
username = "appuser"
password = "apppassword"
server_username = "appuser"
server_password = "apppassword"
pool_size = 20

[pools.mydb.shards.0]
servers = [
    ["192.168.1.10", 5432, "Auto"],
    ["192.168.1.11", 5432, "Auto"],
    ["192.168.1.12", 5432, "Auto"],
]
database = "mydb"
use_patroni = true

openproxy /etc/openproxy/openproxy.toml

[Unit]
Description=OpenProxy - PostgreSQL Connection Pooler (OpenSQL)
After=network.target etcd.service
StartLimitIntervalSec=0

[Service]
User=opensql
Type=simple
Restart=always
RestartSec=5
Environment=RUST_LOG=info
ExecStart=/usr/bin/openproxy /etc/openproxy/openproxy.toml
StandardOutput=journal
StandardError=journal
SyslogIdentifier=openproxy
LimitNOFILE=65536
# VRRP 사용 시 필요. VRRP 미사용 시 제거 가능.
AmbientCapabilities=CAP_NET_ADMIN CAP_NET_RAW

[Install]
WantedBy=multi-user.target

# 서비스 파일 복사 후 daemon reload
sudo systemctl daemon-reload

# 부팅 시 자동 시작 활성화
sudo systemctl enable openproxy

# 서비스 시작
sudo systemctl start openproxy

# 상태 확인
sudo systemctl status openproxy

# 로그 확인
sudo journalctl -u openproxy -f

sudo systemctl stop openproxy
sudo systemctl restart openproxy

openproxy
openproxy /etc/openproxy/openproxy.toml

# 기본 (TOML 형식, 명시적으로 설정된 항목만)
openproxy show

# 기본값 포함 전체 설정 출력
openproxy show --full

# JSON 형식으로 출력
openproxy show --format json

# 특정 섹션만 출력
openproxy show --section general
openproxy show --section pools.mydb

# OK: config_file이 서브커맨드 앞에 위치
openproxy /etc/openproxy/openproxy.toml show

# Fail: config_file이 서브커맨드 뒤에 오면 인식되지 않음
openproxy show /etc/openproxy/openproxy.toml

# 대화형: $EDITOR로 설정 파일 열기
openproxy edit

# 비대화형: 특정 값 변경
openproxy edit --set general.pool_size=20
openproxy edit --set general.connect_timeout=2000

# 여러 값 동시 변경
openproxy edit --set general.connect_timeout=2000 --set general.idle_timeout=300000

# OK: config_file이 서브커맨드 앞에 위치
openproxy /etc/openproxy/openproxy.toml edit --set general.pool_size=20

# Fail: config_file이 서브커맨드 뒤에 오면 인식되지 않음
openproxy edit /etc/openproxy/openproxy.toml --set general.pool_size=20

openproxy encode 'mypassword!@#'

[pools.my_pool]
auth_type = "scram-sha-256"

[pools.my_pool.users.0]
username = "opensql_user"
password = "SCRAM-SHA-256$4096:..."

openproxy --force-config-file /etc/openproxy/openproxy.toml

# 로그를 파일로만 저장, 저장 경로 및 보관 개수 지정
openproxy --log-target file --log-dir /var/log/openproxy --max-logfile-num 10 /etc/openproxy/openproxy.toml

# 로그 레벨을 debug로 설정하여 표준출력으로만 출력
openproxy --log-target stdout --log-level debug /etc/openproxy/openproxy.toml

psql -h 127.0.0.1 -p 6432 -U <admin_username> openproxy

SET key = value

# 설정 파일에서 enabled 변경 후 반드시 재시작
sudo systemctl restart openproxy