使用自定义存储空间进行备份和恢复

本部分介绍如何使用 ssh 和文件系统（而不是使用 Google Cloud）配置 Cassandra 数据库的备份和恢复。另请参阅：

什么是使用自定义存储空间进行 Cassandra 备份和恢复？

使用自定义存储空间进行备份时，系统会将 Cassandra 数据库的备份存储到您指定的服务器的文件系统的压缩文件中。备份会按照您在替换文件中指定的时间表执行。通过安全的 SSH 与服务器连接。

不使用 Cloud 服务设置备份

以下步骤包括完成特定任务（例如创建 SSH 密钥对）的常见示例。使用适合您的安装的方法。

该流程包括以下几个部分：

设置服务器和 SSH
设置备份的时间表和目标位置
设置恢复功能

设置服务器和 SSH

为您的备份指定 Linux 或 Unix 服务器。此服务器必须可从 Apigee Hybrid 运行时层面通过 SSH 访问。它必须有足够的存储空间来存储备份。
在服务器上设置 SSH 服务器，或确保该服务器已配置安全的 SSH 服务器。
注意：出于安全考虑，请确保您的 SSH 服务器是最新版本。

创建 SSH 密钥对并将私钥文件存储在可从 Hybrid 运行时层面访问的路径中。您必须对密钥对使用空白密码，否则备份将失败。例如：

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]-----+

在备份服务器上创建名为 apigee 的用户账号。确保新的 apigee 用户在 /home 下有一个主目录。
在备份服务器上，在新的 /home/apigee 目录中创建一个 ssh 目录。
将公钥（上例中的 ssh_key.pub）复制到新 /home/apigee/ssh 目录下名为 authorized_keys 的文件中。例如：
```
cd /home/apigee
mkdir .ssh
cd .ssh
vi authorized_keys
```
在备份服务器上，在 /home/apigee/ 目录中创建备份目录。备份目录可以是任何目录，只要 apigee 用户可以访问该目录即可。例如：
```
cd /home/apigee
mkdir cassandra-backup
```
测试连接。您需要确保 Cassandra pod 可以使用 SSH 连接到备份服务器：
1. 登录到 Cassandra pod 的 shell。例如：
```
kubectl exec -it -n apigee APIGEE_CASSANDRA_DEFAULT_0 -- /bin/bash
```
  其中 APIGEE_CASSANDRA_DEFAULT_0 是 Cassandra pod 的名称。将其更改为您要从其进行连接的 pod 的名称。
2. 使用服务器 IP 地址通过 SSH 连接到您的备份服务器：
```
ssh apigee@BACKUP_SERVER_IP
```
  注意：此时系统可能会显示一条警告，说明服务器的指纹未被识别，并且询问您是否要继续。在本测试中，这意味着您可以成功从 Cassandra pod 访问备份服务器。您无需继续操作。

设置备份的时间表和目标位置

您可以在 overrides.yaml 文件中设置备份的时间表和目标位置。

将以下参数添加到 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`。
`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 节点。如果备份在节点重启（可能需要几分钟）之前开始，则备份将失败。

使用 apigeectl 将备份配置应用于集群的存储范围：
```
$APIGEECTL_HOME/apigeectl --datastore -f YOUR_OVERRIDES_FILE
```
其中，YOUR_OVERRIDES_FILE 是您刚刚修改的替换文件的路径。

配置恢复功能

恢复功能会从备份位置获取数据，并将其恢复到具有相同节点数的新 Cassandra 集群中。不会从旧的 Cassandra 集群获取数据。

以下恢复说明适用于不使用 Google Cloud Storage 进行备份的单区域部署。对于其他部署，请参阅以下内容：

对于使用 Google Cloud Storage 进行备份的单区域部署，请参阅 Cassandra 备份和恢复。
对于多区域部署，请参阅 GKE 和 GKE On-Prem 上的多区域部署。

如需恢复 Cassandra 备份，请执行以下操作：

在现有 Kubernetes 集群中创建一个将用于恢复 Hybrid 运行时部署的新命名空间。不要将原始命名空间名称用作新命名空间的名称。不要使用旧命名空间进行恢复。
在 Hybrid 安装根目录中，创建新的 overrides-restore.yaml 文件。
将完整的 Cassandra 配置从原始 overrides.yaml 文件复制到新的 overrides-restore.yaml 文件中。例如：
```
cp ./overrides.yaml ./overrides-restore.yaml
```

将命名空间元素添加到新的 overrides-restore.yaml 文件。

参数

namespace: YOUR_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"

其中：

属性	说明
`namespace`	`YOUR_RESTORE_NAMESPACE` 您在第 1 步中为新的 Cassandra 集群创建的新命名空间的名称。请勿使用原始集群所用的命名空间。
`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`	`BACKUP_TO_RESTORE` 您要恢复的特定备份，采用标准 crontab 语法指定（不允许使用通配符）。

执行以下命令，更改旧命名空间中任何 Cassandra 节点上的 app 标签：

kubectl label pods --overwrite --namespace=OLD_NAMESPACE -l app=apigee-cassandra app=apigee-cassandra-old

创建新的 Hybrid 运行时部署。这将创建新的 Cassandra 集群并开始将备份数据恢复到该集群中：
```
./apigeectl init  -f ../overrides-restore.yaml
```
```
./apigeectl apply  -f ../overrides-restore.yaml
```

恢复完成后，必须切换流量才能使用新命名空间中的 Cassandra 集群。运行以下命令切换流量：

kubectl get rs -n OLD_NAMESPACE # look for the 'apigee-connect' replicaset

kubectl patch rs -n OLD_NAMESPACE APIGEE_CONNECT_RS_NAME -p '{"spec":{"replicas" : 0}}'

流量切换完成后，您可以通过移除 restore 配置并将 backup 配置添加到 overrides-restore.yaml 文件来重新配置已恢复集群上的备份。将 YOUR_RESTORE_NAMESPACE 替换为第 1 步中创建的新命名空间名称。

namespace: YOUR_RESTORE_NAMESPACE
cassandra:
  ...
  backup:
    enabled: true
    serviceAccountPath: SA_JSON_FILE_PATH
    dbStorageBucket: CLOUD_STORAGE_BUCKET_PATH
    schedule: BACKUP_SCHEDULE_CODE
  ...

然后使用以下命令应用 backup 配置：

./apigeectl apply  -f ../overrides-restore.yaml