Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions src/content/docs/r2/data-migration/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -54,3 +54,5 @@ Quickly and easily migrate data from other cloud providers to R2. Explore each o
</tr>
</tbody>
</table>

For information on how to leverage these tools effectively, refer to [Migration Strategies](/r2/data-migration/migration-strategies/)
28 changes: 28 additions & 0 deletions src/content/docs/r2/data-migration/migration-strategies.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
---
title: Migration Strategies
pcx_content_type: how-to
learning_center:
title: Migration strategies
sidebar:
order: 5
---

import { Render } from "~/components";

You can use a combination of Super Slurper and Sippy to effectively migrate all objects with minimal downtime.

### When the source bucket is actively being read from / written to

1. Enable Sippy and start using the R2 bucket in your application.
- This copies objects from your previous bucket into the R2 bucket on demand when they are requested by the application.
- New uploads will go to the R2 bucket.
2. Use Super Slurper to trigger a one-off migration to copy the remaining objects into the R2 bucket.
- In the **Destination R2 bucket** > **Overwrite files?**, select "Skip existing".

### When the source bucket is not being read often

1. Use Super Slurper to copy all objects to the R2 bucket.
- Note that Super Slurper may skip some objects if they are uploaded after it lists the objects to be copied.
2. Enable Sippy on your R2 bucket, then start using the R2 bucket in your application.
- New uploads will go to the R2 bucket.
- Objects which were uploaded while Super Slurper was copying the objects will be copied on-demand (by Sippy) when they are requested by the application.
5 changes: 4 additions & 1 deletion src/content/docs/r2/data-migration/super-slurper.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,10 @@ This setting specifies the prefix within the source bucket where objects will be

#### Overwrite files?

This setting determines what happens when an object being copied from the source storage bucket matches the path of an existing object in the destination R2 bucket. There are two options: overwrite (default) and skip.
This setting determines what happens when an object being copied from the source storage bucket matches the path of an existing object in the destination R2 bucket. There are two options:

- Overwrite (default)
- Skip

## Supported cloud storage providers

Expand Down