데이터 센터 간 복제 작업

문서 버전을 선택합니다.

이 페이지에서는 Kubernetes에서 보조 데이터베이스 클러스터를 만들고 사용하여 교차 데이터 센터 복제를 사용하는 방법을 설명합니다.

크로스 데이터 센터 복제에 대한 개념 개요는 크로스 데이터 센터 복제 정보를 참고하세요.

시작하기 전에

  • 기본 데이터 센터와 보조 데이터 센터 간에 안정적이고 지연 시간이 짧은 네트워크 연결이 있어야 합니다. 이는 데이터 센터 간 복제가 효과적으로 작동하는 데 중요합니다.
  • 최신 버전의 AlloyDB Omni 연산자를 설치하여 기본 데이터 센터의 Kubernetes 클러스터와 보조 데이터 센터의 Kubernetes 클러스터에 AlloyDB Omni를 배포합니다. 교차 데이터 센터 복제는 AlloyDB Omni 연산자 버전 1.5.0 이상에서 지원됩니다.
  • 기본 데이터 센터의 Kubernetes 클러스터에서 AlloyDB Omni 데이터베이스 클러스터를 만듭니다.
  • 기본 데이터베이스 클러스터의 기본 및 대기 데이터베이스 서버에 보조 클러스터로의 복제에 필요한 WAL 파일을 수용할 수 있는 충분한 WAL (Write-Ahead Logging) 공간이 있는지 확인합니다. 보조 클러스터로 아직 복제되지 않은 데이터는 기본 클러스터에 WAL 파일로 저장되므로 기본 클러스터와 보조 클러스터 간의 연결 속도에 따라 이 용도로 추가 디스크 공간이 필요할 수 있습니다.

보조 데이터베이스 클러스터 만들기

AlloyDB Omni 보조 데이터베이스 클러스터를 만들고 기본 데이터베이스 클러스터에서 복제를 사용 설정하려면 다음 단계를 따르세요.

Kubernetes

  1. AlloyDB Omni 기본 데이터베이스 클러스터에서 외부 연결이 사용 설정되어 있는지 확인합니다. 외부 연결이 사용 설정되지 않은 경우 데이터베이스 클러스터 매니페스트의 사양 섹션에 다음을 추가합니다.

      kind: DBCluster
      spec:
       allowExternalIncomingTraffic: true
    
  2. 고가용성 (HA)이 사용 설정된 기본 데이터베이스 클러스터와 함께 교차 데이터 센터 복제를 사용하려면 기본 데이터베이스 클러스터에서 replayReplicationSlotsOnStandbys 필드가 사용 설정되어 있는지 확인하세요.

    kind: DBCluster
      spec:
        availability:
          replayReplicationSlotsOnStandbys: true
    

    이 필드를 사용 설정하면 다음 단계에서 설명하는 logReplicationSlots와 함께 보조 데이터베이스 클러스터에서 사용하는 복제 슬롯이 모든 HA 대기 상태와 동기화됩니다. 이 구성은 장애 조치 또는 전환 후 보조 데이터베이스 클러스터에서 아직 사용하지 않은 Write-Ahead Logging (WAL) 파일을 새 HA 기본 데이터베이스가 유지하도록 지원하여 중단 없이 복제를 재개할 수 있도록 합니다.

  3. 기본 데이터베이스 클러스터에서 복제를 사용 설정하려면 기본 데이터 센터의 Kubernetes 클러스터에 다음과 유사한 매니페스트를 적용합니다.

    apiVersion: v1
    kind: Secret
    metadata:
     name: ha-rep-pw-DB_CLUSTER_NAME
    type: Opaque
    data:
     rep-user-pw: "ENCODED_PASSWORD"
    ---
    apiVersion: alloydbomni.dbadmin.goog/v1
    kind: Replication
    metadata:
     name: REPLICATION_NAME
    spec:
     dbcluster:
       name: DB_CLUSTER_NAME
     upstream:
       password:
         name: ha-rep-pw-DB_CLUSTER_NAME
         logReplicationSlot: LOG_REPLICATION_SLOT
    

    다음을 바꿉니다.

    • DB_CLUSTER_NAME: 데이터베이스 클러스터의 이름입니다(예: dbc-1).
    • ENCODED_PASSWORD: 보조 데이터베이스에서 복제하는 데 사용할 데이터베이스 사용자의 비밀번호로, base64 문자열로 인코딩됩니다(예: Q2hhbmdlTWUxMjM= for ChangeMe123). 기본값은 alloydbreplica입니다.
    • REPLICATION_NAME: 복제 이름입니다(예: replication-1).
    • LOG_REPLICATION_SLOT: 복제 슬롯 데이터를 WAL 파일에 로깅합니다. 이 옵션을 사용 설정하려면 값을 true로 설정합니다. 기본값은 false입니다.

    장애 조치 또는 전환 후에도 복제가 계속 작동하도록 하려면 고가용성 (HA)이 사용 설정된 기본 데이터베이스 클러스터에서 logReplicationSlot 옵션을 사용 설정하는 것이 좋습니다.

    복제 상태가 준비될 때까지 기다립니다.

  4. 보조 데이터베이스 클러스터에서 복제를 구성하는 데 사용되는 업스트림 연결 정보를 가져오려면 다음 명령어를 실행합니다.

      kubectl get replication REPLICATION_NAME
      kubectl get replication REPLICATION_NAME -o json | jq .status.upstream

    샘플 출력은 다음과 유사합니다.

      {
       "host": "35.230.32.36",
       "password": {
         "name": "ha-rep-pw-dbc-1"
       },
       "port": 5432,
       "replicationSlotName": "dbc_1_replication_1",
       "username": "alloydbreplica"
      }
    
  5. 다음 단계에서 보조 데이터베이스 클러스터에 복제를 사용 설정해야 하므로 출력을 기록해 둡니다.

  6. 기본 데이터베이스 클러스터와 동일한 구성으로 보조 데이터 센터의 Kubernetes 클러스터에 AlloyDB Omni 클러스터를 만듭니다.

  7. AlloyDB Omni 보조 데이터베이스 클러스터에서 외부 연결이 사용 설정되어 있는지 확인합니다.

  8. 외부 연결이 사용 설정되지 않은 경우 매니페스트의 사양 섹션에 다음을 추가합니다.

     allowExternalIncomingTraffic: true
    
  9. 보조 데이터베이스 클러스터에서 복제를 사용 설정하려면 보조 데이터 센터의 Kubernetes 클러스터에 다음과 유사한 매니페스트를 적용하세요.

      apiVersion: v1
      kind: Secret
      metadata:
        name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
      type: Opaque
      data:
        rep-user-pw: "ENCODED_PASSWORD"
      ---
      apiVersion: alloydbomni.dbadmin.goog/v1
      kind: Replication
      metadata:
        name: SECONDARY_REPLICATION_NAME
      spec:
        dbcluster:
          name: SECONDARY_DB_CLUSTER_NAME
        downstream:
          host: PRIMARY_HOST
          port: PRIMARY_PORT
          username: alloydbreplica
          password:
            name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
          replicationSlotName: PRIMARY_REPLICATION_SLOT
          control: setup
    

    다음을 바꿉니다.

    • SECONDARY_DB_CLUSTER_NAME: 보조 데이터베이스 클러스터의 이름입니다(예: dbc-2).
    • ENCODED_PASSWORD: 기본 데이터베이스 클러스터를 복제하는 데 사용할 데이터베이스 사용자의 비밀번호로, base64 문자열로 인코딩됩니다(예: Q2hhbmdlTWUxMjM= for ChangeMe123). 기본값은 alloydbreplica입니다.
    • SECONDARY_REPLICATION_NAME: 복제 이름입니다(예: replication-2).
    • PRIMARY_HOST: 보조 데이터베이스가 복제를 위해 액세스할 수 있는 3단계 출력의 기본 데이터베이스 클러스터 연결 엔드포인트입니다.
    • PRIMARY_PORT: 보조 데이터베이스가 복제를 위해 액세스할 수 있는 3단계 출력의 기본 데이터베이스 클러스터 연결 포트입니다.
    • PRIMARY_REPLICATION_SLOT: 보조 데이터베이스가 복제에 사용할 수 있는 3단계 출력의 기본 데이터베이스 클러스터에 있는 복제 슬롯의 이름입니다.

보조 데이터베이스 클러스터에서 복제 보기

AlloyDB Omni 보조 데이터베이스 클러스터 및 복제 상태에 관한 자세한 정보를 보려면 다음 명령어를 실행하세요.

Kubernetes

kubectl get dbcluster SECONDARY_DB_CLUSTER_NAME
kubectl get replication SECONDARY_REPLICATION_NAME

보조 데이터베이스 클러스터가 성공적으로 설정되고 기본 데이터베이스 클러스터에서 스트리밍 복제가 있는 경우 복제 상태는 준비 및 정상입니다.

보조 데이터베이스 클러스터 승격

보조 데이터베이스 클러스터를 승격하기 전에 다음 단계를 실행하여 보조 데이터베이스 클러스터에 기본 데이터베이스 클러스터에서 수신된 모든 트랜잭션이 적용되었는지 확인하세요.

Kubernetes

  • 보조 데이터베이스 클러스터의 복제 상태를 확인하여 준비되었고 정상인지 확인합니다.

    kubectl get replication SECONDARY_REPLICATION_NAME
  • 기본 데이터베이스 클러스터에 대한 모든 쓰기를 중지합니다. 기본 데이터베이스 클러스터에서 다음 쿼리를 실행하여 보조 데이터베이스의 복제 지연을 확인합니다. 결과에 지연이 최소화되어 있는지 확인합니다.

    지연 값은 0이 가장 좋습니다. 지연 시간이 0보다 큰 경우 기본 데이터베이스 클러스터에서 이미 커밋된 최근 트랜잭션이 손실될 위험이 있지만 보조 데이터베이스 클러스터를 승격할 수 있습니다.

     psql -h PRIMARY_HOST -U postgres -d postgres -c 'SELECT application_name, pg_wal_lsn_diff(pg_current_wal_lsn(), replay_lsn) AS replay_lag FROM pg_stat_replication;'

보조 데이터베이스 클러스터를 기본 데이터베이스 클러스터로 승격하려면 보조 데이터베이스 클러스터의 복제 매니페스트의 control 필드를 promote로 업데이트하고 보조 데이터 센터의 Kubernetes 클러스터에 적용합니다.

Kubernetes

    apiVersion: v1
    kind: Secret
    metadata:
      name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
    type: Opaque
    data:
      rep-user-pw: "ENCODED_PASSWORD"
    ---
    apiVersion: alloydbomni.dbadmin.goog/v1
    kind: Replication
    metadata:
      name: SECONDARY_REPLICATION_NAME
    spec:
      dbcluster:
        name: SECONDARY_DB_CLUSTER_NAME
      downstream:
        host: PRIMARY_HOST
        port: PRIMARY_PORT
        username: alloydbreplica
        password:
          name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
        replicationSlotName: PRIMARY_REPLICATION_SLOT
        control: promote

전환 수행

전환을 수행하기 전에 두 데이터 센터에 속한 기본 및 보조 데이터베이스 클러스터가 온라인 상태이고 데이터베이스 클러스터가 정상 상태인지 확인합니다.

전환 중에 기본 데이터베이스 클러스터와 보조 데이터베이스 클러스터의 데이터 일관성을 유지하려면 다음 단계에 따라 보조 데이터베이스 클러스터가 기본 데이터베이스 클러스터에서 수신된 모든 트랜잭션을 적용했는지 확인하세요.

Kubernetes

  • 보조 데이터베이스 클러스터의 복제 상태를 확인하여 준비되었고 정상인지 확인합니다.

    kubectl get replication SECONDARY_REPLICATION_NAME
  • 기본 데이터베이스 클러스터에 대한 모든 쓰기를 중지합니다. 기본 데이터베이스 클러스터에서 다음 쿼리를 실행하여 보조 데이터베이스의 복제 지연을 확인합니다. 결과에 지연 값 0이 표시되는지 확인합니다.

     psql -h PRIMARY_HOST -U postgres -d postgres -c 'SELECT application_name, pg_wal_lsn_diff(pg_current_wal_lsn(), replay_lsn) AS replay_lag FROM pg_stat_replication;'

전환을 수행하려면 다음 단계를 완료하세요.

Kubernetes

  1. AlloyDB Omni 보조 데이터베이스 클러스터를 기본 데이터베이스 클러스터로 변환하려면 보조 데이터 센터의 Kubernetes 클러스터에서 복제 매니페스트를 다음과 같이 업데이트하세요.

       apiVersion: v1
       kind: Secret
       metadata:
        name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
       type: Opaque
       data:
         rep-user-pw: "ENCODED_PASSWORD"
       ---
       apiVersion: alloydbomni.dbadmin.goog/v1
       kind: Replication
       metadata:
        name: SECONDARY_REPLICATION_NAME
       spec:
        dbcluster:
           name: SECONDARY_DB_CLUSTER_NAME
         upstream:
           password:
             name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
    

    복제 상태가 준비될 때까지 기다립니다.

  2. 복제의 업스트림 연결 정보를 가져오려면 다음 명령어를 실행합니다.

    kubectl get replication SECONDARY_REPLICATION_NAME
    kubectl get replication SECONDARY_REPLICATION_NAME -o json | jq .status.upstream

    샘플 출력은 다음과 유사합니다.

     {
       "host": "34.23.207.137",
       "password": {
         "name": "ha-rep-pw-dbc-2"
       },
       "port": 5432,
       "replicationSlotName": "dbc_2_replication_2",
       "username": "alloydbreplica"
     }
    
  3. AlloyDB Omni 기본 데이터베이스 클러스터를 보조 데이터베이스 클러스터로 변환하려면 기본 데이터 센터의 Kubernetes 클러스터에서 다음과 같이 복제 매니페스트를 업데이트하세요.

        apiVersion: v1
        kind: Secret
        metadata:
         name: ha-rep-pw-DB_CLUSTER_NAME
        type: Opaque
        data:
          rep-user-pw: "ENCODED_PASSWORD"
        ---
        apiVersion: alloydbomni.dbadmin.goog/v1
        kind: Replication
        metadata:
          name: REPLICATION_NAME
        spec:
          dbcluster:
            name: DB_CLUSTER_NAME
          downstream:
            host: SECONDARY_HOST
            port: SECONDARY_PORT
            username: alloydbreplica
            password:
              name: ha-rep-pw-DB_CLUSTER_NAME
            replicationSlotName: SECONDARY_REPLICATION_SLOT
           control: rewind
    

    복제 상태가 준비되고 정상 상태가 될 때까지 기다립니다.

  4. 복제 상태를 확인하려면 다음을 사용하세요.

    kubectl get replication REPLICATION_NAME