pgbackrest

https://pgbackrest.org/

https://github.com/pgbackrest/pgbackrest

전제조건

libyaml-devel 패키지에 의존하고 있으므로 해당 패키지가 설치되어 있어야 함.

https://rpmfind.net/linux/RPM/centos-stream/9/crb/x86_64/libyaml-devel-0.2.5-7.el9.x86_64.html

https://rpmfind.net/linux/centos-stream/9-stream/CRB/x86_64/os/Packages/libyaml-devel-0.2.5-7.el9.x86_64.rpm

설치

해당 방법은 수동 설치를 기재 (PGDG 레포지토리가 활성화 되어 있다면 dnf 같은 패키지 설치가 가능하나 지원하지 않는 OS거나 레포지토리 활성화가 되어 있지 않다면 수동 설치를 해야함)

패키지 사전 설치

 dnf install -y libxml2-static
 dnf install -y libxml2-devel
 dnf install -y bzip2-devel
 dnf install -y libpq-devel

 # Amazon Linux 2023
 dnf install -y libyaml-devel

 # RHEL 9
 rpm -ivh libyaml-devel-0.2.5-7.el9.x86_64.rpm

설치 파일 다운로드

 wget -P /tmp https://github.com/pgbackrest/pgbackrest/archive/refs/tags/release/2.54.0.tar.gz

압축 해제, 설치

 tar xzf /tmp/2.54.0.tar.gz -C /tmp
 cd /tmp/pgbackrest-release-2.54.0/src
 ./configure && make && sudo make install

확인

 pgbackrest --version
 # pgBackRest 2.54.0

설정

설정파일 작성

 mkdir /var/log/pgbackrest
 chown -R postgres:postgres /var/log/pgbackrest

 mkdir /var/lib/pgbackrest
 chown -R postgres:postgres /var/lib/pgbackrest

 vi /etc/pgbackrest.conf

 # Configure Cluster Stanza
 [<stanza-name>]
 pg1-path=<postgresql-data-dir>
 pg1-socket-path=<postgresql-socket-dir>
 pg1-port=<postgresql-port>
 pg1-user=<postgresql-admin-user>

 # Configure the pgBackRest repository path
 [global]
 repo1-retention-full=2
 repo1-retention-diff=3
 repo1-retention-archive=2
 start-fast=y
 process-max=2
 log-level-console=info
 log-level-file=debug

 # Local
 repo1-path=/var/lib/pgbackrest

 # S3
 repo1-path=<backup-directory>
 repo1-type=s3
 repo1-s3-uri-style=path
 repo1-s3-bucket=<s3-bucket-name>
 repo1-s3-endpoint=<s3-endpoint>
 repo1-s3-key=<s3-access-key>
 repo1-s3-key-secret=<s3-secret-key>
 repo1-s3-region=<default-region-name>

 # KMS KEY
 repo1-s3-key-type=<type>
 repo1-s3-kms-key-id=<kms-key>

 [global:archive-push]
 compress-level=3

설정 예시

 # 2개의 FULL BACKUP, 1개의 차분 BACKUP을 보존
 repo1-retention-full=2
 repo1-retention-full-type=count
 repo1-retention-diff=1

 # 2개의 FULL BACKUP을 보존하되 최신 3개의 WAL을 보존 (2개의 백업보다 이전의 백업에 대해 WAL을 삭제하지 않고 보존)
 # repo1-retention-archive-type이 incr이라면 (증분), repo1-retention-archive 옵션이 강제됨. full이라면 PITR에서 문제가 발생할 가능성이 있기 때문에 diff, incr 사용이 권장
 repo1-retention-full=2
 repo1-retention-full-type=count
 repo1-retention-archive-type=full
 repo1-retention-archive=3

 # 2개의 FULL BACKUP, 2개의 차분 BACKUP, 최신 백업 3개의 WAL을 보존 (4개의 백업 중 가장 오래된 백업에 대한 WAL은 삭제됨)
 repo1-retention-full=2
 repo1-retention-full-type=count
 repo1-retention-diff=2
 repo1-retention-archive-type=diff
 repo1-retention-archive=3

 # ↑ 백업 수로 관리하는 방침이라면 잘 확인해서 설정해야함

 # 5일 이내의 백업을 보존 (FACTOR : 일)
 repo1-retention-full=5
 repo1-retention-full-type=time

백업

STANZA 작성

 pgbackrest --stanza=<stanza-name> stanza-create

체크

 pgbackrest --stanza=<stanza-name> check

백업 개시

 # FULL
 pgbackrest --stanza=<stanza-name> backup --type=full
   
 # INCREMENT
 pgbackrest --stanza=<stanza-name> backup --type=incr

 # DIFF
 pgbackrest --stanza=<stanza-name> backup --type=diff

백업 정보 확인

 pgbackrest --stanza=<stanza-name> info

복원

백업 정보 확인

 pgbackrest --stanza=<stanza-name> info

복원 개시
```
 pgbackrest --stanza=<stanza-name> restore --type=<type-name>
```
|타입|설명| |-|-| |default|Archive Stream까지 복원| |immediate|데이터베이스의 일관성이 있을 때 까지 복원| |lsn|해당 LSN 번호까지 복원| |name|--target 으로 정의한 백업 이름을 복원| |xid|--target 으로 정의한 TRANSACTION ID까지 복원| |time|--target 으로 정의한 Timestamp 시점까지 복원 (yyyy-mm-dd hh24:mi:ss+UTC TIME)| |preserve|기존의 postgresql.auto.conf, recovery.conf 파일을 보존| |standby|postgresql.auto.conf, 또는recovery.conf애 standby_mode=on 을 추가하여 클러스터가 STANDBY 모드로 시작하도록 함| |none|postgresql.auto.conf, 또는 recovery.conf 을 작성하지 않고 pg_xlog/pg_wal 에 있는 WAL SEGMENT를 사용해 일관성을 유지 (필요한 WAL SEGMENT의 제공, 또는 archive-copy 설정을 사용할 필요가 있음)|

none 인 경우 복원이 끝날 때까지 Timeline가 증가하지 않기 때문에 주의해야함 (중복된 WAL을 Archive하게 되면 디스크 풀, 또는 pg_rewind 의 동작 에러가 발생할 가능성이 있음)

백업 삭제

백업 정보 확인

 pgbackrest --stanza=<stanza-name> info

해당 백업 삭제

 pgbackrest --stanza=<stanza-name> expire --set=<backup-name>

STANZA 삭제

클러스터 정지
```
 pg_ctlcluster <cluster-name> stop
```

STANZA 정지

 pgbackrest --stanza=<stanza-name> stop

STANZA 삭제

 pgbackrest --stanza=<stanza-name> stanza-delete