단일 리전에서 복원

이 페이지에서는 단일 리전에서 Cassandra를 복원하는 방법을 설명합니다.

단일 리전 배포에서 Apigee Hybrid는 단일 데이터 센터 또는 리전에 배포됩니다. 배포에 Apigee 조직이 여러 개 있으면 복원 프로세스가 모든 조직의 데이터를 복원합니다. 멀티 조직 설정의 경우 특정 조직을 복원할 수 없습니다.

참고: 단일 리전 복원을 시작하기 전에 다음 기본 요건 단계를 적용할 수 있는지 확인하세요.

문제 해결 및 근본 원인 분석(RCA)의 기존 설정을 보존하려면 Kubernetes 클러스터에서 Apigee 컨트롤러를 제외한 모든 org 및 env 구성요소를 삭제한 후 클러스터를 보존해야 합니다. 클러스터에 문제 해결에 사용할 수 있는 기존 Apigee 데이터 스토어(Cassandra)가 포함됩니다. 새 Kubernetes 클러스터를 만든 후 새 클러스터에서 Cassandra를 복원합니다.
하이브리드 설치가 여러 조직으로 설정된 경우 단일 리전에서 복원을 계속하기 전 각 조직에 대해 재정의 파일을 가져옵니다. 3단계에 설명된 대로 복원 구성을 재정의 파일 중 하나에 추가할 수 있습니다. 복원 구성을 다른 재정의 파일에 추가하지 마세요.

백업에서 리전 복원

구성에 따라 Cassandra 백업이 Cloud Storage 또는 원격 서버에 저장될 수 있습니다. 어느 경우든 다음 단계를 수행하여 복원합니다.

하이브리드 버전을 확인합니다.
```
apigeectl version
```
버전이 스토리지에 백업 파일을 만든 버전과 같은지 확인합니다.
팁: 먼저 --dry-run=true 플래그와 함께 모든 apigeectl 명령어를 실행하여 apigeectl 오류를 확인하세요.
복원할 Kubernetes 클러스터에 이전 Apigee Hybrid 설치가 없는지 확인합니다. 기존 클러스터로 복원하는 경우 다음 명령어를 사용하여 기존 Apigee Hybrid 설치를 삭제합니다.
```
apigeectl delete -f overrides.yaml
kubectl -n apigee get apigeedatastore,apigeeredis,apigeetelemetry,org,env,arc # The output should be empty.
apigeectl delete --all -f overrides.yaml
```

overrides.yaml 파일을 열고 restore 속성을 원하는 값으로 설정합니다.

Cloud Storage

매개변수

namespace: YOUR_RESTORE_NAMESPACE # Use the namespace as in your original cluster.
cassandra:
  hostNetwork: false
  ...
  restore:
    enabled: true
    serviceAccountPath: "SA_JSON_FILE_PATH"
    dbStorageBucket: "CLOUD_STORAGE_BUCKET_PATH"
    cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
    snapshotTimestamp: "TIMESTAMP"
  ...
  backup:
    enabled: true
    serviceAccountPath: "SA_JSON_FILE_PATH"
    dbStorageBucket: "CLOUD_STORAGE_BUCKET_PATH"
    cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
    schedule: "SCHEDULE"

예

namespace: apigee
cassandra:
  hostNetwork: false
  ...
  restore:
    enabled: true
    serviceAccountPath: "/Users/myhome/.ssh/my_cassandra_backup.json"
    dbStorageBucket: "gs://myname-cassandra-backup"
    cloudProvider: "GCP"
    snapshotTimestamp: "20201001183903"

  ...
  backup:
    enabled: true
    serviceAccountPath: "/Users/myhome/.ssh/my_cassandra_backup.json"
    dbStorageBucket: "gs://myname-cassandra-backup"
    cloudProvider: "GCP"
    schedule: "0 2 * * *"
  ...

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

속성	설명
`namespace`	`YOUR_RESTORE_NAMESPACE` 복원할 네임스페이스입니다. 네임스페이스를 원래 클러스터에서와 같이 사용합니다.
`cassandra:hostNetwork`	`hostNetwork`은 필수이며 항상 `false`로 설정해야 합니다.
`restore:enabled`	복원은 기본적으로 사용 중지되어 있습니다. 이 속성을 `true`로 설정해야 합니다.
`restore:serviceAccountPath`	`SA_JSON_FILE_PATH` 백업용으로 만든 서비스 계정의 파일 시스템 경로입니다.
`restore:dbStorageBucket`	`CLOUD_STORAGE_BUCKET_PATH` 백업 데이터가 `gs://BUCKET_NAME` 형식으로 저장되는 Cloud Storage 버킷 경로입니다. `gs://`는 필수 항목입니다.
`restore:cloudProvider`	`GCP` `cloudProvider: "GCP"` 속성은 필수입니다.
`restore:snapshotTimestamp`	`TIMESTAMP` 복원할 백업 스냅샷의 타임스탬프입니다. 사용할 수 있는 타임스탬프를 확인하려면 `dbStorageBucket`으로 이동하여 버킷에 있는 파일을 확인합니다. 각 파일 이름에는 타임스탬프 값이 포함됩니다. 예를 들면 `backup_20210203213003_apigee-cassandra-default-0.tgz`입니다. 여기서 `20210203213003`은 해당 시점에 생성된 백업을 복원하려는 경우에 사용하는 `snapshotTimestamp` 값입니다.
`backup:enabled`	백업은 기본적으로 사용 중지되어 있습니다. 이 속성을 `true`로 설정해야 합니다.
`backup:serviceAccountPath`	`SA_JSON_FILE_PATH` `./tools/create-service-account`를 실행할 때 다운로드된 서비스 계정 JSON 파일의 파일 시스템 경로입니다.
`backup:dbStorageBucket`	`CLOUD_STORAGE_BUCKET_PATH` `gs://BUCKET_NAME` 형식의 Cloud Storage 버킷 경로입니다. `gs://`는 필수 항목입니다.
`backup:cloudProvider`	`GCP` `cloudProvider: "GCP"` 속성은 필수입니다.
`backup:schedule`	`SCHEDULE` 백업이 시작되는 시간이며 표준 crontab 문법에 지정되어 있습니다. 기본값: `0 2 * * ` 참고:* 백업 구성을 클러스터에 적용한 후 금방 시작하도록 백업을 예약하지 마세요. 백업 구성을 적용하면 Kubernetes가 Cassandra 노드를 다시 만듭니다. 노드가 다시 시작되기 전에 백업이 시작되면(몇 분 정도) 백업이 실패합니다.

비 Cloud Storage

매개변수

  namespace: YOUR_RESTORE_NAMESPACE # Use the namespace as in your original cluster.
  cassandra:
    hostNetwork: false
    ...
    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: "TIMESTAMP"
    ...
    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"

예

  namespace: apigee
  cassandra:
    hostNetwork: false
    ...
    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"
    ...
    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 * * *"
    ...

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

속성	설명
`namespace`	`YOUR_RESTORE_NAMESPACE` 복원할 네임스페이스입니다. 네임스페이스를 원래 클러스터에서와 같이 사용합니다.
`cassandra:hostNetwork`	`hostNetwork`은 필수이며 항상 `false`로 설정해야 합니다.
`restore:enabled`	복원은 기본적으로 사용 중지되어 있습니다. 이 속성을 `true`로 설정해야 합니다.
`restore:keyFile`	`PATH_TO_PRIVATE_KEY_FILE` 로컬 파일 시스템의 SSH 비공개 키 파일(SSH 키 쌍 생성 단계에서 만든 `ssh_key`라는 이름의 파일) 경로입니다.
`restore:server`	`BACKUP_SERVER_IP` 백업 서버의 IP 주소입니다.
`restore:storageDirectory`	`BACKUP_DIRECTORY` 백업 서버의 백업 디렉터리 이름입니다. 이는 `home/apigee` 내의 디렉터리여야 하며, 백업 디렉터리의 이름은 백업 디렉터리 생성 단계에서 만든 `cassandra_backup`입니다.
`restore:cloudProvider`	`HYBRID` `cloudProvider: "HYBRID"` 속성은 필수입니다.
`restore:snapshotTimestamp`	`TIMESTAMP` 복원할 백업 스냅샷의 타임스탬프입니다. 사용할 수 있는 타임스탬프를 확인하려면 `dbStorageBucket`으로 이동하여 버킷에 있는 파일을 확인합니다. 각 파일 이름에는 타임스탬프 값이 포함됩니다. 예를 들면 `backup_20210203213003_apigee-cassandra-default-0.tgz`입니다. 여기서 `20210203213003`은 해당 시점에 생성된 백업을 복원하려는 경우에 사용하는 `snapshotTimestamp` 값입니다.
`backup:enabled`	백업은 기본적으로 사용 중지되어 있습니다. 이 속성을 `true`로 설정해야 합니다.
`backup:keyFile`	`PATH_TO_PRIVATE_KEY_FILE` 로컬 파일 시스템의 SSH 비공개 키 파일(SSH 키 쌍 생성 단계에서 만든 `ssh_key`라는 이름의 파일) 경로입니다.
`backup:server`	`BACKUP_SERVER_IP` 백업 서버의 IP 주소입니다.
`backup:storageDirectory`	`BACKUP_DIRECTORY` 백업 서버의 백업 디렉터리 이름입니다. 이는 `home/apigee` 내의 디렉터리여야 하며, 백업 디렉터리의 이름은 백업 디렉터리 생성 단계에서 만든 `cassandra_backup`입니다.
`backup:cloudProvider`	`HYBRID` `cloudProvider: "HYBRID"` 속성은 필수입니다.
`backup:schedule`	`SCHEDULE` 백업이 시작되는 시간이며 표준 crontab 문법에 지정되어 있습니다. 기본값: `0 2 * * ` 참고:* 백업 구성을 클러스터에 적용한 후 금방 시작하도록 백업을 예약하지 마세요. 백업 구성을 적용하면 Kubernetes가 Cassandra 노드를 다시 만듭니다. 노드가 다시 시작되기 전에 백업이 시작되면(몇 분 정도) 백업이 실패합니다.

참고: Apigee는 overrides.yaml 파일의 backup 구성에 따라 Cloud Storage 백업 또는 원격 서버 백업에서 Cassandra를 복원합니다.

새 하이브리드 런타임 배포를 생성합니다. 그러면 새 Cassandra 클러스터가 생성되고 백업 데이터가 클러스터로 복원되기 시작합니다.

${APIGEECTL_HOME}/apigeectl init  -f overrides/overrides.yaml

${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml

${APIGEECTL_HOME}/apigeectl apply -f overrides/overrides.yaml --restore

${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml

복원 작업 진행 상황을 확인하고 apigeeds 및 다른 모든 포드가 작동 중인지 확인합니다.
- apigeeds를 확인하려면 다음 안내를 따르세요.
```
kubectl get apigeeds -n apigee
```
- 다른 모든 포드를 확인하려면 다음 안내를 따르세요.
```
kubectl get pods -n apigee
```

복원과 런타임 구성요소 정상 여부 확인이 성공적으로 완료된 후 클러스터에서 백업을 구성하는 것이 좋습니다.

overrides-restore.yaml 파일에서 restore 구성을 삭제합니다.
backup 구성을 overrides-restore.yaml 파일에 추가합니다.
다음 명령어를 사용하여 backup 구성을 적용합니다.
```
./apigeectl apply -f ../overrides-restore.yaml
```