ContextQMD
Back to Redis

Active Active

content/operate/kubernetes/reference/yaml/active-active.md

latest5.6 KB
Original Source

This page provides YAML examples for deploying Active-Active Redis Enterprise databases across multiple Kubernetes clusters. Active-Active databases provide multi-master replication with conflict resolution, enabling global distribution and local read/write access.

For complete deployment instructions, see [Active-Active databases]({{< relref "/operate/kubernetes/active-active" >}}).

Applying the configuration

To deploy Active-Active databases using these YAML files, follow [Create Active-Active database (REAADB)]({{< relref "/operate/kubernetes/active-active/create-reaadb" >}}), which provides detailed instructions for preparing clusters, creating RERC resources, and deploying REAADB configurations.

Namespace examples

A namespace is an abstraction used by Kubernetes to support multiple virtual clusters on the same physical cluster.

ns-illinois.yaml is used in [Create Active-Active database]({{< relref "/operate/kubernetes/active-active/create-reaadb#example-values" >}}).

{{<embed-yaml "k8s/ns-illinois.md" "ns-illinois.yaml">}}

ns-virginia.yaml is used in [Create Active-Active database]({{< relref "/operate/kubernetes/active-active/create-reaadb#example-values" >}}).

{{<embed-yaml "k8s/ns-virginia.md" "ns-virginia.yaml">}}

REC examples

A Redis Enterprise cluster is a collection of Redis Enterprise nodes that pools system resources across nodes and supports multi-tenant database instances.

rec-chicago.yaml is used in [Create Active-Active database]({{< relref "/operate/kubernetes/active-active/create-reaadb#prerequisites" >}}) and [Create RERC]({{< relref "/operate/kubernetes/active-active/create-reaadb#create-rerc" >}}).

{{<embed-yaml "k8s/rec-chicago.md" "rec-chicago.yaml">}}

rec-arlington.yaml is used in [Create Active-Active database]({{< relref "/operate/kubernetes/active-active/create-reaadb#prerequisites" >}}) and [Create RERC]({{< relref "/operate/kubernetes/active-active/create-reaadb#create-rerc" >}}).

{{<embed-yaml "k8s/rec-arlington.md" "rec-arlington.yaml">}}

RERC examples

RedisEnterpriseRemoteCluster represents a remote participating cluster.

rerc-ohare.yaml is used in the [Create RERC]({{< relref "/operate/kubernetes/active-active/create-reaadb#create-rerc" >}}) section.

{{<embed-yaml "k8s/rerc-ohare.md" "rerc-ohare.yaml">}}

rerc-raegan.yaml is used in the [Create RERC]({{< relref "/operate/kubernetes/active-active/create-reaadb#create-rerc" >}}) section.

{{<embed-yaml "k8s/rerc-raegan.md" "rerc-raegan.yaml">}}

RERC configuration

  • [metadata.name]({{< relref "/operate/kubernetes/reference/api/redis_enterprise_remote_cluster_api#appredislabscomv1alpha1" >}}): Unique name for this remote cluster reference
  • [spec.recName]({{< relref "/operate/kubernetes/reference/api/redis_enterprise_remote_cluster_api#spec" >}}): Name of the remote REC
  • [spec.recNamespace]({{< relref "/operate/kubernetes/reference/api/redis_enterprise_remote_cluster_api#spec" >}}): Namespace of the remote REC
  • [spec.apiFqdnUrl]({{< relref "/operate/kubernetes/reference/api/redis_enterprise_remote_cluster_api#spec" >}}): API endpoint URL for the remote cluster
  • [spec.dbFqdnSuffix]({{< relref "/operate/kubernetes/reference/api/redis_enterprise_remote_cluster_api#spec" >}}): Database hostname suffix for the remote cluster
  • [spec.secretName]({{< relref "/operate/kubernetes/reference/api/redis_enterprise_remote_cluster_api#spec" >}}): Secret containing authentication credentials

Edit the values in the downloaded YAML file for your specific setup, updating the remote cluster details, API endpoints, and secret names to match your actual environment.

Active-Active database examples

Active-Active databases are geo-distributed databases that span multiple Redis Enterprise clusters and use multi-primary replication and conflict-free replicated data types (CRDTs).

reaadb-boeing.yaml is used in the [Create Active-Active database]({{< relref "/operate/kubernetes/active-active/create-reaadb#create-reaadb" >}}) section.

{{<embed-yaml "k8s/reaadb-boeing.md" "reaadb-boeing.yaml">}}

REAADB configuration

  • [metadata.name]({{< relref "/operate/kubernetes/reference/api/redis_enterprise_active_active_database_api#appredislabscomv1alpha1" >}}): Active-Active database name
  • [spec.participatingClusters]({{< relref "/operate/kubernetes/reference/api/redis_enterprise_active_active_database_api#specparticipatingclusters" >}}): List of RERC names that participate in this database
  • [spec.globalConfigurations]({{< relref "/operate/kubernetes/reference/api/redis_enterprise_active_active_database_api#specglobalconfigurations" >}}): Database settings applied to all participating clusters

Edit the downloaded YAML file to add global database settings such as memory allocation, shard count, replication settings, database secrets, Redis modules, and database-specific Redis configuration.

  • [Active-Active databases (index)]({{< relref "/operate/kubernetes/active-active" >}})
  • [Prepare participating clusters]({{< relref "/operate/kubernetes/active-active/prepare-clusters" >}})
  • [Create Active-Active database (REAADB)]({{< relref "/operate/kubernetes/active-active/create-reaadb" >}})
  • [Edit global configuration]({{< relref "/operate/kubernetes/active-active/global-config" >}})
  • [Sync global database secret]({{< relref "/operate/kubernetes/active-active/global-db-secret" >}})
  • [RERC API reference]({{< relref "/operate/kubernetes/reference/api/redis_enterprise_remote_cluster_api" >}})
  • [REAADB API reference]({{< relref "/operate/kubernetes/reference/api/redis_enterprise_active_active_database_api" >}})
  • [Networking configuration]({{< relref "/operate/kubernetes/networking" >}})