Skip to content

Commit

Permalink
RC New Packaging: Create Active-Active database (#3217)
Browse files Browse the repository at this point in the history
* Remove Create Flexible and Create Active-Active subscriptions

* fix build errors

* Remove create Fixed and rename files

* Fix build errors/alias issues

* change titles/linktitles

* Edit index page

* Move Essentials first

* Active-Active databases and move A/A to configure

* Index pages and links

* Databases section minor updates (#3221)
  • Loading branch information
cmilesb authored Mar 26, 2024
1 parent 4447863 commit 9631668
Show file tree
Hide file tree
Showing 18 changed files with 48 additions and 35 deletions.
22 changes: 11 additions & 11 deletions content/embeds/rc-tags-tag-module.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
Here, you can:
You can select the tag's **Key** and **Value** from the suggestions, or you can enter your own.

- Select **Add tag** to add a tag.
{{<image filename="images/rc/tags-new-tag.png" alt="The New tag fields." >}}{{< /image >}}

{{<image filename="images/rc/tags-button-add-tag.png" alt="The Add tag button." width=100px >}}{{< /image >}}
A valid tag must follow these guidelines:
- Tag keys must be between 2 and 64 characters long, and values must be at least 2 characters long.
- Tags can only have lowercase letters, numbers, spaces, and these special characters: `-`, `_`, `.`, `+`, `@`, and `:`.

{{<image filename="images/rc/tags-new-tag.png" alt="The New tag fields." >}}{{< /image >}}

You can select the tag's **Key** and **Value** from the suggestions, or you can enter your own.

A valid tag must follow these guidelines:
- Tag keys must be between 2 and 64 characters long, and values must be at least 2 characters long.
- Tags can only have lowercase letters, numbers, spaces, and these special characters: `-`, `_`, `.`, `+`, `@`, and `:`.
After you add your first tag, you can:

- Select the **Key** or **Value** field of an existing tag and enter new text to edit it.

- Select **Delete** next to a tag to delete it.

{{<image filename="images/rc/tags-icon-delete.png" alt="Delete button." >}}{{< /image >}}
{{<image filename="images/rc/tags-icon-delete.png" alt="Delete button." >}}{{< /image >}}

- Select **Add additional tag** to add another tag.

{{<image filename="images/rc/tags-button-add-additional-tag.png" alt="The Add additional tag button." >}}{{< /image >}}
2 changes: 1 addition & 1 deletion content/rc/changelog/december-2023.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ aliases: []

### Active-Active JSON support

[Active-Active databases]({{<relref "rc/databases/active-active-redis">}}) on Redis Cloud now support the [JSON]({{< relref "/stack/json" >}}) data type.
[Active-Active databases]({{<relref "rc/databases/configuration/active-active-redis">}}) on Redis Cloud now support the [JSON]({{< relref "/stack/json" >}}) data type.

See [Create an Active-Active subscription]({{<relref "/rc/databases/create-database/create-active-active-database">}}) to learn how to create an Active-Active subscription.

Expand Down
2 changes: 1 addition & 1 deletion content/rc/changelog/may-2023.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,6 @@ The new fixed endpoints can be viewed in the [Redis Cloud Swagger UI](https://ap

### Active-Active access roles

For [Active-Active databases]({{<relref "rc/databases/active-active-redis">}}), you can now define roles with different levels of access for different regions.
For [Active-Active databases]({{<relref "rc/databases/configuration/active-active-redis">}}), you can now define roles with different levels of access for different regions.

For more information, see [Active-Active roles]({{<relref "rc/security/access-control/data-access-control/active-active-roles">}}).
10 changes: 3 additions & 7 deletions content/rc/databases/back-up-data.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,17 +35,13 @@ Here, you'll learn how to store backups using different cloud providers.

To turn on database backups:

1. Sign in to the [Redis Cloud console](https://app.redislabs.com/). (Create an account if you don't already have one.)
1. Sign in to the [Redis Cloud console](https://app.redislabs.com/).

2. If you have more than one subscription, select the target subscription from the list. This displays the **Databases** tab for the selected subscription.

{{<image filename="images/rc/subscription-flexible-databases-tab-pending.png" alt="The Databases tab summarizes databases created for a given subscription." >}}{{< /image >}}

3. Select the database to open the **Database** page and then select **Edit database**.
1. Select the database to open the **Database** page and then select **Edit database**.

{{<image filename="images/rc/database-details-configuration-tab-general-flexible.png" alt="The Configuration tab of the Database details screen." >}}{{< /image >}}

4. In the **Durability** section of the **Configuration** tab, locate the **Remote backup** setting:
1. In the **Durability** section of the **Configuration** tab, locate the **Remote backup** setting:

{{<image filename="images/rc/database-details-configuration-tab-durability-flexible.png" alt="The Remote backup setting is located in the Durability section of the Configuration tab of the database details screen." >}}{{< /image >}}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,14 @@ alwaysopen: false
categories: ["RC"]
aliases: [
"/rc/subscriptions/active-active-redis/",
"/rc/subscriptions/active-active-redis.md"
"/rc/subscriptions/active-active-redis.md",
"/rc/databases/active-active-redis"
]

---

Active-Active databases store data across multiple regions and availability zones. This improves scalability, performance, and availability, especially when compared to standalone databases.

To create Active-Active databases, you need a Redis Cloud Pro subscription that enables Active-Active Redis and defines the regions for each copy of your databases. See [Create an Active-Active database]({{<relref "/rc/databases/create-database/create-active-active-database">}}) for instructions.

Active-Active databases are distributed across multiple regions (geo-distribution). This improves performance by reducing latency for nearby users and improves availability by protecting against data loss in case of network or resource failure.
Expand Down
2 changes: 1 addition & 1 deletion content/rc/databases/configuration/high-availability.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Redis Cloud supports three levels of replication:

Your replication options depend on your [subscription plan]({{<relref "/rc/subscriptions/_index.md">}}):

- Free Redis Cloud Essentials plans support No replication and single-zone replication.
- Free Redis Cloud Essentials plans do not support replication.
- Paid Redis Cloud Essentials plans and Redis Cloud Pro plans let you choose between multi-zone or single-zone replication when creating a subscription. You can also turn off replication.

After database creation, you can still enable or turn off replication. However, [zone settings]({{<relref "/rc/databases/configuration/high-availability#zone-setting-maintenance">}}) are only configurable during database creation.
Expand Down
7 changes: 4 additions & 3 deletions content/rc/databases/create-database/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,14 @@ aliases: /rv/administration/setup_and_editing/create-databases/

A database is the heart of any Redis Cloud deployment.

The process for Creating a database depends on the type of [subscription]({{<relref "/rc/subscriptions">}}) you need.
The process for Creating a database depends on the type of [subscription plan]({{<relref "/rc/subscriptions">}}) you need.

An **Essentials** subscription is a fixed monthly price for a single database. It is cost-efficient and designed for low-throughput scenarios. It supports a range of availability, persistence, and backup options. Pricing supports low throughput workloads.
An **Essentials** plan is a fixed monthly price for a single database. It is cost-efficient and designed for low-throughput scenarios. It supports a range of availability, persistence, and backup options. Pricing supports low throughput workloads.
- [Create an Essentials database]({{<relref "/rc/databases/create-database/create-essentials-database">}})

A **Pro** subscription is an hourly price based on capacity. It supports more databases, larger databases, greater throughput, and unlimited connections.
A **Pro** plan is an hourly price based on capacity. It supports more databases, larger databases, greater throughput, and unlimited connections.
- [Create a Pro database with a new subscription]({{<relref "/rc/databases/create-database/create-pro-database-new">}})
- [Create a Pro database in an existing subscription]({{<relref "/rc/databases/create-database/create-pro-database-existing">}})
- [Create an Active-Active database]({{<relref "/rc/databases/create-database/create-active-active-database">}})


Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,20 @@ Title: Create an Active-Active database
linkTitle: Create Active-Active database
description: Shows how to create an Active-Active database
weight: 20
Title: Create an Active-Active database
linkTitle: Create Active-Active database
description: Shows how to create an Active-Active database
weight: 20
alwaysopen: false
categories: ["RC"]
aliases: /rc/subscriptions/create-active-active-subscription/
---

To deploy Active-Active databases in Redis Cloud, create a Redis Cloud Pro database with Active-Active enabled.
Active-Active databases store data across multiple regions and availability zones. This improves scalability, performance, and availability, especially when compared to standalone databases. See [Active-Active Redis]({{<relref "rc/databases/configuration/active-active-redis">}}) for more information.

To deploy Active-Active databases in Redis Cloud, you need a Redis Cloud Pro plan that enables Active-Active Redis and defines the regions for each copy of your databases.

Overall, the process is similar to [create a Pro database with a new subscription]({{<relref "/rc/databases/create-database/create-pro-database-new">}}). However, there are some additional requirements listed below:
Overall, the process is similar to [creating a Pro database with a new subscription]({{<relref "/rc/databases/create-database/create-pro-database-new">}}). However, there are some additional requirements listed below:

- Enable Active-Active Redis
- [Define the regions](#define-regions) for each database instance
Expand All @@ -26,7 +32,7 @@ Consistency between each instance is maintained in the background; that is, each

## Define regions

When you create a new Flexible subscription, the Active-Active Redis option appears to the right of the cloud providers.
When you create a new Pro database, the Active-Active Redis option appears to the right of the cloud providers.

{{<image filename="images/rc/create-flexible-sub-active-active-on.png" width="75%" alt="When you enable Active-Actve, you need to specify the regions for each database instance." >}}{{< /image >}}

Expand Down Expand Up @@ -66,7 +72,7 @@ Active-Active databases support the [JSON]({{< relref "/stack/json" >}}) data ty

{{<image filename="images/rc/active-active-json-detail.png" width="75%" alt="When you create an Active-Active database, you can select the JSON advanced capability." >}}{{< /image >}}

When you create an Active-Active database, JSON is already selected. Select it again to remove it.
We select JSON for you when you create an Active-Active database. Select it again to remove it.

## Define throughput

Expand Down Expand Up @@ -95,6 +101,7 @@ Throughput requirements grow dramatically as regions increase. As a result, con
## More info

- [Create a Pro database with a new subscription]({{<relref "/rc/databases/create-database/create-pro-database-new">}})
- [Active-Active Redis]({{<relref "rc/databases/configuration/active-active-redis">}})
- Database [memory limit]({{<relref "/rc/databases/create-database#memory-limit">}})
- Redis Cloud [subscription plans]({{<relref "/rc/subscriptions/">}})
- [Redis Cloud pricing](https://redis.com/redis-enterprise-cloud/pricing/)
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,10 @@ The **Tags** section lets you add [tags]({{< relref "/rc/databases/tag-database"

{{<image filename="images/rc/database-new-tags.png" alt="Use the Tag settings to add tags to the database." >}}{{< /image >}}

Select **Add tag** to add a tag.

{{<image filename="images/rc/tags-button-add-tag.png" alt="The Add tag button." width=100px >}}{{< /image >}}

{{< embed-md "rc-tags-tag-module.md" >}}

## Security section
Expand Down
5 changes: 4 additions & 1 deletion content/rc/databases/import-data.md
Original file line number Diff line number Diff line change
Expand Up @@ -208,7 +208,10 @@ To import an RDB file stored in a Microsoft Azure Blog storage container:
1. In the **Danger Zone**, select **Import**.
1. Enter the details for the RDB file:
- Source type - Select **Azure Blob Storage**.
- Source path - Enter the URL for the RDB file: `abs://:storage_account_access_key@storage_account_name/[container/]filename.rdb[.gz]`
- Source path - Enter the URL for the RDB file:
```text
abs://:storage_account_access_key@storage_account_name/[container/]filename.rdb[.gz]
```

Where:
- `storage_account_access_key` - Primary access key to the storage account
Expand Down
4 changes: 2 additions & 2 deletions content/rc/databases/migrate-databases.md
Original file line number Diff line number Diff line change
Expand Up @@ -111,9 +111,9 @@ Follow these detailed steps to migrate data using Active-Passive syncing:

7. Select **Save Active-Passive** to save your Active-Passive settings.

{{<image filename="images/rc/icon-database-save-active-passive.png" alt="The **Save** button verifies the Source URI and you can't save until it validates." >}}{{< /image >}}
{{<image filename="images/rc/icon-database-save-active-passive.png" alt="The **Save** button verifies the Source URI and you can't save until it validates." width="200px">}}{{< /image >}}

For an external database, Redis will verify the endpoint at this step. If the endpoint cannot be verified, make sure that you've copied the details directly from the source database and that the value you entered starts with `redis://`.
For an external database, we'll verify the endpoint at this step. If the endpoint can't be verified, make sure that you've copied the details directly from the source database and that the value you entered starts with `redis://`.

8. Select **Save Database** to begin updating the database.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ categories: ["RC"]
aliases:
---

For [Active-Active databases]({{<relref "rc/databases/active-active-redis">}}), you can define roles with different levels of access for different regions. For example, you can define a user role with full database access in one region and read-only access in another. Or, you can prevent a user from running any commands in a specified region.
For [Active-Active databases]({{<relref "rc/databases/configuration/active-active-redis">}}), you can define roles with different levels of access for different regions. For example, you can define a user role with full database access in one region and read-only access in another. Or, you can prevent a user from running any commands in a specified region.

1. Go to **Data Access Control > Roles** and either select `+` to create a new role or point to an existing role and select the pencil icon to edit it.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ To configure a Redis ACL that you can assign to a data access role:

{{<image filename="images/rc/data-access-control-redis-acls-saved.png" alt="Saved Redis ACL." >}}{{< /image >}}

After you create a Redis ACL, you can assign it to a role. Redis ACLs are not fully verified until they are assigned to a role. For more information, see [Create roles]({{<relref "rc/security/access-control/data-access-control/create-roles">}}) or [Active-Active access roles]({{<relref "rc/security/access-control/data-access-control/active-active-roles">}}) for an [Active-Active subscription]({{<relref "rc/databases/active-active-redis">}}).
After you create a Redis ACL, you can assign it to a role. Redis ACLs are not fully verified until they are assigned to a role. For more information, see [Create roles]({{<relref "rc/security/access-control/data-access-control/create-roles">}}) or [Active-Active access roles]({{<relref "rc/security/access-control/data-access-control/active-active-roles">}}) for an [Active-Active subscription]({{<relref "rc/databases/configuration/active-active-redis">}}).

## Define permissions with ACL syntax

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,5 +42,5 @@ When you assign a user-defined ACL rule to a role and associate it with one or m

After you create a role, you can assign it to a user. Users with this role can access the databases according to the role's associated Redis ACLs. For more information, see [Assign roles to users]({{<relref "rc/security/access-control/data-access-control/create-assign-users#assign-roles-to-existing-users">}}).

To assign Redis ACLs to a role for an [Active-Active subscription]({{<relref "rc/databases/active-active-redis">}}), see [Active-Active access roles]({{<relref "rc/security/access-control/data-access-control/active-active-roles">}}).
To assign Redis ACLs to a role for an [Active-Active subscription]({{<relref "rc/databases/configuration/active-active-redis">}}), see [Active-Active access roles]({{<relref "rc/security/access-control/data-access-control/active-active-roles">}}).

Binary file modified static/images/rc/database-metrics-tab.png
100755 → 100644
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/images/rc/database-new-tags.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/images/rc/metrics-promote-graphs.png
100755 → 100644
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 9631668

Please sign in to comment.