읽기 전용 복제본 만들기

문서 버전을 선택합니다.

읽기 처리량과 가용성을 높이려면 기존 AlloyDB Omni 서버의 AlloyDB Omni 복제본 서버를 만들면 됩니다. 복제본 서버는 기본 데이터베이스 서버의 읽기 전용 클론을 제공하며, 기본 서버 데이터의 변경사항이 반영되도록 자체 데이터를 지속적으로 업데이트합니다.

다음 섹션에서는 복제용 AlloyDB Omni 기본 서버와 복제본 서버를 구성하고 기본 서버에서 복제 상태를 확인하는 단계를 설명합니다.

자세한 내용은 Kubernetes에 AlloyDB Omni 설치를 참조하세요.

복제용 기본 서버 구성

  1. 기본 서버의 Postgres 포트를 통해 복제본 서버의 호스트에서 인그레스 트래픽을 허용하도록 기본 서버 호스트의 네트워크 또는 방화벽 설정을 업데이트합니다.

  2. 복제 사용자를 만듭니다.

    docker exec CONTAINER_NAME psql -h localhost -U postgres -c "create user REPLICA_USER with replication password 'PASSWORD'"

    다음을 바꿉니다.

    • REPLICA_USER: 복제본 사용자 이름
    • PASSWORD: 복제본 사용자 비밀번호
    • CONTAINER_NAME: AlloyDB Omni 컨테이너를 설치할 때 할당한 이름

  3. /DATA_DIR/pg_hba.conf 파일에서 파일에 이미 존재하는 host all all all scram-sha-256 앞에 다음 줄을 추가합니다.

    host alloydbmetadata    alloydbmetadata   IP_RANGE trust
host replication        REPLICA_USER    IP_RANGE scram-sha-256

    다음을 바꿉니다.

    • IP_RANGE: 표시된 복제본 머신이 있는 CIDR 표기법으로 서브넷의 IP 범위. 예를 들면 203.0.113.0/24입니다.
    • DATA_DIR: 이 복제본이 데이터 디렉터리로 사용할 파일 시스템 경로

  4. 기본 서버를 다시 시작합니다.

    docker restart CONTAINER_NAME

복제본 서버 만들기 및 구성

AlloyDB Omni 복제본 서버를 만들고 구성하려면 다음 단계를 완료합니다.

  1. 복제본이 기본 서버에 네트워크로 연결되어 있는지 확인합니다.

    ping SOURCE_IP

    SOURCE_IP를 복제할 기본 AlloyDB Omni 인스턴스 IP 주소로 바꿉니다.

  2. 복제본이 기본 서버에 연결할 수 있는지 확인합니다.

    docker run -it --rm google/alloydbomni psql "host=SOURCE_IP user=REPLICA_USER replication=1" -c "IDENTIFY_SYSTEM;"

    출력은 다음과 비슷하게 표시됩니다.

           systemid       | timeline |  xlogpos  | dbname
 ---------------------+----------+-----------+--------
  7376500460465963036 |        1 | 0/454B670 |
 (1 row)

  3. 복제본은 디스크의 영구 스토리지 위치를 사용해야 합니다.

     mkdir alloydb && docker run --rm -it \
   -e PGDATA=/var/lib/postgresql/data/pgdata \
   -v "$PWD/alloydb":/var/lib/postgresql/data \
   -p 5432:5432 \
   --user $(id -u):$(id -g) \
   google/alloydbomni \
   /usr/lib/postgresql/15/bin/pg_basebackup \
     --pgdata=/var/lib/postgresql/data/pgdata \
     --checkpoint=fast \
     --host="SOURCE_IP" \
     --port="SOURCE_PORT" \
     --username=REPLICA_USER \
     --create-slot \
     --write-recovery-conf \
     --slot="SLOT_NAME"

    다음을 바꿉니다.

    • SOURCE_PORT: 복제할 기본 AlloyDB Omni 인스턴스의 TCP 포트. 이 값을 제공하지 않으면 AlloyDB Omni에서 기본값 5432를 적용합니다.
    • SLOT_NAME: 복제 슬롯 이름의 라벨

  4. 복제본 인스턴스를 시작합니다.

    docker run --detach \
  --name pg-service \
  -e POSTGRES_PASSWORD=a \
  -e PGDATA=/var/lib/postgresql/data/pgdata \
  -v "$PWD/alloydb":/var/lib/postgresql/data \
  -v /dev/shm:/dev/shm \
  -p 5432:5432 \
  --user $(id -u):$(id -g) \
  google/alloydbomni

기본 서버에서 복제 상태 확인

복제가 올바르게 구성되었는지 확인하려면 기본 서버의 호스트에서 다음 명령어를 실행합니다.

  docker exec -it CONTAINER_NAME psql -h localhost -U postgres -c "select * from pg_stat_replication"

출력 테이블에는 기본 데이터베이스 서버에 연결된 모든 복제본에 대해 행이 하나씩 포함됩니다.

복제를 설정하면 기본 데이터베이스 서버에서 수행된 모든 행 삽입, 업데이트, 삭제 작업을 복제본에서도 몇 초 안에 조회할 수 있습니다.