Google Cloud 없이 백업 및 복구

이 섹션에서는 Google Cloud를 사용하는 대신 ssh 및 파일 시스템을 사용하여 Cassandra 데이터베이스의 백업 및 복구를 구성하는 방법을 설명합니다. 참조:

Google Cloud 서비스가 없는 Cassandra 백업 및 복구란 무엇인가요?

클라우드 서비스가 없는 백업은 Cassandra 데이터베이스의 백업을 지정한 서버의 파일 시스템에 압축된 파일로 저장합니다. 백업은 재정의 파일에서 지정한 일정에 따라 수행됩니다. 서버 연결은 보안 SSH를 통해 이루어집니다.

클라우드 서비스 없이 백업 설정:

다음 단계에서는 SSH 키 쌍 만들기와 같은 특정 작업을 완료하기 위한 일반적인 예시가 포함되어 있습니다. 설치에 적합한 방법을 사용합니다.

절차는 다음과 같습니다.

서버 및 SSH 설정

  1. 백업을 위해 Linux 또는 Unix 서버를 지정합니다. 이 서버는 Apigee Hybrid 런타임 영역에서 SSH를 통해 연결할 수 있어야 합니다. 백업에는 충분한 저장용량이 있어야 합니다.
  2. 서버에 SSH 서버를 설정하거나 안전한 SSH 서버가 구성되어 있는지 확인합니다.
  3. SSH 키 쌍을 만들고 하이브리드 런타임 영역에서 액세스할 수 있는 경로에 비공개 키 파일을 저장합니다. 키 쌍에 빈 비밀번호를 사용하지 마세요. 예를 들면 다음과 같습니다.
    ssh-keygen -t rsa -b 4096 -C exampleuser@example.com
      Enter file in which to save the key (/Users/exampleuser/.ssh/id_rsa): $APIGEE_HOME/hybrid-files/certs/ssh_key
      Enter passphrase (empty for no passphrase):
      Enter same passphrase again:
      Your identification has been saved in ssh_key
      Your public key has been saved in ssh_key.pub
      The key fingerprint is:
      SHA256:DWKo334XMZcZYLOLrd/8HNpjTERPJJ0mc11UYmrPvSA exampleuser@example.com
      The key's randomart image is:
      +---[RSA 4096]----+
      |          +.  ++X|
      |     .   . o.=.*+|
      |    . o . . o==o |
      |   . . . =oo+o...|
      |  .     S +E oo .|
      |   . .   .. . o .|
      |    . . .  . o.. |
      |     .  ...o ++. |
      |      .. .. +o+. |
      +----[SHA256]-----+
  4. 백업 서버에 'apigee'라는 이름의 사용자 계정을 만듭니다. 새 'apigee' 사용자의 /home에 홈 디렉터리가 있는지 확인합니다.
  5. 백업 서버의 새 /home/apigee 디렉터리에 'ssh' 디렉터리를 만듭니다.
  6. 공개 키(이전 예시의 ssh_key.pub)를 새 /home/apigee/ssh 디렉터리의 'authorized_keys'라는 파일에 복사합니다. 예를 들면 다음과 같습니다.
    cd /home/apigee
    mkdir .ssh
    cd .ssh
    vi authorized_keys
  7. 백업 서버의 /home/apigee/ 디렉터리 내에 백업 디렉터리를 만듭니다. 백업 디렉터리는 'apigee' 사용자가 액세스할 수 있는 디렉터리면 됩니다. 예를 들면 다음과 같습니다.
    cd /home/apigee
    mkdir cassandra-backup
  8. 연결을 테스트합니다. Cassandra pod가 SSH를 통해 백업 서버에 연결할 수 있는지 확인해야 합니다.
    1. Cassandra pod의 셸에 로그인합니다. 예를 들면 다음과 같습니다.
      kubectl exec -it -n apigee apigee-cassandra-default-0 -- /bin/bash

      여기서 apigee-cassandra-default-0은 Casandra pod의 이름입니다. 연결하려는 pod의 이름으로 이를 변경합니다.

    2. 서버 IP 주소를 사용하여 SSH를 통해 백업 서버에 연결합니다.
      ssh apigee@backup-server-ip

백업 일정 및 위치 설정

overrides.yaml 파일에서 백업 일정 및 대상을 설정합니다.

  1. overrides.yaml 파일에 다음 매개변수를 추가합니다.

    매개변수

    cassandra:backup:
         enabled: true
         keyFile: "path-to-private-key-file"
         server: "backup-server-ip"
         storageDirectory: "/home/apigee/backup-directory"
         cloudProvider: "HYBRID" # required verbatim "HYBRID" (all caps)
         schedule: "schedule"
    

    cassandra:backup:
         enabled: true
         keyFile: "/Users/exampleuser/apigee-hybrid/hybrid-files/service-accounts/private.key"
         server: "34.56.78.90"
         storageDirectory: "/home/apigee/cassbackup"
         cloudProvider: "HYBRID"
         schedule: "0 2 * * *"
    

    각 항목의 의미는 다음과 같습니다.

    속성 설명
    backup:enabled 백업은 기본적으로 사용 중지되어 있습니다. 이 속성을 true로 설정해야 합니다.
    path-to-private-key-file 로컬 파일 시스템의 SSH 비공개 키 파일(SSH 키 쌍 생성 단계에서 만든 ssh_key라는 이름의 파일) 경로입니다.
    backup-server-ip 백업 서버의 IP 주소입니다.
    backup-directory 백업 서버의 백업 디렉터리 이름입니다. 이는 home/apigee 내의 디렉터리여야 하며, 백업 디렉터리의 이름은 백업 디렉터리 생성 단계에서 만든 cassandra_backup입니다.
    HYBRID cloudProvider: "HYBRID" 속성은 필수입니다.
    schedule 백업이 시작되는 시간이며 표준 crontab 구문에 지정되어 있습니다. 기본값: 0 2 * * *

    참고: 백업 구성을 클러스터에 적용하고 잠시 후에 백업을 예약하지 마세요. 백업 구성을 적용하면 Kubernetes가 Cassandra 노드를 다시 만듭니다. 노드가 다시 시작되기 전에 백업이 시작되면(몇 분 정도) 백업이 실패합니다.

  2. apigeectl을 사용하여 클러스터의 스토리지 범위에 백업 구성을 적용합니다.
    $APIGEECTL_HOME/apigeectl --datastore -f your-overrides-file

    여기서 your-overrides-file은 방금 수정한 재정의 파일의 경로입니다.

복원 구성

복원은 지정한 타임스탬프가 있는 백업 파일의 데이터를 가져와서 동일한 수의 pod가 있는 새 Cassandra 클러스터에 복원합니다. 새 클러스터에는 런타임 영역 클러스터와 다른 네임스페이스가 있어야 합니다.

Cassandra 백업을 복원하려면 다음 안내를 따르세요.

  1. 새 네임스페이스로 새 Kubernetes 클러스터를 만듭니다. 원래 하이브리드 설치에 사용했던 것과 동일한 클러스터/네임스페이스를 사용할 수 없습니다.
  2. 루트 하이브리드 설치 디렉터리에 새 overrides-restore.yaml 파일을 만듭니다.
  3. 전체 Cassandra 구성을 원본 overrides.yaml 파일에서 새 구성으로 복사합니다.
  4. overrides-restore.yaml 파일에 다음 매개변수를 추가합니다.

    매개변수

    namespace: restore-namespace
    
    cassandra:
      restore:
         enabled: true
         keyFile: "path-to-private-key-file"
         server: "backup-server-ip"
         storageDirectory: "/home/apigee/backup-directory"
         cloudProvider: "HYBRID"  # required verbatim "HYBRID" (all caps)
         snapshotTimestamp: "backup-to-restore"
    

    namespace: cassandra-restore
    
    cassandra:
      restore:
         enabled: true
         keyFile: "/Users/exampleuser/apigee-hybrid/hybrid-files/service-accounts/private.key"
         server: "34.56.78.90"
         storageDirectory: "/home/apigee/cassbackup"
         cloudProvider: "HYBRID"
         snapshotTimestamp: "20201001183903"
    

    각 항목의 의미는 다음과 같습니다.

    속성 설명
    restore-namespace 새 Cassandra 클러스터에 사용할 새 네임스페이스의 이름입니다. 원래 클러스터에 사용한 네임스페이스와 동일한 네임스페이스를 사용하지 마세요.
    restore:enabled 복원은 기본적으로 사용 중지되어 있습니다. 이 속성을 true로 설정해야 합니다.
    path-to-private-key-file 로컬 파일 시스템의 SSH 비공개 키 파일(SSH 키 쌍 생성 단계에서 만든 ssh_key라는 이름의 파일) 경로입니다.
    backup-server-ip 백업 서버의 IP 주소입니다.
    backup-directory 백업 서버의 백업 디렉터리 이름입니다. 이는 home/apigee 내의 디렉터리여야 하며, 백업 디렉터리의 이름은 백업 디렉터리 생성 단계에서 만든 cassandra_backup입니다.
    HYBRID cloudProvider: "HYBRID" 속성은 필수입니다.
    backup-to-restore 표준 crontab 구문(와일드 카드 허용 안 됨)에 지정된 복원할 특정 백업입니다.
  5. apigeectl을 사용하여 클러스터의 스토리지 범위에 백업 구성을 적용합니다.
    $APIGEECTL_HOME/apigeectl --datastore -f your-overrides-restore-file

    여기서 your-overrides-restore-file은 방금 수정한 overrides-restore.yaml 파일의 경로입니다.