使用 crdb-cli 创建主动-主动数据库

本节介绍如何使用 Redis Enterprise Software 运算符在 Kubernetes 上设置主动-主动 Redis Enterprise 数据库。

在 Kubernetes 上，Redis Enterprise 主动-主动数据库提供对来自不同 Kubernetes 集群的相同数据集的读写访问。有关主动-主动的更多常规信息，请参阅 Redis Enterprise Software 文档。

创建主动-主动数据库需要在位于不同 Kubernetes 集群中的两个 Redis Enterprise 集群之间路由网络访问。如果没有为每个集群配置适当的访问权限，数据库实例之间的同步将失败。

此过程包括：

1. 记录要在后续步骤中使用的值。这些值必须正确且一致。
2. 编辑 Redis Enterprise 集群 （REC） 规范文件以包含ActiveActive部分。根据您使用的 K8s 发行版，这将略有不同。
3. 使用crdb-cli命令。这些值必须与 REC 资源规范中的值匹配。

先决条件

在创建主动-主动数据库之前，您需要对两个或多个正常工作的 Kubernetes 集群具有管理员访问权限，每个集群都具有：

• 使用入口资源（或 OpenShift 上的路由资源）进行外部访问的路由。
• 具有唯一名称的工作 Redis Enterprise 集群 （REC）。
• 数据库可用的足够内存资源（请参阅硬件要求）。

记录所需参数

设置 Active-Active 数据库时最常见的错误是参数值不正确或不一致。资源文件中列出的值必须与 crdb-cli 命令中使用的值匹配。

• 数据库名称 <db-name>:
  • 描述：结合 ingress 后缀创建 Active-Active 数据库主机名
  • 格式：字符串
  • 示例值：myaadb
  • 如何获得：您选择
  • 数据库名称要求为：
    • 最多 63 个字符
    • 仅限字母、数字或连字符 （-） 字符
    • 以字母开头;以字母或数字结尾。
    • 数据库名称不区分大小写

对于每个参与的 Redis Enterprise 集群 （REC），您需要以下信息：

• REC 主机名 <rec-hostname>:
  • 描述：用于在crdb-cli命令。这必须与其他参与的集群不同。
  • 格式：<rec-name>.<namespace>.svc.cluster.local
  • 示例值：rec01.ns01.svc.cluster.local
  • 如何获取：列出所有 Redis Enterprise 集群

    kubectl get rec
    

• API hostname <api-hostname>:
  • Description: Hostname used to access the Redis Enterprise cluster API from outside the K8s cluster
  • Format: string
  • Example value: api.ijk.example.com
• Ingress suffix <ingress-suffix>:
  • Description: Combined with database name to create the Active-Active database hostname
  • Format: string
  • Example value: -cluster.ijk.example.com
• REC admin credentials <username> <password>:
  • Description: Admin username and password for the REC stored in a secret
  • Format: string
  • Example value: username: user@example.com, password: something
  • How to get them:

    kubectl get secret <rec-name> \
      -o jsonpath='{.data.username}' | base64 --decode
    kubectl get secret <rec-name> \
      -o jsonpath='{.data.password}' | base64 --decode
    

• Replication hostname <replication-hostname>:
  • Description: Hostname used inside the ingress for the database
  • Format: <db-name><ingress-suffix>
  • Example value: myaadb-cluster.ijk.example.com
  • How to get it: Combine <db-name> and <ingress-suffix> values you documented above.
• Replication endpoint <replication-endpoint>:
  • Description: Endpoint used externally to contact the database
  • Format: <db-name><ingress-suffix>:443
  • Example value: myaadb-cluster.ijk.example.com:443
  • How to get it:<replication-hostname>:443

activeActive:
  apiIngressUrl: <api-hostname>
  dbIngressSuffix: <ingress-suffix>
  ingressAnnotations:
     kubernetes.io/ingress.class: nginx
    nginx.ingress.kubernetes.io/backend-protocol: HTTPS
    nginx.ingress.kubernetes.io/ssl-passthrough: "true"
  method: ingress

activeActive:
  apiIngressUrl: <api-hostname>
  dbIngressSuffix: <ingress-suffix>
  ingressAnnotations:
    kubernetes.io/ingress.class: haproxy
     ingress.kubernetes.io/ssl-passthrough: "true"
  method: ingress

crdb-cli crdb create \
  --name <db-name> \
  --memory-size <mem-size> \
  --encryption yes \
  --instance fqdn=<rec-hostname-01>,url=https://<api-hostname-01>,username=<username-01>,password=<password-01>,replication_endpoint=<replication-endpoint-01>,replication_tls_sni=<replication-hostname-01> \
  --instance fqdn=<rec-hostname-02>,url=https://<api-hostname-02>,username=<username-02>,password=<password-02>,replication_endpoint=<replication-endpoint-02>,replication_tls_sni=<replication-hostname-02>