`backup-restore init`

初始化 cpd-cli backup-restore 命令以进行备份和复原。

语法

cpd-cli backup-restore init \
[--aux-pod-cpu-limit=<auxiliary-pod-cpu-limit-value>] \
[--aux-pod-cpu-request=<auxiliary-pod-cpu-request-value>] \
[--aux-pod-mem-limit=<auxiliary-pod-memory-limit-value>] \
[--aux-pod-mem-request=<auxiliary-pod-memory-request-value>] \
[--image-prefix=<framework-image-prefix>] \
[--log-level=info|debug|warn|error|panic] \
[--namespace=<namespace-name>] \
[--provider=<storage-provider-type>] \
[--pvc-name=<persistence-volume-claim-name>] \
[--s3-bucket=<S3-bucket-name>] \
[--s3-endpoint=<S3-endpoint-URL>] \
[--s3-prefix=<S3-bucket-directory-path>] \
[--s3-region=<AWS-region-value>] \
[--service-account=<openshift-container-platform-service-account>] \
[--verbose]

参数

init 命令没有参数。

选项

选项	描述
`--aux-pod-cpu-limit`	IBM® Cloud Pak for Data 辅助 pod 的 CPU 限制。状态可选。语法 `--aux-pod-cpu-limit=<auxiliary-pod-cpu-limit-value>` 缺省值 `0 (unbounded)` 有效值 CPU 限制以 CPU 单元为单位进行度量。一个 CPU 相当于一个用于云提供商的 CPU/ 核心和一个用于裸机英特尔处理器的超线程。 CPU 属性中的 `m` 后缀指示 "毫 CPU" (`250m` 相当于 CPU/ 核心的 25%)。
`--aux-pod-cpu-request`	IBM Cloud Pak for Data 辅助 pod 的 CPU 请求。状态可选。语法 `--aux-pod-cpu-request=<auxiliary-pod-cpu-request-value>` 缺省值 `0` 有效值 CPU 请求以 CPU 单元为单位进行度量。一个 CPU 相当于一个用于云提供商的 CPU/ 核心和一个用于裸机英特尔处理器的超线程。 CPU 属性中的 `m` 后缀指示 "毫 CPU" (`250m` 相当于 CPU/ 核心的 25%)。
`--aux-pod-mem-limit`	IBM Cloud Pak for Data 辅助 pod 的内存限制。状态可选。语法 `--aux-pod-mem-limit=<auxiliary-pod-memory-limit-value>` 缺省值 `0` 有效值内存可以用各种单位表示，其中一个 `Mi` 是一个 IEC 单位兆字节 (1024 ^ 2) ，一个 `Gi` 是一个 IEC 单位千兆字节 (1024 ^ 3)。
`--aux-pod-mem-request`	IBM Cloud Pak for Data 辅助 pod 的内存请求。状态可选。语法 `--aux-pod-mem-request=<auxiliary-pod-memory-request-value>` 缺省值 `0` 有效值内存可以用各种单位表示，其中一个 `Mi` 是一个 IEC 单位兆字节 (1024 ^ 2) ，一个 `Gi` 是一个 IEC 单位千兆字节 (1024 ^ 3)。
`--help` `-h`	显示命令帮助。状态可选。语法 `--help` 缺省值无缺省值。有效值不适用。
`--image-prefix`	指定框架图像前缀。状态可选。语法 `--image-prefix=${PRIVATE_REGISTRY_LOCATION}/${PROJECT_CPD_INSTANCE}-cpdbrapi` 缺省值 `${PRIVATE_REGISTRY_LOCATION}/${PROJECT_CPD_INSTANCE}-cpdbrapi` 有效值任何有效的框架映像前缀。
`--log-level`	命令日志级别。状态可选。语法 `--log-level=info\|debug\|warn\|error\|panic` 缺省值 `info` 有效值 `debug` 调试消息将写入日志。 `error` 错误消息将写入日志。 `info` 将参考消息写入日志。 `panic` 会将紧急消息写入日志。 `warn` 警告消息将写入日志。
`--namespace` `-n`	实用程序应在其中运行的名称空间名称。状态可选。语法 `--namespace=<namespace-name>` 缺省值 `${PROJECT_CPD_INSTANCE}` 有效值有效的项目 (名称空间) 名称。
`--provider`	存储器提供者类型。状态可选。语法 `--provider=<storage-provider-type>` 缺省值 `local` 有效值 `local` 使用本地存储库。 `s3` 使用 S3 存储库。
`--pvc-name`	指定要用于命令的持久性卷声明名称。状态可选。语法 `--pvc-name=<persistence-volume-claim-name>` 缺省值 No default.. 有效值任何有效的持久性卷声明名称。
`--s3-bucket`	用于存储备份的存储区名称。状态仅适用于 S3 存储库。语法 `--s3-bucket=<S3-bucket-name>` 缺省值 `720h0m0s` 有效值任何有效的存储区名称。
`--s3-endpoint`	用于访问 Amazon S3 API 的端点 URL。状态仅适用于 S3 存储库。语法 `--s3-endpoint=<S3-endpoint-URL>` 缺省值 No default. 有效值任何有效的 S3 端点 URL。
`--s3-prefix`	表示存储区目录路径的前缀。状态仅适用于 S3 存储库。语法 `--s3-prefix=<S3-bucket-directory-path>` 缺省值 No default. 有效值任何有效的存储区目录路径。
`--s3-region`	Amazon Web Services (AWS) 区域。状态可选。语法 `--s3-region=<AWS-region-value>` 缺省值 `us-west-1` 有效值有关区域代码的完整列表，请参阅 https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints。
`--service-account`	指定 Openshift Container Platform 服务帐户。状态可选。语法 `--service-account=<openshift-container-platform-service-account>` 缺省值 `cpd-admin-sa` 有效值任何有效的 OpenShift® Container Platform 服务帐户名称。
`--verbose`	日志包含更详细的消息。状态可选。语法 `--verbose` 缺省值无缺省值。有效值不适用。

示例

注: 以下示例使用建议的安装环境变量。

使用脚本为环境创建具有正确值的环境变量。有关更多信息，请参阅最佳实践: 设置安装变量。

Docker 映像注册表可能与提供的示例不同。

本地存储库

cpd-cli backup-restore init \
--namespace=${PROJECT_CPD_INSTANCE} \
--log-level=debug \
--verbose \
--pvc-name=cpdbr-pvc \ 
--image-prefix=${PRIVATE_REGISTRY_LOCATION}/${PROJECT_CPD_INSTANCE}-cpdbrapi \
--provider=local

S3 存储库: Red Hat® OpenShift 4.x

首先使用 pvc 名称和 s3 存储器初始化 cpdbr。请注意，必须存在存储区。

cpd-cli backup-restore init \
--namespace=${PROJECT_CPD_INSTANCE} \
--pvc-name=cpdbr-pvc \
--image-prefix=${PRIVATE_REGISTRY_LOCATION}/${PROJECT_CPD_INSTANCE}-cpdbrapi \
--provider=s3 \
--s3-endpoint="s3 endpoint" \
--s3-bucket=cpdbr \
--s3-prefix=${PROJECT_CPD_INSTANCE}

共享卷 PVC

backup-restore 要求创建共享卷 PVC 并将其与 init 命令一起使用。如果 PV 为 Portworx，请确保已启用共享。

oc apply -f cpdbr-pvc.yaml

cpdbr-pvc.yaml content:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: cpdbr-pvc
spec:
  storageClassName: nfs-client
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 200Gi

存储库私钥

对于卷 backup-restore，必须先创建名为 cpdbr-repo-secret 的存储库私钥，然后再发出 backup-restore init 命令。

对于本地提供程序，存储库私钥需要以下凭证信息。

RESTIC_PASSWORD: 用于创建存储库的 restic 密码。

# setup the repository secret for local
echo -n 'restic' > RESTIC_PASSWORD
oc create secret generic -n ${PROJECT_CPD_INSTANCE} cpdbr-repo-secret \
    --from-file=./RESTIC_PASSWORD

对于 S3 提供程序，存储库私钥需要以下凭证信息。

RESTIC_PASSWORD: 用于创建存储库的 restic 密码。
AWS_ACCESS_KEY_ID: AWS 访问密钥标识
AWS_SECRET_ACCESS_KEY: AWS 私钥访问密钥。

# setup the repository secret for S3
echo -n 'restic' > RESTIC_PASSWORD
echo -n 'minio' > AWS_ACCESS_KEY_ID
echo -n 'minio123' > AWS_SECRET_ACCESS_KEY

oc create secret generic -n ${PROJECT_CPD_INSTANCE} cpdbr-repo-secret \
    --from-file=./RESTIC_PASSWORD \
    --from-file=./AWS_ACCESS_KEY_ID \
    --from-file=./AWS_SECRET_ACCESS_KEY